# 管理部署环境
可以创建环境，并使用部署保护规则保护这些环境。 引用环境的作业在运行或访问环境的机密之前，必须遵循环境的任何保护规则。
## 先决条件
> [!NOTE]
> 具有 GitHub Free 计划的用户只能为公共存储库配置环境。 如果您将仓库从公开转换为私密，任何配置的保护规则或环境机密将被忽略， 并且您将无法配置任何环境。 如果将仓库转换回公共，您将有权访问以前配置的任何保护规则和环境机密。
>
> 具有 GitHub Team 的组织和具有 GitHub Pro 的用户可以为私有仓库配置环境。 有关详细信息，请参阅“[GitHub的计划](/zh/get-started/learning-about-github/githubs-plans)”。
* 有关环境的一般信息，请参阅 [使用 GitHub Actions 进行部署](/zh/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments#using-environments)。
* 有关可用规则的信息，请参阅 [部署和环境](/zh/actions/reference/workflows-and-actions/deployments-and-environments)。
## 创建环境
要在个人帐户存储库中配置环境，你必须是存储库所有者。 若要在组织存储库中配置环境，必须具有 `admin` 访问权限。
> [!NOTE]
>
> * 拥有 GitHub Team 的组织和拥有 GitHub Pro 的用户可以在私有仓库中创建环境。
> * 环境的某些功能对专用存储库不可用或可用性有限。 如果无法访问以下说明中描述的功能，请参阅相关步骤中链接的文档，了解可用性信息。
1. 在 GitHub 上，导航到存储库的主页面。
2. 在仓库名称下，单击 “Settings”\*\*\*\*。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。
3. 在左侧边栏中，单击“环境”。
4. 单击“新建环境”。
5. 为环境输入一个名称, 然后单击“配置环境”。 环境名称不区分大小写。 环境名称不能超过 255 个字符，且必须在仓库中唯一。
6. （可选）指定必须批准使用此环境的工作流程作业的人员或团队。 有关详细信息，请参阅“[部署和环境](/zh/actions/reference/workflows-and-actions/deployments-and-environments#required-reviewers)”。
1. 选择“所需审查者”\*\*\*\*。
2. 最多可输入 6 人或团队。 只需指定一名审查者即可批准该作业，使其可继续进行。
3. （可选）若要防止用户批准其触发的工作流运行，请选择“阻止自评审”\*\*\*\*。
4. 单击“保存保护规则”。
7. （可选）指定在允许使用此环境的工作流程作业继续之前要等待的时长。 有关详细信息，请参阅“[部署和环境](/zh/actions/reference/workflows-and-actions/deployments-and-environments#wait-timer)”。
1. 选择“等待计时器”。
2. 输入要等待的分钟数。
3. 单击“保存保护规则”。
8. （可选）禁止绕过配置的保护规则。 有关详细信息，请参阅“[部署和环境](/zh/actions/reference/workflows-and-actions/deployments-and-environments#allow-administrators-to-bypass-configured-protection-rules)”。
1. 取消选择“允许管理员绕过配置的保护规则”。
2. 单击“保存保护规则”。
9. 可选择启用任何使用 GitHub Apps 创建的自定义部署保护规则。 有关详细信息，请参阅“[部署和环境](/zh/actions/reference/workflows-and-actions/deployments-and-environments#custom-deployment-protection-rules)”。
1. 选择要启用的自定义保护规则。
2. 单击“保存保护规则”。
10. （可选）指定哪些分支和标记可以部署到此环境。 有关详细信息，请参阅“[部署和环境](/zh/actions/reference/workflows-and-actions/deployments-and-environments#deployment-branches-and-tags)”。
1. 在“部署分支”下拉列表中选择所需的选项。
2. 如果您选择了**特定的分支和标签**，要添加新规则，请单击**添加部署分支或标签规则**。
3. 在“引用类型”下拉菜单中，根据要应用的规则，单击\*\*分支**或**标签\*\*。
4. 输入想要允许的分支或标记的名称模式。
> [!NOTE]
> 必须单独为分支或标记配置名称模式。
5. 单击 **“添加规则”**。
11. （可选）添加环境机密。 这些机密仅在使用特定环境的工作流程任务中可用。 此外，使用此环境的工作流程作业只能在任何配置的规则（例如，必需的审查者）通过后才能访问这些机密。 有关详细信息，请参阅“[部署和环境](/zh/actions/reference/workflows-and-actions/deployments-and-environments#environment-secrets)”。
1. 在“环境机密”下，单击“添加机密” 。
2. 输入机密名称。
3. 输入机密值。
4. 单击**添加密钥**。
12. （可选）添加环境变量。 这些变量仅可用于使用环境的工作流作业，并且只能通过 [`vars`](/zh/actions/reference/workflows-and-actions/contexts#vars-context) 上下文访问。 有关详细信息，请参阅“[部署和环境](/zh/actions/reference/workflows-and-actions/deployments-and-environments#environment-variables)”。
1. 在“环境变量”下，单击“添加变量” 。
2. 输入变量名称。
3. 输入变量的值。
4. 单击“**添加变量**”。
您还可以通过 REST API 创建和配置环境。 有关详细信息，请参阅“[适用于部署环境的 REST API 终结点](/zh/rest/deployments/environments)”、“[用于 GitHub Actions 秘钥的 REST API 端点](/zh/rest/actions/secrets)”、“[GitHub Actions 变量的 REST API 端点](/zh/rest/actions/variables)”和“[适用于部署分支策略的 REST API 终结点](/zh/rest/deployments/branch-policies)”。
运行引用不存在环境的工作流程时，将会创建一个使用该引用名称的环境。 如果环境是通过运行隐式页面构建（例如，从分支或文件夹源）创建的，则源分支将作为保护规则添加到环境中。 否则，新创建的环境将不配置任何保护规则或机密。 可在仓库中编辑工作流程的任何人都可以通过工作流程文件创建环境，但只有仓库管理员才能配置环境。
## 删除环境
要在个人帐户存储库中配置环境，你必须是存储库所有者。 若要在组织存储库中配置环境，必须具有 `admin` 访问权限。
删除环境将删除与环境关联的所有机密和保护规则。 由于已删除环境的保护规则而正在等待的任何作业将自动失败。
1. 在 GitHub 上，导航到存储库的主页面。
2. 在仓库名称下，单击 “Settings”\*\*\*\*。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。
3. 在左侧边栏中，单击“环境”。
4. 在要删除的环境旁边，单击 。
5. 单击“我了解，删除此环境”。
您也可以通过 RESEST API 删除环境。 有关详细信息，请参阅“[存储库的 REST API 终结点](/zh/rest/repos#environments)”。
## 环境与部署的关系
当引用环境的工作流作业运行时，它将创建一个部署对象并将 `environment` 属性设置为环境名称。 随着工作流的进行，它还将创建部署状态对象，并将 `environment` 属性设置为环境名称，将 `environment_url` 属性设置为环境的 URL（如果在工作流中指定），以及将 `state` 属性设置为作业的状态。
您可以通过 REST API 或 GraphQL API 访问这些对象。 您还可以订阅这些 web 挂钩事件。 有关详细信息，请参阅“[存储库的 REST API 终结点](/zh/rest/repos#deployments)”、“[部署](/zh/graphql/reference/deployments#object-deployment)”(GraphQL API) 或“[Webhook 事件和有效负载](/zh/webhooks/webhook-events-and-payloads#deployment)”。
## 后续步骤
GitHub Actions 提供了多个用于管理部署的功能。 有关详细信息，请参阅“[使用 GitHub Actions 进行部署](/zh/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments)”。