Amazon CloudFormation Git sync 演练
通过以下演练了解如何使用 Git sync。在开始之前,先确保满足 Git sync 先决条件。
第 1 步:创建堆栈
-
选择创建堆栈。
-
在创建堆栈控制面板的先决条件 - 准备模板面板中,确认已选中选择现有模板。
-
在指定模板面板中,选择从 Git 同步。
-
选择下一步,指定堆栈详细信息。
第 2 步:指定堆栈详细信息
-
在提供堆栈名称面板中,输入堆栈的名称。堆栈名称可包含字母(A-Z 和 a-z)、数字(0-9)和短划线(-)。
-
堆栈部署文件有两个选项:
-
使用以下参数创建文件并将其放入我的存储库。
如果希望 Git sync 创建堆栈部署文件并将其放入存储库,请选择这一选项。
-
我在存储库中提供自己的文件。
如果已创建堆栈部署文件并将其添加到存储库,请选择这一选项。
有关更多信息,请参阅 堆栈部署文件。
-
-
模板定义存储库面板有两个选项:
-
选择链接的 Git 存储库
-
链接 Git 存储库
如果已将 Git 存储库链接到 CloudFormation,请选择选择已链接的 Git 存储库,然后继续下一步。否则,请执行以下子步骤来连接 Git 存储库:
-
选择链接 Git 存储库。
-
从以下选项中选择您的 Git 仓库提供商:
-
GitHub
-
GitHub Enterprise
-
GitLab
-
Bitbucket
-
-
从列表中选择一个连接。如果连接列表中没有显示任何选项,请转到连接控制台
,来创建与存储库的连接。
-
-
在存储库列表中,选择包含堆栈模板文件的 Git 存储库。
-
在分支列表中,选择希望 Git sync 监控的分支。
注意
Git sync 仅监控所选分支对 CloudFormation 模板和堆栈部署文件的更改。要应用到堆栈的任何更改都必须提交到此分支。
-
对于部署文件路径,指定完整路径,包括存储库分支根目录下的堆栈部署文件名。
如果 CloudFormation 正在为您生成文件,那么这就是文件在存储库中提交的位置。如果您提供文件,那么这就是文件在存储库中的位置。
-
添加 IAM 角色。IAM 角色包含 CloudFormation 从 Git 存储库同步堆栈所需的权限。您可以选择新建 IAM 角色来生成新角色,也可以选择现有 IAM 角色,以从 CloudFormation 账户中选择现有角色。如果选择生成新角色,该角色中将包含所需的权限。
注意
有关 Git sync 所需权限和信任策略的重要信息,请参阅 所需的权限。
-
对于模板文件路径,指定堆栈模板文件在存储库根目录下的完整路径。
-
添加要从堆栈部署文件中设置的堆栈参数。参数是键值对。例如,要将 port 参数添加到堆栈部署文件,请执行以下操作:
-
选择 Add parameter (添加参数)。
-
对于键,输入
port
。 -
对于值,输入
8080
。 -
对要在堆栈部署文件中提供的所有堆栈参数重复上述步骤。
-
-
(可选)添加标签。标签是键值对,可用于识别堆栈中的资源并对其进行分类。要将标签添加到堆栈部署,请遵循与添加参数相同的过程。
-
选择下一步,继续配置堆栈选项。
第 3 步:配置堆栈选项
有关配置堆栈选项的信息,请参阅 设置 Amazon CloudFormation 堆栈选项。
完成配置后,选择下一步,继续查看和进行部署。
第 4 步:查看和部署
-
查看堆栈设置并确认以下内容:
-
堆栈模板已正确配置并设置为从 Git 同步。
-
部署文件配置正确。
-
模板定义存储库配置正确,尤其是选择了正确的存储库和分支名称。
-
部署文件的预览正确,包含预期的参数和值。
-
-
选择提交以创建堆栈。
重要
选择提交后,系统会在 Git 存储库中自动创建拉取请求。必须将此拉取请求合并到 Git 存储库中才能完成该过程。合并拉取请求后,系统将创建堆栈,Git sync 会监控 CloudFormation 模板和堆栈部署文件的更改,以更新堆栈。
修改堆栈
完成上述步骤后,系统将创建一个新的堆栈,并且 CloudFormation 会监控 Git 存储库的更改。
要修改堆栈,请直接更改堆栈部署文件。然后,将其提交到您在 Git sync 中为堆栈配置的存储库和分支。
在 CloudFormation 控制面板中,您可以选择堆栈,然后选择 Git sync 选项卡,以查看有关堆栈状态和同步事件的信息。有关更多信息,请参阅 Amazon CloudFormation Git sync 状态控制面板。