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

1. 导航到您所在区域的示例模板。例如，使用表格（https://docs.amazonaws.cn/documentdb/latest/developerguide/quick_start_cfn.html#quick_start_cfn-launch_stack）选择区域并下载模板。下载 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 管理控制台并打开 CodePipeline 控制台：http://console.aws.amazon.com/codesuite/codepipeline/home。

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

3. 在步骤 1：选择创建选项页面上的创建选项下，选择构建自定义管道选项。选择下一步。

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

5. CodePipeline 提供 V1 和 V2 类型的管道，它们在特性和价格上有所不同。在控制台中，您只能选择 V2 类型。有关更多信息，请参阅管道类型。有关 CodePipeline 的定价信息，请参阅定价。

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

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

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

7. 在构件存储中：

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

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

   注意

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

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

   选择下一步。

8. 在步骤 3：添加源阶段中：

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

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

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

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

   选择下一步。

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

   选择下一步。

10. 在步骤 5：添加测试阶段中，选择跳过测试阶段，并通过再次选择跳过接受警告消息。

    选择下一步。

11. 在步骤 6：添加部署阶段中：

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

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

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

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

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

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

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

    6. 选择下一步。

    7. 在步骤 7：审核中，选择创建管道。您应该可以看到一个显示管道阶段的示意图。允许您的管道运行。您的两阶段管道已完成并准备好添加其他阶段。

1. 在 https://console.aws.amazon.com/codepipeline/ 打开 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. 在 https://console.aws.amazon.com/codepipeline/ 打开 CodePipeline 控制台。

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

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

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

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

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

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

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

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

      #{DeployVariables.StackName}

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

      my-changeset

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

   7. 继续管道运行。

1. 在 https://console.aws.amazon.com/codepipeline/ 打开 CodePipeline 控制台。

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

2. 选择以编辑管道。

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

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

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

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

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

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

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

   管道在保存时运行。