本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
模板同步配置
了解如何配置模板以允许从位于您定义的已注册 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 参考。