範本同步組態 - AWS Proton

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

範本同步組態

了解如何設定範本,以從您定義的已註冊 git 儲存庫中的範本套件進行 AWS Proton 同步。將遞交推送至儲存庫時, 會 AWS Proton 檢查儲存庫範本套件的變更。如果偵測到範本套件變更,則會建立其範本的新次要或主要版本,如果版本尚不存在。 AWS Proton 目前支援 GitHub、GitHub Enterprise 和 BitBucket。

將遞交推送至同步範本套件

當您將遞交推送至其中一個範本所追蹤的分支時, 會 AWS Proton 複製您的儲存庫,並決定需要同步哪些範本。它會掃描目錄中的檔案,以尋找符合 慣例的目錄{template-name}/{major-version}/

在 AWS Proton 確定哪些範本和主要版本與您的儲存庫和分支相關聯後,它會開始嘗試平行同步所有這些範本。

每次同步到特定範本時, AWS Proton 首先檢查範本目錄的內容自上次成功同步以來是否變更。如果內容未變更, AWS Proton 請略過註冊重複的套件。這可確保在範本套件的內容變更時建立新的範本次要版本。如果範本套件的內容已變更,則會向 註冊套件 AWS Proton。

註冊範本套件之後, 會 AWS Proton 監控註冊狀態,直到註冊完成為止。

在單一指定時間,特定範本次要和主要版本只能發生一次同步。同步進行期間可能已推送的任何遞交都會批次處理。批次遞交會在先前的同步嘗試完成後同步。

同步服務範本

AWS Proton 可以從 git 儲存庫同步環境和服務範本。若要同步您的服務範本,請將名為 的額外檔案新增至範本套件中的.template-registration.yaml每個主要版本目錄。此檔案包含在遞交之後為您建立服務範本版本時 AWS Proton 所需的其他詳細資訊:相容的環境支援的元件來源

檔案的完整路徑為 service-template-name/major-version/.template-registration.yaml。如需詳細資訊,請參閱同步服務範本

範本同步組態考量事項

檢閱下列使用範本同步組態的考量事項。

  • 儲存庫不得超過 250 MB。

  • 若要設定範本同步,請先將儲存庫連結至 AWS Proton。如需詳細資訊,請參閱建立儲存庫的連結

  • 從同步範本建立新範本版本時,該版本處於 DRAFT 狀態。

  • 如果下列其中一項為 true,則會建立新的範本次要版本:

    • 範本套件內容與上次同步範本次要版本的內容不同。

    • 已刪除上次同步的範本次要版本。

  • 同步無法暫停。

  • 新的次要或主要版本都會自動同步。

  • 範本同步組態無法建立新的頂層範本。

  • 您無法從具有範本同步組態的多個儲存庫同步至一個範本。

  • 您無法使用標籤而非分支。

  • 當您建立服務範本時,您可以指定相容的環境範本。

  • 您可以建立環境範本,並將其新增為相同遞交中服務範本的相容環境。

  • 同步至單一範本主要版本會一次執行一個。在同步期間,如果偵測到任何新的遞交,則會在作用中同步結束時批次處理並套用。同步到不同的範本主要版本會平行進行。

  • 如果您變更範本要同步的分支,則舊分支中任何進行中的同步都會先完成。然後,同步會從新的分支開始。

  • 如果您變更範本同步的儲存庫,舊儲存庫中任何進行中的同步可能會失敗或執行至完成。這取決於他們所在的同步階段。

如需詳細資訊,請參閱 AWS Proton 服務 API 參考