本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
範本同步組態
了解如何設定範本,以從您定義的已註冊 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 參考。