GitHub Actions所有可用上下文变量的完整官方文档在哪里查询?
问题解答
有两种公开可靠的方式可以获取GitHub Actions所有可用的上下文变量完整列表,包含深层嵌套的字段:
- 工作流实时打印法
你可以在需要调试的工作流中新增一个步骤,通过GitHub Actions内置的toJSON方法序列化输出完整的github上下文对象,示例代码如下:
运行工作流后,在该步骤的日志中就能看到当前触发事件下所有层级的可用字段,你提到的steps: - name: 打印完整github上下文 run: echo '${{ toJSON(github) }}'github.event.pull_request类嵌套字段都会完整展示。这种方式拿到的字段是当前触发场景下最准确的可用列表,不同触发事件对应的字段会有差异。 - Webhook payload对照法
github.event对象的结构和对应事件的GitHub Webhook payload完全一致,你提到的四个pull_request相关嵌套字段就是pull_request事件Webhook的标准属性,只要对照对应事件的Webhook payload结构,就能查到所有可调用的深层嵌套字段清单。
补充说明:你提到的github.event.pull_request.head.ref等四个变量是完全合法可用的,仅在工作流触发事件为pull_request相关类型时存在,非pull_request触发的工作流不会加载这些字段,使用时可以增加条件判断避免空值报错。
内容的提问来源于stack exchange,提问作者Daniel Goldfarb
相关产品推荐
相关产品推荐

