Skip to main content

将环境用于作业

为作业指定环境。

概述

使用 jobs.<job_id>.environment 定义作业引用的环境。 在将引用环境的作业发送到运行器之前,必须通过所有部署保护规则。 有关详细信息,请参阅“使用环境进行部署”。

可以将环境仅作为环境 name 提供,也可以作为具有 nameurl 的环境对象提供。 URL 将映射到部署 API 中的 environment_url。 有关部署 API 的详细信息,请参阅“存储库的 REST API 终结点”。

使用单一环境名称的示例

environment: staging_environment

使用环境名称和 URL 的示例

environment:
  name: production_environment
  url: https://github.com

url 的值可以是一个表达式。 允许的表达式上下文:githubinputsvarsneedsstrategymatrixjobrunnerenv。 有关表达式的详细信息,请参阅“表达式”。

将输出用作 URL 的示例

environment:
  name: production_environment
  url: ${{ steps.step_id.outputs.url_output }}

name 的值可以是一个表达式。 允许的表达式上下文:githubinputsvarsneedsstrategymatrix。 有关表达式的详细信息,请参阅“表达式”。

示例:使用表达式作为环境名称

environment:
  name: ${{ github.ref_name }}