使用 Git 同步從儲存庫原始程式碼建立堆疊 - AWS CloudFormation

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 Git 同步從儲存庫原始程式碼建立堆疊

本主題說明如何建立使用 Git 同步同步到 AWS CloudFormation Git 儲存庫的堆疊。

重要

繼續操作之前,請先完成上一節中的所有先決條件

從儲存庫原始程式碼建立堆疊

  1. 登入 AWS Management Console 並在 https://console.aws.amazon.com/cloudformation 開啟 AWS CloudFormation 主控台。

  2. 在畫面頂端的導覽列上,選擇要在其中 AWS 區域 建立堆疊的 。

  3. 堆疊頁面上,選擇建立堆疊 ,然後選擇使用新資源 (標準)

  4. Create stack (建立堆疊) 頁面上,執行下列動作:

    1. 對於先決條件 - 準備範本 ,請保留選擇現有的範本

    2. 對於指定範本 ,選擇從 Git 同步,然後選擇下一步

  5. 指定堆疊詳細資訊頁面上,針對堆疊名稱 ,輸入堆疊的名稱。堆疊名稱可包含字母 (A-Z 和 a-z)、數字 (0-9) 和破折號 (-)。

  6. 對於堆疊部署檔案 部署檔案建立

    • 如果您尚未建立堆疊部署檔案並將其新增至儲存庫,請選擇使用下列參數建立檔案,並將其放置在我的儲存庫中。

    • 如果您的儲存庫中有堆疊部署檔案,請選擇我在儲存庫中提供自己的檔案。

  7. 針對範本定義儲存庫 ,選擇選擇連結的 Git 儲存庫,以選擇已連結至 的 Git 儲存庫 CloudFormation,或選擇連結 Git 儲存庫以連結新的儲存庫。如果您選擇連結 Git 儲存庫,請執行下列動作:

    1. 針對選取儲存庫提供者 ,選擇下列其中一項:

      • GitHub

      • GitHub 企業伺服器

      • GitLab

      • Bitbucket

      • GitLab 自我管理

    2. 對於連線 ,從清單中選擇連線。如果連線清單中沒有顯示任何選項,請選擇新增連線以前往連線主控台,並建立與儲存庫的連線。

  8. 儲存庫清單中,選取包含堆疊範本檔案的 Git 儲存庫。

  9. 分支清單中,選取您希望 Git 同步監視的分支。

    注意

    Git 同步只會監控選取的分支是否有範本和堆疊部署檔案的變更 CloudFormation。您想要套用至堆疊的任何變更,均必須遞交到此分支。

  10. 若為部署檔案路徑,請指定完整路徑,包含儲存庫分支根目錄中的堆疊部署檔案名稱。

    如果 CloudFormation 正在為您產生檔案,則檔案會提交到您的儲存庫中。如果您要提供檔案,這是檔案在儲存庫中的位置。

  11. 新增IAM角色 。此IAM角色包含 從您的 Git 儲存庫 CloudFormation 同步堆疊所需的許可。您可以選擇新IAM角色來產生新角色,或選擇現有IAM角色來從 中選取現有角色 AWS 帳戶。如果您選擇產生新角色,所需的許可會包含在角色中。

  12. 啟用或停用提取請求的註解:

    • 若要在提取堆疊更新請求中設定變更 CloudFormation 後集資訊,請保持開啟提取請求切換的啟用評論

    • 如果您關閉此切換,則 CloudFormation 不會在更新儲存庫檔案時,描述目前堆疊組態與提取請求中提議變更之間的差異。

  13. 若為範本檔案路徑,請為堆疊範本檔案指定儲存庫根目錄的完整路徑。

  14. (選用) 若要指定堆疊參數,請選擇新增參數 ,為每個參數提供索引鍵和值,然後選擇下一步 。如需詳細資訊,請參閱堆疊部署檔案

    例如,若要在堆疊部署檔案中指定port=8080參數,請執行下列動作:

    1. 選擇 Add parameter (新增參數)

    2. Key (索引鍵) 欄位,輸入 port

    3. 針對數值,輸入 8080

  15. (選用) 若要指定堆疊標籤,請選擇新增標籤 ,為每個標籤提供標籤索引鍵和值,然後選擇下一步 。如需詳細資訊,請參閱堆疊部署檔案

  16. 選擇下一步繼續設定堆疊選項。如需組態堆疊選項的相關資訊,請參閱 設定堆疊選項

    完成設定後,請選擇下一步繼續檢閱和部署。

  17. 檢閱堆疊設定並確認下列事項:

    • 堆疊範本已正確設定,並設為從 Git 同步

    • 部署檔案設定正確。

    • 範本定義儲存庫已正確設定,尤其是選取了正確的儲存庫分支名稱

    • 部署檔案的預覽是正確的,且包含預期的參數與值。

  18. 選擇提交以建立堆疊。

    選擇提交 後,系統會自動在您的 Git 儲存庫中建立提取請求。您必須將此提取請求合併到 Git 儲存庫中,才能建立堆疊。建立堆疊後, CloudFormation 監控您的 Git 儲存庫以進行變更。

從 Git 儲存庫更新堆疊

若要更新堆疊,請直接變更範本檔案或 Git 儲存庫中的堆疊部署檔案。將變更遞交至受監控分支後, CloudFormation 會自動更新堆疊。如果您使用提取請求,則在更新堆疊之前,系統會自動在您的 Git 儲存庫中建立提取請求。您必須將此提取請求合併到您的 Git 儲存庫中,才能更新堆疊。

在 CloudFormation 主控台中,您可以選取堆疊,然後選擇 Git 同步索引標籤,以檢視堆疊和同步事件狀態的相關資訊。如需詳細資訊,請參閱Git 同步狀態儀表板