教程：创建使用 Amazon CloudFormation 部署操作中的变量的管道

1. 导航到您所在区域的示例模板页面。例如，对应于 us-west-2 的页面位于 https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/sample-templates-services-us-west-2.html。在 Amazon DocumentDB 下，下载 Amazon DocumentDB 集群的模板。文件名为 documentdb_full_stack.yaml。

2. 解压缩 documentdb_full_stack.yaml 文件，然后在文本编辑器中打开它。进行以下更改。

   1. 对于此示例，将以下 Purpose: 参数添加到模板中的 Parameters 部分。

        Purpose:
          Type: String
          Default: testing
          AllowedValues:
            - testing
            - production
          Description: The purpose of this instance.

   2. 对于此示例，将以下 StackName 输出添加到模板中的 Outputs: 部分。

        StackName:
          Value: !Ref AWS::StackName

3. 将模板文件上传到您的 Amazon CodeCommit 存储库。您必须将解压缩和编辑的模板文件上传到存储库的根目录。

   要使用 CodeCommit 控制台上传您的文件，请执行以下操作：

   1. 打开 CodeCommit 控制台，然后从 “存储库” 列表中选择您的存储库。

   2. 选择添加文件，然后选择上传文件。

   3. 选择选择文件，然后浏览找到您的文件。通过输入您的用户名和电子邮件地址来提交更改。选择提交更改。

   文件在存储库的根级别看起来应该像这样：

   documentdb_full_stack.yaml

使用向导创建管道

1. 登录 Amazon Web Services Management Console 并打开 CodePipeline 控制台，网址为 http://console.aws.amazon.com/codesuite/codepipeline/home。

2. 在欢迎页面、入门页面或管道页面上，选择创建管道。

3. 在步骤 1：选择管道设置的管道名称中，输入 MyCFNDeployPipeline。

4. 在本教程中，为管道类型选择 V1。也可以选择 V2；但请注意，不同管道类型具有不同的特性和价格。有关更多信息，请参阅 管道类型。

5. 在服务角色中，执行下列操作之一：

   • 选择 “新建服务角色” CodePipeline 以允许在中创建服务角色IAM。

   • 选择现有服务角色。在角色名称中，从列表中选择您的服务角色。

6. 在构件存储中：

   1. 选择默认位置以将默认构件存储（如指定为默认值的 Amazon S3 构件桶）用于为管道选择的区域中的管道。

   2. 如果您在管道所在的区域中已有构件存储（例如，Amazon S3 构件桶），请选择自定义位置。

   注意

   这不是源代码的源存储桶。这是管道的项目存储。每个管道都需要一个单独的构件存储，例如 S3 存储桶。创建或编辑管道时，管道区域中必须有一个工件存储桶，并且每个运行操作的 Amazon 区域都必须有一个工件存储桶。

   有关更多信息，请参阅输入和输出构件 和CodePipeline 管道结构参考。

   选择下一步。

7. 在步骤 2：添加源阶段中：

   1. 在源提供程序中，选择 Amazon CodeCommit。

   2. 在存储库名称中，选择您在中创建的 CodeCommit 存储库的名称步骤 1：创建 CodeCommit 存储库。

   3. 在分支名称中，选择包含最新的代码更新的分支的名称。

   选择存储库名称和分支后，将显示要为此管道创建的 Amazon CloudWatch Events 规则。

   选择下一步。

8. 在步骤 3：添加构建阶段中，选择跳过构建阶段，并通过再次选择跳过接受警告消息。

   选择下一步。

9. 在步骤 4：添加部署阶段中：

   1. 在操作名称中，选择部署。在部署提供商中，选择CloudFormation。

   2. 在操作模式中，选择创建或更新堆栈。

   3. 在堆栈名称中，为堆栈输入名称。这是模板将创建的堆栈的名称。

   4. 在输出文件名中，输入输出文件的名称，如 outputs。这是创建堆栈后由操作创建的文件的名称。

   5. 展开高级。在参数覆盖下，作为键值对输入模板覆盖。例如，此模板需要以下覆盖。

      {
      "DBClusterName": "MyDBCluster",
      "DBInstanceName": "MyDBInstance",
      "MasterUser": "UserName",
      "MasterPassword": "Password",
      "DBInstanceClass": "db.r4.large",
      "Purpose": "testing"}

      如果不输入覆盖，则模板会创建一个具有默认值的堆栈。

   6. 选择下一步。

   7. 选择 Create pipeline（创建管道）。允许您的管道运行。您的两阶段管道已完成并准备好添加其他阶段。

1. 打开 CodePipeline 控制台，网址为https://console.aws.amazon.com/codepipeline/。

   在管道下，选择您的管道并选择查看。该图显示了您的管道源和部署阶段。

2. 选择以编辑管道，或继续在编辑模式下显示管道。

3. 选择以编辑部署阶段。

4. 添加一个部署操作，该操作将为在上一个操作中创建的堆栈创建更改集。您可以在阶段中的现有操作之后添加此操作。

   1. 在操作名称中，输入 Change_Set。对于操作提供程序，选择 Amazon CloudFormation 。

   2. 在输入构件中，选择SourceArtifact。

   3. 在操作模式中，选择创建或替换更改集。

   4. 在堆栈名称中，如下所示输入变量语法。这是为其创建更改集的堆栈的名称，其中，向操作分配默认命名空间 DeployVariables。

      #{DeployVariables.StackName}

   5. 在更改集名称中，输入更改集的名称。

      my-changeset

   6. 在参数覆盖中，将 Purpose 参数从 testing 更改为 production。

      {
      "DBClusterName": "MyDBCluster",
      "DBInstanceName": "MyDBInstance",
      "MasterUser": "UserName",
      "MasterPassword": "Password",
      "DBInstanceClass": "db.r4.large",
      "Purpose": "production"}

   7. 选择完成以保存操作。

1. 选择以编辑管道，或继续在编辑模式下显示管道。

2. 选择以编辑部署阶段。

3. 在创建更改集的部署操作之后添加手动审批操作。此操作允许您在管道执行更改集 Amazon CloudFormation 之前验证中已创建的资源变更集。

1. 打开 CodePipeline 控制台，网址为https://console.aws.amazon.com/codepipeline/。

   在管道下，选择您的管道并选择查看。该图显示了您的管道源和部署阶段。

2. 选择以编辑管道，或继续在编辑模式下显示管道。

3. 选择以编辑部署阶段。

4. 添加将执行在上一个手动操作中审批的更改集的部署操作：

   1. 在操作名称中，输入 Execute_Change_Set。对于操作提供程序，选择 Amazon CloudFormation。

   2. 在输入构件中，选择SourceArtifact。

   3. 在操作模式中，选择执行更改集。

   4. 在堆栈名称中，如下所示输入变量语法。这是为其创建更改集的堆栈的名称。

      #{DeployVariables.StackName}

   5. 在更改集名称中，输入您在上一个操作中创建的更改集的名称。

      my-changeset

   6. 选择完成以保存操作。

   7. 继续管道运行。

1. 打开 CodePipeline 控制台，网址为https://console.aws.amazon.com/codepipeline/。

   在管道下，选择您的管道并选择查看。该图显示了您的管道源和部署阶段。

2. 选择以编辑管道。

3. 选择以编辑部署阶段。

4. 添加将删除堆栈的部署操作：

   1. 在操作名称中，选择DeleteStack。在部署提供商中，选择CloudFormation。

   2. 在操作模式下，选 删除堆栈。

   3. 在堆栈名称中，如下所示输入变量语法。这是操作将删除的堆栈的名称。

   4. 选择完成以保存操作。

   5. 选择保存以保存管道。

   管道在保存时运行。