终止支持通知：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 企业版和 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` 状态。
+ 如果满足以下条件之一，则会创建新的模板次要版本：
  + 模板捆绑包内容与上次同步的模板次要版本内容不同。
  + 已删除上次同步的模板次要版本。
+ 无法暂停同步。
+ 新的次要版本或主要版本都是自动同步的。
+ 无法通过模板同步配置创建新的顶级模板。
+ 您无法使用模板同步配置从多个存储库同步到一个模板。
+ 您无法使用标签替代分支。
+ 在[创建服务模板](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)