跳至主要内容

为作业使用环境

为作业指定环境。

概述

使用 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 }}