範本同步設定 - AWS Proton
推送提交同步服務範本範本同步的考量

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

範本同步設定

瞭解如何設定範本，讓AWS Proton從位於您定義的已註冊 git 存儲庫中的模板包進行同步。當提交推送到您的存儲庫時，AWS Proton檢查存放庫範本服務包的變更。如果偵測到範本包變更，則會建立範本的新次要或主要版本 (如果該版本尚未存在)。AWS Proton目前支援GitHub,GitHub企業版，以及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狀態。

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

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

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

  • 同步無法暫停。

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

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

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

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

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

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

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

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

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

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

主題