教程:创建使用计算运行命令的管道 - AWS CodePipeline

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

教程:创建使用计算运行命令的管道

在本教程中,您将配置一个管道,该管道使用构建阶段中的 Commands 操作持续运行所提供的构建命令。有关 Commands 操作的更多信息,请参阅 Commands 操作参考

重要

作为创建管道的一部分,客户提供的 S3 工件存储桶将 CodePipeline 用于项目。(这与用于 S3 源操作的存储桶不同。) 如果 S3 工件存储桶与您的管道账户位于不同的账户中,请确保 S3 工件存储桶归其所有 AWS 账户 ,该存储桶是安全且可靠的。

先决条件

您必须已经具备以下各项:

第 1 步:创建源文件并推送到您的 GitHub 存储库

在本节中,您将创建示例源文件并将其推送到管道用于源阶段的存储库。在此示例中,您将生成并推送以下内容:

  • 一个 README.txt 文件。

创建源文件
  1. 创建一个包含以下文本的文件:

    Sample readme file
  2. 将该文件保存为 README.txt

将文件推送到您的 GitHub 存储库
  1. 将文件推送或上传至您的 存储库。这些文件是由创建管道向导针对您在 AWS CodePipeline中的部署操作创建的源项目。您的文件在本地目录中应如下所示:

    README.txt
  2. 在本地计算机上从克隆的存储库使用 Git 命令行:

    1. 运行以下命令以立即暂存您的所有文件:

      git add -A
    2. 运行以下命令以提交带有提交消息的文件。

      git commit -m "Added source files"
    3. 运行以下命令以将文件从您的本地存储库推送到您的 存储库:

      git push

步骤 2:创建管道

在此部分中,您将使用以下操作创建管道:

  • 一个源阶段,对存储源文件的存储库进行 GitHub (通过 GitHub App)操作。

  • 包含 Commands 操作的构建阶段。

使用向导创建管道
  1. 登录 AWS Management Console 并打开 CodePipeline 控制台,网址为 http://console.aws.amazon。 com/codesuite/codepipeline/home

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

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

  4. 步骤 2:选择管道设置管道名称中,输入 MyCommandsPipeline

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

  6. 服务角色中,选择新建服务角色 CodePipeline 以允许在 IAM 中创建服务角色。

    注意

    如果您使用的是现有的服务角色,要使用 Commands 操作,需要为服务角色添加以下权限。在服务角色策略声明中使用基于资源的权限,将权限范围缩小到管道资源级别。有关更多信息,请参阅服务角色策略权限中的策略示例。

    • 日志:CreateLogGroup

    • 日志:CreateLogStream

    • 日志:PutLogEvents

  7. 高级设置中的各项设置保留为默认值,然后选择下一步

  8. 步骤 3:添加源阶段页面上,添加源阶段:

    1. 来源提供商中,选择 GitHub (通过 GitHub 应用程序)

    2. 连接下,选择一个现有连接或创建一个新连接。要创建或管理 GitHub源操作的连接,请参阅GitHub 连接

    3. 存储库名称中,选择您的 GitHub .com存储库的名称。为默认分支指定一个分支,也可以指定触发器。有关更多信息,请参阅 使用触发器和筛选功能自动启动管道

    选择下一步

  9. 步骤 4:添加构建阶段中,选择 Commands

    注意

    运行 Commands 操作将在 AWS CodeBuild中产生单独的费用。

    输入以下命令:

    ls echo hello world cat README.txt echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}

    选择下一步

    步骤 4:使用 “命令” 操作为新管道添加构建阶段页面
  10. 在 “步骤 5:添加测试阶段” 中,选择 “跳过测试阶段”,然后再次选择 “跳过”,接受警告消息。

    选择下一步

  11. 步骤 6:添加部署阶段中,选择跳过部署阶段,然后再次选择跳过以接受警告消息。

    选择下一步

  12. 步骤 7:查看中,查看信息,然后选择创建管道

  13. 创建操作的最后一步是在操作中添加一个环境变量,该变量将产生操作的输出变量。在 Commands 操作上,选择编辑。在编辑屏幕上,通过在变量命名空间字段中输入 compute,为您的操作指定变量命名空间。

    添加 CodeBuild 输出变量AWS_Default_Region,然后选择添加变量

    Commands 操作的“编辑”页面

步骤 3:运行管道并验证构建命令

发布更改以运行管道。通过查看执行历史记录、构建日志和输出变量,验证构建命令是否运行。

查看操作日志和输出变量
  1. 管道成功运行后,您可以查看该操作的日志和输出。

  2. 要查看操作的输出变量,请选择历史记录,然后选择时间线

    查看添加到操作中的输出变量。Commands 操作的输出显示解析为操作区域的输出变量。

    显示解析为操作区域的输出变量的 Commands 操作输出。
  3. 要查看操作的日志,请选择成功 Commands 操作上的查看详细信息。查看 Commands 操作的日志。

    Commands 操作的日志示例