範本同步設定

了解如何配置模板以允許從您定義的已註冊 git 存儲庫中的模板包進行 AWS Proton 同步。將提交推送至您的儲存庫時， AWS Proton 檢查儲存庫範本服務包是否有變更。如果偵測到範本套件組合變更，則會建立範本的新次要或主要版本 (如果該版本尚未存在)。 AWS Proton 目前支援 GitHub「 GitHub 企業 BitBucket」和。

將提交推送到同步的模板包

當您將提交推送到由其中一個模板跟踪的分支時，請 AWS Proton 克隆您的存儲庫並確定需要同步的模板。它會掃描目錄中的檔案，以尋找符合慣例的目錄{template-name}/{major-version}/。

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

在每次同步到特定範本時， 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狀態。

• 如果下列條件之一成立，則會建立範本的新次要版本：

  • 範本服務包內容與上次同步處理範本次要版本的內容不同。

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

• 同步無法暫停。

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

• 範本同步設定無法建立新的頂層範本。

• 您無法使用模板同步配置從多個存儲庫同步到一個模板。

• 您不能使用標籤而不是分支。

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

• 您可以建立環境範本，並在同一次提交中將其新增為服務範本的相容環境。

• 同步到單個模板主要版本一次運行一個。在同步過程中，如果檢測到任何新的提交，它們將在活動同步結束時進行批處理並應用。同步到不同的模板主要版本 parallel 發生。

• 如果您更改了模板正在同步的分支，則從舊分支進行的任何正在進行的同步都會首先完成。然後同步從新分支開始。

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

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

主題

• 建立範本同步設定
• 檢視範本同步設定詳情
• 編輯範本同步設定
• 刪除範本同步設定