終止支援通知：將於 2026 年 10 月 7 日 AWS 結束對 的支援 AWS Proton。2026 年 10 月 7 日之後，您將無法再存取 AWS Proton 主控台或 AWS Proton 資源。您部署的基礎設施將保持不變。如需詳細資訊，請參閱[AWS Proton 服務棄用和遷移指南](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)。

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

# 範本同步組態
<a name="ag-template-sync-configs"></a>

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

## 將遞交推送至同步範本套件
<a name="ag-commits"></a>

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

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

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

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

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

## 同步服務範本
<a name="syncing-service-templates"></a>

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

檔案的完整路徑為 `{{service-template-name}}/{{major-version}}/.template-registration.yaml`。如需詳細資訊，請參閱[同步服務範本](create-template-sync.md#create-template-sync-service-templates)。

## 範本同步組態考量事項
<a name="sync-considerations"></a>

檢閱下列使用範本同步組態的考量事項。
+ 儲存庫不得超過 250 MB。
+ 若要設定範本同步，請先將儲存庫連結至 AWS Proton。如需詳細資訊，請參閱[建立儲存庫的連結](ag-create-repo.md)。
+ 從同步範本建立新範本版本時，該版本處於 `DRAFT` 狀態。
+ 如果下列其中一項為 true，則會建立新的範本次要版本：
  + 範本套件內容與上次同步範本次要版本的內容不同。
  + 已刪除上次同步的範本次要版本。
+ 同步無法暫停。
+ 新的次要或主要版本都會自動同步。
+ 範本同步組態無法建立新的頂層範本。
+ 您無法從具有範本同步組態的多個儲存庫同步至一個範本。
+ 您無法使用標籤而非分支。
+ 當您[建立服務範本](template-create.md#svc-template-v1)時，您可以指定相容的環境範本。
+ 您可以建立環境範本，並將其新增為相同遞交中服務範本的相容環境。
+ 同步至單一範本主要版本會一次執行一個。在同步期間，如果偵測到任何新的遞交，則會在作用中同步結束時批次處理並套用。同步到不同的範本主要版本會平行進行。
+ 如果您變更範本要同步的分支，則舊分支中任何持續的同步都會先完成。然後，同步會從新的分支開始。
+ 如果您變更範本同步的儲存庫，舊儲存庫中任何進行中的同步都可能會失敗或執行至完成。這取決於他們所在的同步階段。

如需詳細資訊，請參閱[https://docs.aws.amazon.com/proton/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/proton/latest/APIReference/Welcome.html)。

**Topics**
+ [將遞交推送至同步範本套件](#ag-commits)
+ [同步服務範本](#syncing-service-templates)
+ [範本同步組態考量事項](#sync-considerations)
+ [建立範本同步組態](create-template-sync.md)
+ [檢視範本同步組態詳細資訊](view-template-sync.md)
+ [編輯範本同步組態](update-template-sync.md)
+ [刪除範本同步組態](delete-template-sync.md)