模板同步配置 - AWS Proton

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

模板同步配置

了解如何配置模板以允许从位于您定义的已注册 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 参考