模板同步配置

了解如何配置模板以允许从位于您定义的已注册 git 存储库中的模板包进行 AWS Proton 同步。在将提交推送到您的存储库时， 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 参考。

主题

• 创建模板同步配置
• 查看模板同步配置详细信息
• 编辑模板同步配置
• 删除模板同步配置