教程：创建一个简单的管道（S3 存储桶）

创建 S3 存储桶

1. 登录控制台，网址为 Amazon Web Services Management Console。打开 S3 控制台。

2. 请选择创建存储桶。

3. 对于存储桶名称，输入您的存储桶的名称（例如 awscodepipeline-demobucket-example-date）。

   注意

   由于 Amazon S3 中的所有桶名称必须是唯一的，因此请使用您自己的名称，而不是示例中显示的名称。您可以通过添加日期来更改示例名称。请记下该名称，因为您需要在本教程的其余部分中使用该名称。

   在区域中，选择您要在其中创建管道的区域（例如美国西部(俄勒冈州)），然后选择创建桶。

4. 创建存储桶后，系统会显示成功横幅。选择转到存储桶详细信息。

5. 在属性选项卡上，选择版本控制。选择启用版本控制，然后选择保存。

   启用版本控制后，Amazon S3 会在桶中存储每个对象的每个版本。

6. 在权限选项卡上，保留默认设置。有关 S3 存储桶和对象权限的更多信息，请参阅在策略中指定权限。

7. 接下来，下载一个示例，并将该示例保存到本地计算机上的文件夹或目录中。

   1. 选择以下选项之一。如果要对 Windows Server 实例执行本教程中的步骤，请选择 SampleApp_Windows.zip。

      • 如果您想使用部署到亚马逊 Linux 实例 CodeDeploy，请在此处下载示例应用程序：SampleApp_Linux.zip。

      • 如果你想使用部署到 Windows 服务器实例 CodeDeploy，请在此处下载示例应用程序：SampleApp_Windows.zip。

      示例应用程序包含以下用于部署的文件 CodeDeploy：

      • appspec.yml— 应用程序规范文件（AppSpec文件）是一个 YAML 格式的文件， CodeDeploy 用于管理部署。有关该 AppSpec 文件的更多信息，请参阅《Amazon CodeDeploy 用户指南》中的CodeDeploy AppSpec 文件参考。

      • index.html - 索引文件包含已部署的示例应用程序的主页。

      • LICENSE.txt - 许可证文件包含示例应用程序的许可证信息。

      • 脚本文件 - 示例应用程序使用脚本将文本文件写入实例上的某个位置。为多个 CodeDeploy 部署生命周期事件分别写入一个文件，如下所示：

        • （仅限 Linux 示例）scripts 文件夹 - 该文件夹包含以下 shell 脚本，用于安装依赖项以及启动和停止自动部署的示例应用程序：install_dependencies、start_server 和 stop_server。

        • （仅限 Windows 示例）before-install.bat - 此批处理脚本用于 BeforeInstall 部署生命周期事件，它将运行以删除此示例在先前部署中写入的旧文件，并在您的实例上创建一个位置用于写入新文件。

   2. 下载压缩（zipped）文件。不要解压缩该文件。

8. 在 Amazon S3 控制台中，为您的桶上传文件：

   1. 选择上传。

   2. 拖放文件或选择添加文件并通过浏览找到该文件。

   3. 选择上传。

创建实例角色

1. 通过以下网址打开 IAM 控制台：https://console.aws.amazon.com/iam/。

2. 在控制台控制面板中，选择角色。

3. 选择创建角色。

4. 在选择受信任实体的类型下，选择 Amazon Web Service。在选择使用案例下，选择 EC2，然后选择下一步: 权限。

5. 搜索名为 AmazonEC2RoleforAWSCodeDeploy 的策略并将其选中。

6. 搜索名为 AmazonSSMManagedInstanceCore 的策略并将其选中。选择下一步：标签。

7. 选择下一步：审核。输入角色的名称（例如 EC2InstanceRole）。

   注意

   记下您的角色名称以便在下一步中使用。在创建实例时选择此角色。

   选择 创建角色。

启动实例

1. 通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。

2. 在侧面导航栏中，选择实例，然后从页面顶部选择启动实例。

3. 在名称和标签下，对于名称，输入 MyCodePipelineDemo。这会为实例分配标签键 Name 和标签值 MyCodePipelineDemo。稍后，您将创建一个将示例 CodeDeploy 应用程序部署到实例的应用程序。 CodeDeploy根据标签选择要部署的实例。

4. 在应用程序和操作系统映像(Amazon 机器映像) 下，选择 Windows 选项。（此 AMI 称为 Microsoft Windows Server 2019 Base，标记为“符合免费套餐条件”，可以在快速入门下找到。）

5. 在实例类型下，选择符合免费套餐条件的 t2.micro 类型作为实例的硬件配置。

6. 在密钥对(登录) 下，选择或创建密钥对。

   也可以选择继续操作但不提供密钥对。

   注意

   在本教程中，您可以继续操作而不提供密钥对。要使用 SSH 连接到实例，请创建或使用密钥对。

7. 在网络设置下，执行以下操作：

   在自动分配公有 IP 中，确保状态为启用。

   • 在分配安全组旁边，选择创建新安全组。

   • 在 SSH 对应的行中，在源下选择我的 IP。

   • 选择添加安全组，选择 HTTP，然后在源类型下选择我的 IP。

8. 展开高级详细信息。在 IAM 实例配置文件中，选择您在上一过程中创建的 IAM 角色（例如 EC2InstanceRole）。

9. 在摘要下的实例数下，输入 2。

10. 选择启动实例。

11. 选择查看所有实例以关闭确认页面并返回控制台。

12. 您可以在实例页面上查看启动的状态。启动实例时，其初始状态为 pending。实例启动后，其状态变为 running，并且会收到一个公有 DNS 名称。（如果公有 DNS 列不显示，请选择显示/隐藏图标，然后选择公有 DNS。）

13. 可能需要花几分钟时间，实例才能准备好让您连接到它。检查您的实例是否通过了状态检查。您可以在状态检查列中查看此信息。

创建 CodeDeploy 服务角色

1. 通过以下网址打开 IAM 控制台：https://console.aws.amazon.com/iam/。

2. 在控制台控制面板中，选择角色。

3. 选择创建角色。

4. 在选择受信任实体下，选择 Amazon Web Service。在 Use case（使用案例）下，选择 CodeDeploy。CodeDeploy从列出的选项中进行选择。选择下一步。AWSCodeDeployRole 托管策略已附加到角色。

5. 选择下一步。

6. 输入角色的名称（例如 CodeDeployRole），然后选择创建角色。

要在中创建应用程序 CodeDeploy

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

2. 如果未出现 “应用程序” 页面，请在 Amazon CodeDeploy 菜单上选择 “应用程序”。

3. 选择创建应用程序。

4. 在应用程序名称中，输入 MyDemoApplication。

5. 在 Compute Platform（计算平台）中，选择 EC2/On-premises（EC2/本地）。

6. 选择创建应用程序。

要在中创建部署组 CodeDeploy

1. 在显示应用程序的页面上，选择创建部署组。

2. 在 Deployment group name（部署组名称）中，输入 MyDemoDeploymentGroup。

3. 在服务角色中，选择您之前创建的服务角色。您使用的服务角色必须至少 Amazon CodeDeploy 具有创建服务角色中所述的信任和权限 CodeDeploy。要获得服务角色 ARN，请参阅获得服务角色 ARN（控制台）。

4. 在部署类型下，选择就地。

5. 在环境配置下，选择 Amazon EC2 实例。在键字段中选择名称，然后在值字段中输入 MyCodePipelineDemo。

   重要

   在这里，您必须为名称键选择您在创建 EC2 实例时为该实例分配的值。如果您使用 MyCodePipelineDemo 以外的内容标记实例，则在此处，请务必使用该内容。

6. 在 “使用 S Amazon ystems Manager 配置代理” 下，选择 “立即并安排更新”。这将在实例上安装代理。Windows 实例已经配置了 SSM 代理，现在将使用该 CodeDeploy 代理进行更新。

7. 在部署设置下，选择 CodeDeployDefault.OneAtaTime。

8. 在负载均衡器下，确保未选中启用负载均衡框。您无需为此示例设置负载均衡器或选择目标组。取消选中此复选框后，不会显示负载均衡器选项。

9. 在高级部分中，保留默认值。

10. 选择 Create deployment group（创建部署组）。

创建 CodePipeline 自动发布流程

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

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

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

   注意

   如果您为管道选择另一个名称，请确保在本教程的剩下部分使用该名称替代 MyFirstPipeline。创建管道后，便无法再更改其名称。管道名称受一些限制的约束。有关更多信息，请参阅 中的配额 Amazon CodePipeline。

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

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

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

   • 选择现有服务角色以使用已在 IAM 中创建的服务角色。在角色名称中，从列表中选择您的服务角色。

6. 将高级设置中的各项设置保留为默认值，然后选择下一步。

7. 在步骤 2: 添加源阶段的源提供程序中，选择 Amazon S3。在存储桶中，输入您在步骤 1：为您的应用程序创建一个 S3 存储桶中创建的 S3 存储桶的名称。在S3 对象键中，输入带或不带文件路径的对象键。请记住加上文件的扩展名。例如，对于 SampleApp_Windows.zip，输入示例文件名，如以下示例所示：

   SampleApp_Windows.zip

   选择下一步。

   在更改检测选项下面，保留默认值。这 CodePipeline 允许使用 Amazon E CloudWatch vents 来检测源存储桶中的更改。

   选择下一步。

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

9. 在步骤 4：添加部署阶段中，在部署提供程序中，选择CodeDeploy 。“区域” 字段默认为与您的管道 Amazon Web Services 区域 相同。在应用程序名称中，输入 MyDemoApplication，或选择刷新按钮，然后从列表中选择应用程序名称。在部署组中，输入 MyDemoDeploymentGroup 或者从列表中选择它，然后选择下一步。

   注意

   名称“Deploy”是在步骤 4：添加部署阶段步骤中创建的阶段的默认名称，就像“Source”是管道第一阶段的默认名称一样。

10. 在步骤 5：审核中，查看信息，然后选择创建管道。

11. 管道开始运行。当 CodePipeline 示例向部署中的每个 Amazon EC2 实例部署网页时，您可以查看进度以及成功和失败消息。 CodeDeploy

验证您的管道是否已成功运行

1. 查看管道的初始进度。每个阶段的状态将从还没有任何执行变为正在进行，然后变为 成功或失败。管道将在几分钟内完成首次运行。

2. 操作状态显示成功之后，在部署阶段的状态区域中，选择详细信息。这将打开 CodeDeploy 控制台。

3. 在部署组选项卡的部署生命周期事件下，选择一个实例 ID。此操作将打开 EC2 控制台。

4. 在描述选项卡上的公有 DNS中，复制地址，然后将其粘贴到 Web 浏览器的地址栏中。查看上传到 S3 存储桶的示例应用程序的索引页面。

   此网页为您上传到 S3 桶的示例应用程序显示。

要在中创建第二个部署组 CodeDeploy

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

2. 选择应用程序，然后在应用程序列表中选择 MyDemoApplication。

3. 选择部署组选项卡，然后选择创建部署组。

4. 在创建部署组页面的部署组名称中，输入第二个部署组的名称（例如 CodePipelineProductionFleet）。

5. 在服务角色中，选择与初始部署相同的 CodeDeploy 服务角色（不是 CodePipeline 服务角色）。

6. 在部署类型下，选择就地。

7. 在环境配置下，选择 Amazon EC2 实例。在键框中选择名称，然后在值框中从列表中选择 MyCodePipelineDemo。保留部署设置的默认配置。

8. 在部署配置中，选择 CodeDeployDefault.OneAtaTime。

9. 在负载均衡器中，取消选择启用负载均衡。

10. 选择 Create deployment group（创建部署组）。

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

2. 在名称中，选择您创建的管道的名称 MyFirstPipeline。

3. 在管道详细信息页中，选择编辑。

4. 在编辑页面上，选择 + 添加阶段以紧随 Deploy 阶段之后添加一个阶段。

   

5. 在添加阶段的阶段名称中，输入 Production。选择添加阶段。

6. 在新阶段中，选择 + 添加操作组。

7. 在编辑操作的操作名称中，输入 Deploy-Second-Deployment。在 “操作提供者” 中的 “部署” 下，选择CodeDeploy。

8. 在该 CodeDeploy 部分的应用程序名称中，MyDemoApplication从下拉列表中进行选择，就像创建管道时一样。在部署组中，选择您刚刚创建的部署组 CodePipelineProductionFleet。在输入构件中，从源操作中选择输入构件。选择保存。

9. 在编辑页面上，选择保存。在保存管道更改中，选择保存。

10. 虽然新阶段已添加到您的管道中，但该阶段显示为 No executions yet 状态，因为没有发生触发管道再次运行的更改。您必须手动重新运行最新修订，以了解编辑后的管道的运行情况。在管道详细信息页面中，选择发布更改，然后在系统提示时选择发布。这会通过管道运行在源操作中指定的每个源位置中提供的最新修订。

    或者，要使用重新运行管道，请从本地 Linux、macOS 或 Unix 计算机上的终端或本地 Windows 计算机上的命令提示符处运行start-pipeline-execution该命令，指定管道的名称。 Amazon CLI 这将第二次通过管道运行您的源存储桶中的应用程序。

    aws codepipeline start-pipeline-execution --name MyFirstPipeline

    该命令返回 pipelineExecutionId 对象。

11. 返回 CodePipeline 控制台，在管道列表中 MyFirstPipeline，选择打开视图页面。

    管道显示三个阶段以及项目经历这三个阶段时的状态。管道经历所有阶段可能需要 5 分钟的时间。您将看到前两个阶段的部署取得成功，正如之前一样，但 Production 阶段显示 Deploy-Second-Deployment 操作失败。

12. 在 Deploy-Second-Deployment 操作中，选择 Details。您将被重定向到 CodeDeploy部署页面。在这种情况下，操作失败是因为第一个实例组部署到所有 EC2 实例，导致第二个部署组没有实例可用。

    注意

    此故障是特意设计的，是为了演示某个管道阶段出现故障会怎么样。

为管道创建第三个阶段

1. 在本地 Linux、macOS 或 Unix 计算机上打开终端会话，或者在本地 Windows 计算机上打开命令提示符，运行 get-pipeline 命令，以显示您刚创建的管道的结构。对于 MyFirstPipeline，您可以键入以下命令：

   aws codepipeline get-pipeline --name "MyFirstPipeline"

   此命令返回的结构 MyFirstPipeline。输出的第一部分应类似于以下内容：

   {
       "pipeline": {
           "roleArn": "arn:aws:iam::80398EXAMPLE:role/AWS-CodePipeline-Service",
           "stages": [
       ...    

   输出的最后部分包括管道元数据，应类似于以下内容：

       ...
           ],
           "artifactStore": {
               "type": "S3"
               "location": "codepipeline-us-east-2-250656481468",
           },
           "name": "MyFirstPipeline",
           "version": 4
       },
       "metadata": {
           "pipelineArn": "arn:aws:codepipeline:us-east-2:80398EXAMPLE:MyFirstPipeline",
           "updated": 1501626591.112,
           "created": 1501626591.112
       }
   }    

2. 将此结构复制并粘贴到纯文本编辑器中，并将文件保存为 pipeline.json。为了方便起见，请将此文件保存在运行 aws codepipeline 命令的相同目录中。

   注意

   您可以使用 get-pipeline 命令将 JSON 直接添加到文件中，如下所示：

   aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

3. 将部署阶段部分复制并粘贴在前两个阶段之后。由于它是一个部署阶段，就像部署阶段一样，您可以将其用作第三个阶段的模板。

4. 更改阶段的名称和部署组详细信息。

   以下示例显示将在部署阶段结束后添加到 pipeline.json 文件的 JSON。使用新值编辑突出显示的元素。请记住，使用逗号分隔部署和生产阶段定义。

   ,
   {
       "name": "Production",
        "actions": [
           {
            "inputArtifacts": [
                {
                 "name": "MyApp"
                }
              ],
             "name": "Deploy-Second-Deployment",
             "actionTypeId": {
                 "category": "Deploy",
                 "owner": "AWS",
                 "version": "1",
                 "provider": "CodeDeploy"
                 },
            "outputArtifacts": [],
            "configuration": {
                 "ApplicationName": "CodePipelineDemoApplication",
                 "DeploymentGroupName": "CodePipelineProductionFleet"
                  },
            "runOrder": 1
           }
       ]
   }

5. 如果您要使用通过 get-pipeline 命令检索到的管道结构，则必须删除 JSON 文件中的 metadata 行。否则，update-pipeline 命令无法使用它。删除 "metadata": { } 行以及 "created"、"pipelineARN" 和 "updated" 字段。

   例如，从结构中删除以下各行：

   "metadata": {  
     "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name",
     "created": "date",
     "updated": "date"
     }

   保存该文件。

6. 运行 update-pipeline 命令并指定管道 JSON 文件，类似于以下内容：

   aws codepipeline update-pipeline --cli-input-json file://pipeline.json

   该命令会返回更新后管道的整个结构。

   重要

   务必在文件名前包含 file://。此命令中需要该项。

7. 运行 start-pipeline-execution 命令，并且指定管道的名称。这将第二次通过管道运行您的源存储桶中的应用程序。

   aws codepipeline start-pipeline-execution --name MyFirstPipeline

   该命令返回 pipelineExecutionId 对象。

8. 打开 CodePipeline 控制台并MyFirstPipeline从管道列表中进行选择。

   管道显示三个阶段以及项目经历这三个阶段时的状态。管道经历所有阶段可能需要 5 分钟的时间。虽然前两个阶段的部署取得成功，正如之前一样，但 Production 阶段显示 Deploy-Second-Deployment 操作失败。

9. 在 Deploy-Second-Deployment 操作中，选择 Details 以查看故障详细信息。您将被重定向到 CodeDeploy 部署的详细信息页面。在这种情况下，操作失败是因为第一个实例组部署到所有 EC2 实例，导致第二个部署组没有实例可用。

   注意

   此故障是特意设计的，是为了演示某个管道阶段出现故障会怎么样。

禁用和启用 CodePipeline 管道中各个阶段之间的过渡

1. 打开 CodePipeline 控制台并MyFirstPipeline从管道列表中进行选择。

2. 在管道详细信息页面中，选择第二个阶段（部署）与您在上一部分中添加的第三个阶段（生产）之间的禁用过渡按钮。

3. 在禁用过渡中，键入禁用阶段过渡的原因，然后选择禁用。

   各个阶段之间的箭头显示一个图标和颜色变化，以及启用过渡按钮。

   

4. 再次将示例应用程序上传到 S3 存储桶。由于存储桶启用了版本控制，因此这一更改将启动管道。

5. 返回管道详细信息页面，查看各个阶段的状态。管道视图会随之发生变化，以显示前两个阶段的进度和成功消息，但第三个阶段不会发生任何变化。此过程可能需要几分钟时间。

6. 通过选择两个阶段之间的启用过渡按钮，即可启用过渡。在 Enable transition 对话框中，选择 Enable。这一阶段将在几分钟内开始运行，并尝试处理已经历管道的前两个阶段的项目。

   注意

   如果您希望第三阶段成功，请在启用过渡之前编辑 CodePipelineProductionFleet 部署组，并指定部署应用程序的另一组 EC2 实例。有关如何执行此操作的更多信息，请参阅更改部署组设置。如果您创建更多的 EC2 实例，可能会产生额外成本。

清理本教程中使用的资源

1. 要清理您的 CodePipeline 资源，请按照中删除管道中的说明进行操作 Amazon CodePipeline。

2. 要清理 CodeDeploy 资源，请按照清理资源（控制台）中的说明进行操作。

3. 要删除 S3 存储桶，请按照删除或清空存储桶中的说明操作。如果您不打算创建更多管道，请删除为存储管道构件而创建的 S3 存储桶。有关此存储桶的更多信息，请参阅CodePipeline 概念 。