将环境与操作关联

当您将环境与支持的工作流程操作关联时，该环境的 AWS 账户、默认 IAM 角色和可选的 Amazon VPC 将被分配给该操作。之后，此操作可以使用 IAM 角色连接和部署到 AWS 账户，还可以连接到可选 Amazon VPC。

按照以下说明操作来将环境与操作关联。

步骤 1：将环境与工作流操作关联

使用以下过程将环境与工作流操作关联。

Visual

使用可视化编辑器将环境与工作流操作关联

在处打开 CodeCatalyst 控制台https://codecatalyst.aws/。
选择您的项目。
在导航窗格中，选择 CI/CD，然后选择工作流程。
选择工作流的名称。您可以按定义工作流的源存储库或分支名称筛选，也可以按工作流名称或状态筛选。
选择编辑。
选择可视化。
在工作流图中，选择环境支持的操作。有关更多信息，请参阅哪些操作支持在中显示其部署信息 CodeCatalyst？。
选择配置选项卡，然后在环境字段中指定信息，如下所示。

环境

指定要在操作中使用的 CodeCatalyst 环境。该操作连接到所选环境中指定的 AWS 账户和可选 Amazon VPC。该操作使用环境中指定的默认 IAM 角色连接到 AWS 账户，并使用亚马逊 VPC 连接中指定的 IAM 角色连接亚马逊 VPC。

注意
如果默认 IAM 角色不具有操作所需的权限，则可以将操作配置为使用其他角色。有关更多信息，请参阅更改操作的 IAM 角色。

有关环境的更多信息，请参阅部署到 AWS 账户和 VPC和创建环境。
（可选）更改与操作关联的 IAM 角色。如果角色包含操作的一组错误权限，则可能需要更改角色。

要更改角色，请执行以下操作：
1. 在《里面有什么my-environment？》方框，然后选择垂直省略号图标 () 。
2. 选择下列选项之一：
  - 切换角色。选择此选项能且只能更改此操作使用的 IAM 角色。其他操作继续使用其关联环境中指定的默认 IAM 角色。有关更多信息，请参阅更改操作的 IAM 角色。
  - 编辑环境。选择此选项可更改环境中列出的默认 IAM 角色。选择此选项后，您的操作以及与同一环境关联的任何其他操作都将开始使用新的默认 IAM 角色。
    
    重要
    更新默认 IAM 角色时要谨慎。如果角色具备的权限不足，无法执行所有共享环境的操作，则更改角色可能会导致操作失败。
（可选）选择验证，在提交之前验证工作流的 YAML 代码。
选择提交，输入提交消息，然后再次选择提交。

YAML

使用 YAML 编辑器将环境与工作流操作关联

在处打开 CodeCatalyst 控制台https://codecatalyst.aws/。
选择您的项目。
在导航窗格中，选择 CI/CD，然后选择工作流程。
选择工作流的名称。您可以按定义工作流的源存储库或分支名称筛选，也可以按工作流名称或状态筛选。
选择编辑。
选择 YAML。
在要与环境关联的工作流操作中，添加与以下内容类似的代码：
```
action-name:
  Environment:
    Name: environment-name
```
有关更多信息，请参阅操作类型主题。本主题包含每个操作的文档链接，包括其 YAML 参考。
（可选）如果您希望操作使用与环境中列出的默认 IAM 角色不同的角色，请添加包含您要使用的角色的 Connections: 部分。有关更多信息，请参阅更改操作的 IAM 角色。
（可选）选择验证，在提交之前验证工作流的 YAML 代码。
选择提交，输入提交消息，然后再次选择提交。

步骤 2：填充部署活动页面

将环境与工作流操作关联后，可以在 CodeCatalyst 控制台的 “环境” 部分的 “部署活动” 和 “部署目标” 页面中填充部署信息。按照以下说明操作来填充这些页面。

注意

只有少数操作支持在 CodeCatalyst控制台中显示其部署信息。有关更多信息，请参阅哪些操作支持在中显示其部署信息 CodeCatalyst？。

将部署信息添加到 CodeCatalyst

如果您在步骤 1：将环境与工作流操作关联中提交更改时工作流运行未自动启动，请执行以下操作来手动启动运行：
1. 在导航窗格中，选择 CI/CD，然后选择工作流程。
2. 选择工作流的名称。您可以按定义工作流的源存储库或分支名称筛选，也可以按工作流名称或状态筛选。
3. 选择运行。
工作流程运行启动新的部署，这会导致 CodeCatalyst 向添加部署信息 CodeCatalyst。
验证部署活动是否已添加到 CodeCatalyst 控制台：
1. 在导航窗格中，选择 CI/CD，然后选择环境。
2. 选择您的环境（例如 Production）。
3. 选择部署活动选项卡，并确认部署的状态为成功。这表示工作流运行已成功部署您的应用程序资源。
4. 选择部署目标选项卡，并确认已显示您的应用程序资源。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

创建环境

将 VPC 与环境关联