cn 我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

环境

您可以使用保护规则和机密配置环境。 工作流程作业可以引用环境来使用环境的保护规则和机密。

GitHub Actions 可用于 GitHub Free、GitHub Pro、组织的 GitHub Free、GitHub Team、GitHub Enterprise Cloud 和 GitHub One。 GitHub Actions 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 Environments, environment protection rules, and environment secrets are available in public repositories for all products and in private repositories for GitHub Enterprise. 更多信息请参阅“GitHub 的产品”。

本文内容

Note: Environments, environment protection rules, and environment secrets are currently in beta and subject to change.

关于环境

您可以使用保护规则和机密配置环境。 当工作流程引用环境时,作业在环境的所有保护规则通过之前不会开始。 在所有环境保护规则通过之前,作业也不能访问在环境中定义的机密。

环境保护规则和环境机密只能在公共仓库中使用。 如果您将仓库从公开转换为私密,任何配置的保护规则或环境机密将被忽略, 并且您将无法配置任何环境。 如果将仓库转换回公共,您将有权访问以前配置的任何保护规则和环境机密。

环境保护规则

环境保护规则要求通过特定的条件,然后引用环境的作业才能继续。 您可以使用环境保护规则要求手动批准或延迟作业。

需要的审查者

使用所需的审查者要求特定人员或团队批准引用环境的工作流程作业。 您最多可以列出六个用户或团队作为审查者。 审查者必须至少具有对仓库的读取访问权限。 只有一个必需的审查者需要批准该作业才能继续。

有关与必需审查者一起审查引用环境的作业的详细信息,请参阅“审查部署”。

等待计时器

在最初触发作业后,使用等待计时器将作业延迟特定时间。 时间(分钟)必须是 0 至 43,200(30天)之间的整数。

环境机密

存储在环境中的机密仅可用于引用环境的工作流程作业。 如果环境需要批准,作业在所需的审查者批准之前不能访问环境机密。 有关机密的更多信息,请参阅“加密密码”。

创建环境

To configure an environment in a user account repository, you must be the repository owner. To configure an environment in an organization repository, you must have admin access.

  1. 在 GitHub 上,导航到仓库的主页面。
  2. 在仓库名称下,单击 Settings(设置)
    仓库设置按钮
  3. In the left sidebar, click Environments.
  4. 单击 New environment(新环境)
  5. 为环境输入一个名称, 然后单击 Configure environment(配置环境)。 环境名称不区分大小写。 环境名称不能超过 255 个字符,且必须在仓库中唯一。
  6. 配置任何环境保护规则或环境机密。

运行引用不存在的环境的工作流程将使用引用的名称创建环境。 新创建的环境将不配置任何保护规则或机密。 可在仓库中编辑工作流程的任何人都可以通过工作流程文件创建环境,但只有仓库管理员才能配置环境。

引用环境

工作流程中的每个作业都可以引用单个环境。 在将引用环境的作业发送到运行器之前,必须通过为环境配置的任何保护规则。 将作业发送到运行器时,作业可以访问环境的机密。

有关工作流程中引用环境的语法的更多信息,请参阅“GitHub Actions 的工作流程语法”。 有关与必需审查者一起审查引用环境的作业的详细信息,请参阅“审查部署”。

当工作流程引用环境时,环境将显示在仓库的部署中。 有关查看当前和以前的部署的详细信息,请参阅“查看部署历史记录”。

删除环境

To configure an environment in a user account repository, you must be the repository owner. To configure an environment in an organization repository, you must have admin access.

删除环境将删除与环境关联的所有机密和保护规则。 由于已删除环境的保护规则而正在等待的任何作业将自动失败。

  1. 在 GitHub 上,导航到仓库的主页面。
  2. 在仓库名称下,单击 Settings(设置)
    仓库设置按钮
  3. In the left sidebar, click Environments.
  4. 在要删除的环境旁边,单击
  5. 单击 I understand, delete this environment(我了解,删除此环境)

此文档对您有帮助吗?

Privacy policy

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。