Amazon CloudFormation Git sync 演练 - Amazon CloudFormation
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Amazon CloudFormation Git sync 演练

通过以下演练了解如何使用 Git sync。在开始之前,先确保满足 Git sync 先决条件

第 1 步:创建堆栈

  1. 访问 CloudFormation 控制台

  2. 选择创建堆栈

  3. 创建堆栈控制面板的先决条件 - 准备模板面板中,确认已选中选择现有模板

  4. 指定模板面板中,选择从 Git 同步

  5. 选择下一步,指定堆栈详细信息。

第 2 步:指定堆栈详细信息

  1. 提供堆栈名称面板中,输入堆栈的名称。堆栈名称可包含字母(A-Z 和 a-z)、数字(0-9)和短划线(-)。

  2. 堆栈部署文件有两个选项:

    • 使用以下参数创建文件并将其放入我的存储库。

      如果希望 Git sync 创建堆栈部署文件并将其放入存储库,请选择这一选项。

    • 我在存储库中提供自己的文件。

      如果已创建堆栈部署文件并将其添加到存储库,请选择这一选项。

    有关更多信息,请参阅 堆栈部署文件

  3. 模板定义存储库面板有两个选项:

    • 选择链接的 Git 存储库

    • 链接 Git 存储库

    如果已将 Git 存储库链接到 CloudFormation,请选择选择已链接的 Git 存储库,然后继续下一步。否则,请执行以下子步骤来连接 Git 存储库:

    1. 选择链接 Git 存储库

    2. 从以下选项中选择您的 Git 仓库提供商:

      • GitHub

      • GitHub Enterprise

      • GitLab

      • Bitbucket

    3. 从列表中选择一个连接。如果连接列表中没有显示任何选项,请转到连接控制台,来创建与存储库的连接。

  4. 存储库列表中,选择包含堆栈模板文件的 Git 存储库。

  5. 分支列表中,选择希望 Git sync 监控的分支。

    注意

    Git sync 仅监控所选分支对 CloudFormation 模板和堆栈部署文件的更改。要应用到堆栈的任何更改都必须提交到此分支。

  6. 对于部署文件路径,指定完整路径,包括存储库分支根目录下的堆栈部署文件名。

    如果 CloudFormation 正在为您生成文件,那么这就是文件在存储库中提交的位置。如果您提供文件,那么这就是文件在存储库中的位置。

  7. 添加 IAM 角色。IAM 角色包含 CloudFormation 从 Git 存储库同步堆栈所需的权限。您可以选择新建 IAM 角色来生成新角色,也可以选择现有 IAM 角色,以从 CloudFormation 账户中选择现有角色。如果选择生成新角色,该角色中将包含所需的权限。

    注意

    有关 Git sync 所需权限和信任策略的重要信息,请参阅 所需的权限

  8. 对于模板文件路径,指定堆栈模板文件在存储库根目录下的完整路径。

  9. 添加要从堆栈部署文件中设置的堆栈参数。参数是键值对。例如,要将 port 参数添加到堆栈部署文件,请执行以下操作:

    1. 选择 Add parameter (添加参数)

    2. 对于,输入 port

    3. 对于,输入 8080

    4. 对要在堆栈部署文件中提供的所有堆栈参数重复上述步骤。

  10. (可选)添加标签。标签是键值对,可用于识别堆栈中的资源并对其进行分类。要将标签添加到堆栈部署,请遵循与添加参数相同的过程。

  11. 选择下一步,继续配置堆栈选项

第 3 步:配置堆栈选项

有关配置堆栈选项的信息,请参阅 设置 Amazon CloudFormation 堆栈选项

完成配置后,选择下一步,继续查看和进行部署。

第 4 步:查看和部署

  1. 查看堆栈设置并确认以下内容:

    • 堆栈模板已正确配置并设置为从 Git 同步

    • 部署文件配置正确。

    • 模板定义存储库配置正确,尤其是选择了正确的存储库分支名称

    • 部署文件的预览正确,包含预期的参数和值。

  2. 选择提交以创建堆栈。

    重要

    选择提交后,系统会在 Git 存储库中自动创建拉取请求。必须将此拉取请求合并到 Git 存储库中才能完成该过程。合并拉取请求后,系统将创建堆栈,Git sync 会监控 CloudFormation 模板和堆栈部署文件的更改,以更新堆栈。

修改堆栈

完成上述步骤后,系统将创建一个新的堆栈,并且 CloudFormation 会监控 Git 存储库的更改。

要修改堆栈,请直接更改堆栈部署文件。然后,将其提交到您在 Git sync 中为堆栈配置的存储库和分支。

在 CloudFormation 控制面板中,您可以选择堆栈,然后选择 Git sync 选项卡,以查看有关堆栈状态和同步事件的信息。有关更多信息,请参阅 Amazon CloudFormation Git sync 状态控制面板