教程:创建以 Amazon AppConfig 作为部署提供方的管道
在本教程中,您将使用 Amazon AppConfig 作为部署阶段中的部署操作提供方来配置连续交付配置文件的管道。
重要
作为创建管道的一部分,CodePipeline 将使用客户提供的 S3 构件存储桶来存放构件。(这与用于 S3 源操作的存储桶不同。) 如果 S3 构件存储桶所在的账户与您的管道账户不同,请确保 S3 构件存储桶归 Amazon Web Services 账户所有,并且安全可靠。
先决条件
在开始本教程之前,您必须完成以下步骤:
-
本例将 S3 源用于您的管道。创建或使用已启用版本控制的 Amazon S3 桶。按照步骤 1:为您的应用程序创建一个 S3 源存储桶中的说明创建 S3 存储桶。
步骤 1:创建 Amazon AppConfig 资源
在本节中,您将创建以下资源:
-
Amazon AppConfig 中的应用程序是为客户提供功能的代码逻辑单元。
-
Amazon AppConfig 中的环境是 AppConfig 目标的逻辑部署组,例如测试版或生产环境中的应用程序。
-
配置文件是一组影响应用程序行为的设置。配置文件使 Amazon AppConfig 能够访问位于其存储位置中的配置。
-
(可选)Amazon AppConfig 中的部署策略定义了配置部署的行为,例如在部署期间的任何给定时间应收到新部署配置的客户端的百分比。
创建应用程序、环境、配置文件和部署策略
-
登录到 Amazon Web Services Management Console。
-
使用以下主题中的步骤在 Amazon AppConfig 中创建您的资源。
步骤 2:将文件上传到 S3 源桶
在本节中,创建一个或多个配置文件。然后将源文件压缩并推送到管道用于源阶段的桶。
创建配置文件
-
在每个区域中为每个配置创建一个
configuration.json
文件。包括以下内容:Hello World!
-
使用以下步骤压缩和上传配置文件。
压缩和上传源文件
-
创建包含文件的 .zip 文件并将文件命名为 .zip 文件
configuration-files.zip
。例如,您的 .zip 文件可以使用以下结构:. └── appconfig-configurations └── MyConfigurations ├── us-east-1 │ └── configuration.json └── us-west-2 └── configuration.json
-
在桶的 Amazon S3 控制台中,选择上传,然后按照说明上传 .zip 文件。
步骤 3:创建管道
在此部分中,您将使用以下操作创建管道:
-
一个具有 Amazon S3 操作的源阶段,其中源构件是用于配置的文件。
-
一个具有 AppConfig 部署操作的部署阶段。
使用向导创建管道
通过以下网址登录Amazon Web Services Management Console并打开 CodePipeline 控制台:http://console.aws.amazon.com/codesuite/codepipeline/home
。 -
在欢迎页面、入门页面或管道页面上,选择创建管道。
-
在步骤 1:选择创建选项页面上的创建选项下,选择构建自定义管道选项。选择下一步。
-
在步骤 2:选择管道设置的管道名称中,输入
MyAppConfigPipeline
。 -
CodePipeline 提供 V1 和 V2 类型的管道,它们在特性和价格上有所不同。在控制台中,您只能选择 V2 类型。有关更多信息,请参阅管道类型。有关 CodePipeline 的定价信息,请参阅定价
。 -
在服务角色中,选择新建服务角色,以允许 CodePipeline 在 IAM 中创建服务角色。
-
将高级设置中的各项设置保留为默认值,然后选择下一步。
-
在步骤 3:添加源阶段的源提供程序中,选择 Amazon S3。在桶中,选择 S3 源桶的名称。
在 S3 对象键中,输入您的 .zip 文件:
configuration-files.zip
。选择下一步。
-
在步骤 4:添加构建阶段中,选择跳过构建阶段,并通过再次选择跳过接受警告消息。
选择下一步。
-
在步骤 5:添加部署阶段中:
-
在部署提供程序中,选择 Amazon AppConfig。
-
在应用程序中,选择您在 Amazon AppConfig 中创建的应用程序的名称。该字段显示应用程序的 ID。
-
在环境中,选择您在 Amazon AppConfig 中创建的环境的名称。该字段显示您的环境的 ID。
-
在配置文件中,选择您在 Amazon AppConfig 中创建的配置文件的名称。该字段显示您的配置文件的 ID。
-
在部署策略中,选择部署策略的名称。这可以是您在 AppConfig 中创建的部署策略,也可以是您从 AppConfig 中的预定义部署策略中选择的策略。该字段显示您的部署策略的 ID。
-
在输入构件配置路径中,输入文件路径。确保您的输入构件配置路径与 S3 桶 .zip 文件中的目录结构相匹配。在此示例中,输入以下文件路径:
appconfig-configurations/MyConfigurations/us-west-2/configuration.json
。 -
选择下一步。
-
-
在 Step 6: Review 中,查看信息,然后选择 Create pipeline。
步骤 4:对任何源文件进行更改并验证部署
对源文件进行更改,然后将更改上传到桶。这将触发您的管道运行。通过查看版本来验证您的配置是否可用。