本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
教程:创建使用计算运行命令的管道
在本教程中,您将配置一个管道,该管道使用构建阶段中的 Commands 操作持续运行所提供的构建命令。有关 Commands 操作的更多信息,请参阅 Commands 操作参考。
重要
作为创建管道的一部分,客户提供的 S3 工件存储桶将 CodePipeline 用于项目。(这与用于 S3 源操作的存储桶不同。) 如果 S3 工件存储桶与您的管道账户位于不同的账户中,请确保 S3 工件存储桶归其所有 AWS 账户 ,该存储桶是安全且可靠的。
先决条件
您必须已经具备以下各项:
-
存储 GitHub 库。您可以使用您在中创建的 GitHub 存储库教程:使用带有 GitHub 管道源的完整克隆。
第 1 步:创建源文件并推送到您的 GitHub 存储库
在本节中,您将创建示例源文件并将其推送到管道用于源阶段的存储库。在此示例中,您将生成并推送以下内容:
-
一个
README.txt
文件。
创建源文件
-
创建一个包含以下文本的文件:
Sample readme file
-
将该文件保存为
README.txt
。
将文件推送到您的 GitHub 存储库
-
将文件推送或上传至您的 存储库。这些文件是由创建管道向导针对您在 AWS CodePipeline中的部署操作创建的源项目。您的文件在本地目录中应如下所示:
README.txt
-
在本地计算机上从克隆的存储库使用 Git 命令行:
-
运行以下命令以立即暂存您的所有文件:
git add -A
-
运行以下命令以提交带有提交消息的文件。
git commit -m "Added source files"
-
运行以下命令以将文件从您的本地存储库推送到您的 存储库:
git push
-
步骤 2:创建管道
在此部分中,您将使用以下操作创建管道:
-
一个源阶段,对存储源文件的存储库进行 GitHub (通过 GitHub App)操作。
-
包含 Commands 操作的构建阶段。
使用向导创建管道
登录 AWS Management Console 并打开 CodePipeline 控制台,网址为 http://console.aws.amazon。 com/codesuite/codepipeline/home
。 -
在欢迎页面、入门页面或管道页面上,选择创建管道。
-
在步骤 1:选择创建选项页面上的创建选项下,选择构建自定义管道选项。选择下一步。
-
在步骤 2:选择管道设置的管道名称中,输入
MyCommandsPipeline
。 -
CodePipeline 提供 V1 和 V2 类型的管道,它们的特性和价格各不相同。在控制台中,您只能选择 V2 类型。有关更多信息,请参阅管道类型。有关定价的信息 CodePipeline,请参阅定价
。 -
在服务角色中,选择新建服务角色 CodePipeline 以允许在 IAM 中创建服务角色。
注意
如果您使用的是现有的服务角色,要使用 Commands 操作,需要为服务角色添加以下权限。在服务角色策略声明中使用基于资源的权限,将权限范围缩小到管道资源级别。有关更多信息,请参阅服务角色策略权限中的策略示例。
-
日志:CreateLogGroup
-
日志:CreateLogStream
-
日志:PutLogEvents
-
-
将高级设置中的各项设置保留为默认值,然后选择下一步。
-
在步骤 3:添加源阶段页面上,添加源阶段:
-
在来源提供商中,选择 GitHub (通过 GitHub 应用程序)。
-
在连接下,选择一个现有连接或创建一个新连接。要创建或管理 GitHub源操作的连接,请参阅GitHub 连接。
-
在存储库名称中,选择您的 GitHub .com存储库的名称。为默认分支指定一个分支,也可以指定触发器。有关更多信息,请参阅 使用触发器和筛选功能自动启动管道。
选择下一步。
-
-
在步骤 4:添加构建阶段中,选择 Commands。
注意
运行 Commands 操作将在 AWS CodeBuild中产生单独的费用。
输入以下命令:
ls echo hello world cat README.txt echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}
选择下一步。
-
在 “步骤 5:添加测试阶段” 中,选择 “跳过测试阶段”,然后再次选择 “跳过”,接受警告消息。
选择下一步。
-
在步骤 6:添加部署阶段中,选择跳过部署阶段,然后再次选择跳过以接受警告消息。
选择下一步。
-
在步骤 7:查看中,查看信息,然后选择创建管道。
-
创建操作的最后一步是在操作中添加一个环境变量,该变量将产生操作的输出变量。在 Commands 操作上,选择编辑。在编辑屏幕上,通过在变量命名空间字段中输入
compute
,为您的操作指定变量命名空间。添加 CodeBuild 输出变量
AWS_Default_Region
,然后选择添加变量。
步骤 3:运行管道并验证构建命令
发布更改以运行管道。通过查看执行历史记录、构建日志和输出变量,验证构建命令是否运行。
查看操作日志和输出变量
-
管道成功运行后,您可以查看该操作的日志和输出。
-
要查看操作的输出变量,请选择历史记录,然后选择时间线。
查看添加到操作中的输出变量。Commands 操作的输出显示解析为操作区域的输出变量。
-
要查看操作的日志,请选择成功 Commands 操作上的查看详细信息。查看 Commands 操作的日志。