本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 Git 同步從儲存庫原始程式碼建立堆疊
本主題說明如何建立使用 Git 同步同步到 AWS CloudFormation Git 儲存庫的堆疊。
重要
繼續操作之前,請先完成上一節中的所有先決條件。
從儲存庫原始程式碼建立堆疊
登入 AWS Management Console 並在 https://console.aws.amazon.com/cloudformation
開啟 AWS CloudFormation 主控台。 -
在畫面頂端的導覽列上,選擇要在其中 AWS 區域 建立堆疊的 。
-
在堆疊頁面上,選擇建立堆疊 ,然後選擇使用新資源 (標準)。
-
在 Create stack (建立堆疊) 頁面上,執行下列動作:
-
對於先決條件 - 準備範本 ,請保留選擇現有的範本。
-
對於指定範本 ,選擇從 Git 同步,然後選擇下一步 。
-
-
在指定堆疊詳細資訊頁面上,針對堆疊名稱 ,輸入堆疊的名稱。堆疊名稱可包含字母 (A-Z 和 a-z)、數字 (0-9) 和破折號 (-)。
-
對於堆疊部署檔案 ,部署檔案建立 :
-
如果您尚未建立堆疊部署檔案並將其新增至儲存庫,請選擇使用下列參數建立檔案,並將其放置在我的儲存庫中。
-
如果您的儲存庫中有堆疊部署檔案,請選擇我在儲存庫中提供自己的檔案。
-
-
針對範本定義儲存庫 ,選擇選擇連結的 Git 儲存庫,以選擇已連結至 的 Git 儲存庫 CloudFormation,或選擇連結 Git 儲存庫以連結新的儲存庫。如果您選擇連結 Git 儲存庫,請執行下列動作:
-
針對選取儲存庫提供者 ,選擇下列其中一項:
-
GitHub
-
GitHub 企業伺服器
-
GitLab
-
Bitbucket
-
GitLab 自我管理
-
-
對於連線 ,從清單中選擇連線。如果連線清單中沒有顯示任何選項,請選擇新增連線以前往連線主控台
,並建立與儲存庫的連線。
-
-
在儲存庫清單中,選取包含堆疊範本檔案的 Git 儲存庫。
-
在分支清單中,選取您希望 Git 同步監視的分支。
注意
Git 同步只會監控選取的分支是否有範本和堆疊部署檔案的變更 CloudFormation。您想要套用至堆疊的任何變更,均必須遞交到此分支。
-
若為部署檔案路徑,請指定完整路徑,包含儲存庫分支根目錄中的堆疊部署檔案名稱。
如果 CloudFormation 正在為您產生檔案,則檔案會提交到您的儲存庫中。如果您要提供檔案,這是檔案在儲存庫中的位置。
-
新增IAM角色 。此IAM角色包含 從您的 Git 儲存庫 CloudFormation 同步堆疊所需的許可。您可以選擇新IAM角色來產生新角色,或選擇現有IAM角色來從 中選取現有角色 AWS 帳戶。如果您選擇產生新角色,所需的許可會包含在角色中。
-
啟用或停用提取請求的註解:
-
若要在提取堆疊更新請求中設定變更 CloudFormation 後集資訊,請保持開啟提取請求切換的啟用評論。
-
如果您關閉此切換,則 CloudFormation 不會在更新儲存庫檔案時,描述目前堆疊組態與提取請求中提議變更之間的差異。
-
-
若為範本檔案路徑,請為堆疊範本檔案指定儲存庫根目錄的完整路徑。
-
(選用) 若要指定堆疊參數,請選擇新增參數 ,為每個參數提供索引鍵和值,然後選擇下一步 。如需詳細資訊,請參閱堆疊部署檔案。
例如,若要在堆疊部署檔案中指定
port=8080
參數,請執行下列動作:-
選擇 Add parameter (新增參數)。
-
在 Key (索引鍵) 欄位,輸入
port
。 -
針對數值,輸入
8080
。
-
-
(選用) 若要指定堆疊標籤,請選擇新增標籤 ,為每個標籤提供標籤索引鍵和值,然後選擇下一步 。如需詳細資訊,請參閱堆疊部署檔案。
-
選擇下一步繼續設定堆疊選項。如需組態堆疊選項的相關資訊,請參閱 設定堆疊選項。
完成設定後,請選擇下一步繼續檢閱和部署。
-
檢閱堆疊設定並確認下列事項:
-
堆疊範本已正確設定,並設為從 Git 同步。
-
部署檔案設定正確。
-
範本定義儲存庫已正確設定,尤其是選取了正確的儲存庫和分支名稱。
-
部署檔案的預覽是正確的,且包含預期的參數與值。
-
-
選擇提交以建立堆疊。
選擇提交 後,系統會自動在您的 Git 儲存庫中建立提取請求。您必須將此提取請求合併到 Git 儲存庫中,才能建立堆疊。建立堆疊後, CloudFormation 監控您的 Git 儲存庫以進行變更。
從 Git 儲存庫更新堆疊
若要更新堆疊,請直接變更範本檔案或 Git 儲存庫中的堆疊部署檔案。將變更遞交至受監控分支後, CloudFormation 會自動更新堆疊。如果您使用提取請求,則在更新堆疊之前,系統會自動在您的 Git 儲存庫中建立提取請求。您必須將此提取請求合併到您的 Git 儲存庫中,才能更新堆疊。
在 CloudFormation 主控台中,您可以選取堆疊,然後選擇 Git 同步索引標籤,以檢視堆疊和同步事件狀態的相關資訊。如需詳細資訊,請參閱Git 同步狀態儀表板。