终止支持通知：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)。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 注册并发布模板 如以下各节所述 AWS Proton，您可以使用注册和发布环境和服务模板。 您可以使用控制台或创建模板的新版本 AWS CLI。 或者，您可以使用控制台或 AWS CLI 创建模板并为其[配置模板同步](ag-template-sync-configs.md)。此配置允许从位于您定义的已注册 git 存储库中的模板包进行 AWS Proton 同步。每次将提交推送到更改某个模板捆绑包的存储库时，都会创建新的模板次要或主要版本（如果该版本尚不存在）。要了解模板同步配置先决条件和要求的更多信息，请参阅[模板同步配置](ag-template-sync-configs.md)。 ## 注册和发布环境模板 您可以注册并发布以下类型的环境模板。 + 注册并发布 AWS Proton 用于部署和管理环境基础架构的*标准*环境模板。 + 注册并发布*客户托管*环境模板，该模板 AWS Proton 用于连接到您管理的现有预配置基础架构。 AWS Proton *不*管理您现有的预配置基础架构。 **重要** 作为管理员，请确保您的预配置和托管基础设施以及所有输出参数都与相关的*客户托管*环境模板兼容。 AWS Proton 无法代表你解释更改，因为这些更改对他们不可见 AWS Proton。不一致会导致失败。 您可以使用控制台或注册和发布环境模板。 AWS CLI ------ #### [ AWS 管理控制台 ] **使用控制台注册并发布新的环境模板。** 1. 在 [AWS Proton 控制台](https://console.aws.amazon.com//proton/)中，选择**环境模板**。 1. 选择**创建环境模板**。 1. 在**创建环境模板**页面上的**模板选项**部分中，选择两个可用的模板选项之一。 + **创建用于预置新环境的模板**。 + **创建模板以使用您管理的预置基础设施**。 1. 如果您选择**创建用于预置新环境的模板**，则在**模板捆绑包源**部分中选择三个可用的模板捆绑包源选项之一。要了解模板同步要求和先决条件的更多信息，请参阅[模板同步配置](ag-template-sync-configs.md)。 + **使用我们的示例模板捆绑包**。 + **使用自己的模板捆绑包**。 + **[从 Git 同步模板](ag-template-sync-configs.md)**。 1. **提供模板捆绑包的路径。** 1. 如果您选择了**使用我们的示例模板捆绑包**： 在**示例模板捆绑包**部分中，选择一个示例模板捆绑包。 1. 如果您选择了**从 Git 同步模板**，在**源代码**部分中： 1. 为您的模板同步配置选择存储库。 1. 输入要从中同步的存储库分支的名称。 1. （可选）输入目录名称以限制模板捆绑包搜索。 1. 否则，在 **S3 捆绑包位置**部分中，提供您的模板捆绑包的路径。 1. 在**模板详细信息**部分中。 1. 输入**模板名称**。 1. （可选）输入**模板显示名称**。 1. （可选）输入环境模板的**模板描述**。 1. （可选）选中**加密设置**部分中的**自定义加密设置 (高级)** 复选框以提供您自己的加密密钥。 1. （可选）在**标签**部分中，选择**添加新标签**，并输入键和值以创建一个客户托管标签。 1. 选择**创建环境模板**。 您现在位于一个新页面中，其中显示新环境模板的状态和详细信息。这些详细信息包括列表 AWS 和客户管理的标签。 AWS Proton 创建 AWS Proton 资源时会自动为您生成 AWS 托管标签。有关更多信息，请参阅 [AWS Proton 资源和标记](resources.md)。 1. 新环境模板的初始状态为**草稿**。您和具有 `proton:CreateEnvironment` 权限的其他人可以查看和访问该模板。执行下一步，以使该模板可供其他人使用。 1. 在**模板版本**部分中，选择刚创建的模板次要版本 (1.0) 左侧的单选按钮。或者，您可以在信息提醒中选择**发布**并跳过下一步。 1. 在**模板版本**部分中，选择**发布**。 1. 模板状态变为**已发布**。由于它是最新的模板版本，因此，它是**推荐**版本。 1. 在导航窗格中，选择**环境模板**以查看环境模板和详细信息列表。 **使用控制台注册新的环境模板主要版本和次要版本。** 有关更多信息，请参阅 [版本控制的模板](ag-template-versions.md)。 1. 在 [AWS Proton 控制台](https://console.aws.amazon.com//proton/)中，选择**环境模板**。 1. 在环境模板列表中，选择要创建主要或次要版本的环境模板的名称。 1. 在环境模板详细信息视图中，在**模板版本**部分中选择**创建新版本**。 1. 在**创建新环境模板版本**页面上的**模板捆绑包源**部分中，选择两个可用的模板捆绑包源选项之一。 + **使用我们的示例模板捆绑包**。 + **使用自己的模板捆绑包**。 1. 提供选定模板捆绑包的路径。 + 如果您选择了**使用我们的示例模板捆绑包**，请在**示例模板捆绑包**部分中选择一个示例模板捆绑包。 + 如果您选择了**使用自己的模板捆绑包**包，请在 **S3 捆绑包位置**部分中选择您的模板捆绑包的路径。 1. 在**模板详细信息**部分中。 1. （可选）输入**模板显示名称**。 1. （可选）输入服务模板的**模板描述**。 1. 在**模板详细信息**部分中，选择以下选项之一。 + 要创建次要版本，请将**选中可创建新的主要版本**复选框保留为空。 + 要创建主要版本，请选中**选中可创建新的主要版本**复选框。 1. 继续执行控制台步骤以创建新的次要版本或主要版本，然后选择**创建新版本**。 ------ #### [ AWS CLI ] **使用 CLI 注册并发布新的环境模板，如以下步骤中所示。** 1. 指定区域、名称、显示名称（可选）和描述（可选）以创建一个*标准* 或*客户托管* 环境模板。 1. 创建一个*标准* 环境模板。 运行以下命令： ``` $ aws proton create-environment-template \ --name "simple-env" \ --display-name "Fargate" \ --description "VPC with public access" ``` 响应： ``` { "environmentTemplate": { "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env", "createdAt": "2020-11-11T23:02:45.336000+00:00", "description": "VPC with public access", "displayName": "VPC", "lastModifiedAt": "2020-11-11T23:02:45.336000+00:00", "name": "simple-env" } } ``` 1. 添加值为 `CUSTOMER_MANAGED` 的 `provisioning` 参数以创建一个*客户托管* 环境模板。 运行以下命令： ``` $ aws proton create-environment-template \ --name "simple-env" \ --display-name "Fargate" \ --description "VPC with public access" \ --provisioning "CUSTOMER_MANAGED" ``` 响应： ``` { "environmentTemplate": { "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env", "createdAt": "2020-11-11T23:02:45.336000+00:00", "description": "VPC with public access", "displayName": "VPC", "lastModifiedAt": "2020-11-11T23:02:45.336000+00:00", "name": "simple-env", "provisioning": "CUSTOMER_MANAGED" } } ``` 1. **创建环境模板主要版本 1 的次要版本 0** 对于*标准* 和*客户托管* 环境模板，该步骤和其余步骤是相同的。 包括模板名称、主要版本以及包含环境模板捆绑包的 S3 存储桶的存储桶名称和密钥。 运行以下命令： ``` $ aws proton create-environment-template-version \ --template-name "simple-env" \ --description "Version 1" \ --source s3="{bucket=your_s3_bucket, key=your_s3_key}" ``` 响应： ``` { "environmentTemplateVersion": { "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env:1.0", "createdAt": "2020-11-11T23:02:47.763000+00:00", "description": "Version 1", "lastModifiedAt": "2020-11-11T23:02:47.763000+00:00", "majorVersion": "1", "minorVersion": "0", "status": "REGISTRATION_IN_PROGRESS", "templateName": "simple-env" } } ``` 1. 使用 get 命令检查注册状态。 运行以下命令： ``` $ aws proton get-environment-template-version \ --template-name "simple-env" \ --major-version "1" \ --minor-version "0" ``` 响应： ``` { "environment": { "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env:1.0", "createdAt": "2020-11-11T23:02:47.763000+00:00", "description": "Version 1", "lastModifiedAt": "2020-11-11T23:02:47.763000+00:00", "majorVersion": "1", "minorVersion": "0", "recommendedMinorVersion": "0", "schema": "schema:\n format:\n openapi: \"3.0.0\"\n environment_input_type: \"MyEnvironmentInputType\"\n types:\n MyEnvironmentInputType:\n type: object\n description: \"Input properties for my environment\"\n properties:\n my_sample_input:\n type: string\n description: \"This is a sample input\"\n default: \"hello world\"\n my_other_sample_input:\n type: string\n description: \"Another sample input\"\n required:\n - my_other_sample_input\n", "status": "DRAFT", "statusMessage": "", "templateName": "simple-env" } } ``` 1. 提供模板名称以及主要版本和次要版本，以发布环境模板主要版本 1 的次要版本 0。该版本是 `Recommended` 版本。 运行以下命令： ``` $ aws proton update-environment-template-version \ --template-name "simple-env" \ --major-version "1" \ --minor-version "0" \ --status "PUBLISHED" ``` 响应： ``` { "environmentTemplateVersion": { "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env:1.0", "createdAt": "2020-11-11T23:02:47.763000+00:00", "description": "Version 1", "lastModifiedAt": "2020-11-11T23:02:54.610000+00:00", "majorVersion": "1", "minorVersion": "0", "recommendedMinorVersion": "0", "schema": "schema:\n format:\n openapi: \"3.0.0\"\n environment_input_type: \"MyEnvironmentInputType\"\n types:\n MyEnvironmentInputType:\n type: object\n description: \"Input properties for my environment\"\n properties:\n my_sample_input:\n type: string\n description: \"This is a sample input\"\n default: \"hello world\"\n my_other_sample_input:\n type: string\n description: \"Another sample input\"\n required:\n - my_other_sample_input\n", "status": "PUBLISHED", "statusMessage": "", "templateName": "simple-env" } } ``` 使用创建新模板后 AWS CLI，您可以查看 AWS 和客户管理的标签列表。 AWS Proton 自动为您生成 AWS 托管标签。您也可以使用 AWS CLI修改和创建客户托管标签。有关更多信息，请参阅 [AWS Proton 资源和标记](resources.md)。 运行以下命令： ``` $ aws proton list-tags-for-resource \ --resource-arn "arn:aws:proton:region-id:123456789012:environment-template/simple-env" ``` ------ ## 注册和发布服务模板 在创建服务模板版本时，您可以指定兼容的环境模板列表。这样，在开发人员选择服务模板时，他们可以选择将其服务部署到哪个环境中。 在通过服务模板创建服务或发布服务模板之前，请确认环境是通过列出的兼容环境模板部署的。 如果将服务部署到通过删除的兼容环境模板构建的环境中，则*无法* 将该服务更新为新的主要版本。 要添加或删除服务模板版本的兼容环境模板，您可以为其创建新的主要版本。 您可以使用控制台或注册和发布服务模板。 AWS CLI ------ #### [ AWS 管理控制台 ] **使用控制台注册并发布新的服务模板。** 1. 在 [AWS Proton 控制台](https://console.aws.amazon.com//proton/)中，选择**服务模板**。 1. 选择**创建服务模板**。 1. 在**创建服务模板**页面上的**模板捆绑包源**部分中，选择可用的模板选项之一。 + **使用自己的模板捆绑包**。 + **从 Git 同步模板**。 1. **提供模板捆绑包的路径。** 1. 如果您选择了**从 Git 同步模板**，在**源代码存储库**部分中： 1. 为您的模板同步配置选择存储库。 1. 输入要从中同步的存储库分支的名称。 1. （可选）输入目录名称以限制模板捆绑包搜索。 1. 否则，在 **S3 捆绑包位置**部分中，提供您的模板捆绑包的路径。 1. 在**模板详细信息**部分中。 1. 输入**模板名称**。 1. （可选）输入**模板显示名称**。 1. （可选）输入服务模板的**模板描述**。 1. 在**兼容的环境模板**部分中，从兼容的环境模板列表中进行选择。 1. （可选）在**加密设置**部分中，选择**自定义加密设置 (高级)** 以提供您自己的加密密钥。 1. （可选）在**管道**部分中： 如果在您的服务模板中不包含服务管道定义，请取消选中页面底部的**管道 - 可选**复选框。在创建服务模板后，您*无法* 更改该设置。有关更多信息，请参阅 [模板捆绑包](ag-template-authoring.md#ag-template-bundles)。 1. （可选）在**支持的组件源**部分中，为**组件源**选择**直接定义**以允许将直接定义的组件附加到服务实例。 1. （可选）在**标签**部分中，选择**添加新标签**，并输入键和值以创建一个客户托管标签。 1. 选择**创建服务模板**。 您现在位于一个新页面中，其中显示新服务模板的状态和详细信息。这些详细信息包括列表 AWS 和客户管理的标签。 AWS Proton 创建 AWS Proton 资源时会自动为您生成 AWS 托管标签。有关更多信息，请参阅 [AWS Proton 资源和标记](resources.md)。 1. 新服务模板的初始状态为**草稿**。您和具有 `proton:CreateService` 权限的其他人可以查看和访问该模板。执行下一步，以使该模板可供其他人使用。 1. 在**模板版本**部分中，选择刚创建的模板次要版本 (1.0) 左侧的单选按钮。或者，您可以在信息提醒中选择**发布**并跳过下一步。 1. 在**模板版本**部分中，选择**发布**。 1. 模板状态变为**已发布**。由于它是最新的模板版本，因此，它是**推荐**版本。 1. 在导航窗格中，选择**服务模板**以查看服务模板和详细信息列表。 **使用控制台注册新的服务模板主要版本和次要版本。** 有关更多信息，请参阅 [版本控制的模板](ag-template-versions.md)。 1. 在 [AWS Proton 控制台](https://console.aws.amazon.com//proton/)中，选择**服务模板**。 1. 在服务模板列表中，选择要创建主要或次要版本的服务模板的名称。 1. 在服务模板详细信息视图中，在**模板版本**部分中选择**创建新版本**。 1. 在**创建新服务模板版本**页面上的**捆绑包源**部分中，选择**使用自己的模板捆绑包**。 1. 在 **S3 捆绑包位置**部分中，选择您的模板捆绑包的路径。 1. 在**模板详细信息**部分中。 1. （可选）输入**模板显示名称**。 1. （可选）输入服务模板的**模板描述**。 1. 在**模板详细信息**部分中，选择以下选项之一。 + 要创建次要版本，请将**选中可创建新的主要版本**复选框保留为空。 + 要创建主要版本，请选中**选中可创建新的主要版本**复选框。 1. 继续执行控制台步骤以创建新的次要版本或主要版本，然后选择**创建新版本**。 ------ #### [ AWS CLI ] 要创建用于部署服务并且没有服务管道的服务模板，请将 `--pipeline-provisioning "CUSTOMER_MANAGED"` 参数和值添加到 `create-service-template` 命令中。按照[模板捆绑包](ag-template-authoring.md#ag-template-bundles)创建和[服务模板捆绑包的架构要求](ag-schema.md#schema-req-svc)中所述，配置您的模板捆绑包。 **注意** 在创建服务模板后，您无法修改 `pipelineProvisioning`。 1. **使用 CLI 注册并发布一个新的服务模板（具有或没有服务管道），如以下步骤中所示。** 1. **使用 CLI 创建一个具有服务管道的服务模板。** 指定名称、显示名称（可选）和描述（可选）。 运行以下命令： ``` $ aws proton create-service-template \ --name "fargate-service" \ --display-name "Fargate" \ --description "Fargate-based Service" ``` 响应： ``` { "serviceTemplate": { "arn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service", "createdAt": "2020-11-11T23:02:55.551000+00:00", "description": "Fargate-based Service", "displayName": "Fargate", "lastModifiedAt": "2020-11-11T23:02:55.551000+00:00", "name": "fargate-service" } } ``` 1. **创建一个没有服务管道的服务模板。** 添加 `--pipeline-provisioning`。 运行以下命令： ``` $ aws proton create-service-template \ --name "fargate-service" \ --display-name "Fargate" \ --description "Fargate-based Service" \ --pipeline-provisioning "CUSTOMER_MANAGED" ``` 响应： ``` { "serviceTemplate": { "arn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service", "createdAt": "2020-11-11T23:02:55.551000+00:00", "description": "Fargate-based Service", "displayName": "Fargate", "lastModifiedAt": "2020-11-11T23:02:55.551000+00:00", "name": "fargate-service", "pipelineProvisioning": "CUSTOMER_MANAGED" } } ``` 1. **创建服务模板主要版本 1 的次要版本 0。** 包括模板名称、兼容的环境模板、主要版本以及包含服务模板捆绑包的 S3 存储桶的存储桶名称和密钥。 运行以下命令： ``` $ aws proton create-service-template-version \ --template-name "fargate-service" \ --description "Version 1" \ --source s3="{bucket=your_s3_bucket, key=your_s3_key}" \ --compatible-environment-templates '[{"templateName":"simple-env","majorVersion":"1"}]' ``` 响应： ``` { "serviceTemplateMinorVersion": { "arn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service:1.0", "compatibleEnvironmentTemplates": [ { "majorVersion": "1", "templateName": "simple-env" } ], "createdAt": "2020-11-11T23:02:57.912000+00:00", "description": "Version 1", "lastModifiedAt": "2020-11-11T23:02:57.912000+00:00", "majorVersion": "1", "minorVersion": "0", "status": "REGISTRATION_IN_PROGRESS", "templateName": "fargate-service" } } ``` 1. 使用 *get* 命令检查注册状态。 运行以下命令： ``` $ aws proton get-service-template-version \ --template-name "fargate-service" \ --major-version "1" \ --minor-version "0" ``` 响应： ``` { "serviceTemplateMinorVersion": { "arn": "arn:aws:proton:us-east-1:123456789012:service-template/fargate-service:1.0", "compatibleEnvironmentTemplates": [ { "majorVersion": "1", "templateName": "simple-env" } ], "createdAt": "2020-11-11T23:02:57.912000+00:00", "description": "Version 1", "lastModifiedAt": "2020-11-11T23:02:57.912000+00:00", "majorVersion": "1", "minorVersion": "0", "schema": "schema:\n format:\n openapi: \"3.0.0\"\n pipeline_input_type: \"MyPipelineInputType\"\n service_input_type: \"MyServiceInstanceInputType\"\n\n types:\n MyPipelineInputType:\n type: object\n description: \"Pipeline input properties\"\n required:\n - my_sample_pipeline_required_input\n properties:\n my_sample_pipeline_optional_input:\n type: string\n description: \"This is a sample input\"\n default: \"hello world\"\n my_sample_pipeline_required_input:\n type: string\n description: \"Another sample input\"\n\n MyServiceInstanceInputType:\n type: object\n description: \"Service instance input properties\"\n required:\n - my_sample_service_instance_required_input\n properties:\n my_sample_service_instance_optional_input:\n type: string\n description: \"This is a sample input\"\n default: \"hello world\"\n my_sample_service_instance_required_input:\n type: string\n description: \"Another sample input\"", "status": "DRAFT", "statusMessage": "", "templateName": "fargate-service" } } ``` 1. 使用 update 命令将状态更改为 `"PUBLISHED"` 以发布服务模板。 运行以下命令： ``` $ aws proton update-service-template-version \ --template-name "fargate-service" \ --description "Version 1" \ --major-version "1" \ --minor-version "0" \ --status "PUBLISHED" ``` 响应： ``` { "serviceTemplateVersion": { "arn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service:1.0", "compatibleEnvironmentTemplates": [ { "majorVersion": "1", "templateName": "simple-env" } ], "createdAt": "2020-11-11T23:02:57.912000+00:00", "description": "Version 1", "lastModifiedAt": "2020-11-11T23:02:57.912000+00:00", "majorVersion": "1", "minorVersion": "0", "recommendedMinorVersion": "0", "schema": "schema:\n format:\n openapi: \"3.0.0\"\n pipeline_input_type: \"MyPipelineInputType\"\n service_input_type: \"MyServiceInstanceInputType\"\n\n types:\n MyPipelineInputType:\n type: object\n description: \"Pipeline input properties\"\n required:\n - my_sample_pipeline_required_input\n properties:\n my_sample_pipeline_optional_input:\n type: string\n description: \"This is a sample input\"\n default: \"hello pipeline\"\n my_sample_pipeline_required_input:\n type: string\n description: \"Another sample input\"\n\n MyServiceInstanceInputType:\n type: object\n description: \"Service instance input properties\"\n required:\n - my_sample_service_instance_required_input\n properties:\n my_sample_service_instance_optional_input:\n type: string\n description: \"This is a sample input\"\n default: \"hello world\"\n my_sample_service_instance_required_input:\n type: string\n description: \"Another sample input\"\n", "status": "PUBLISHED", "statusMessage": "", "templateName": "fargate-service" } } ``` 1. 使用 get 命令检索服务模板详细信息数据，检查是否 AWS Proton 已发布 1.0 版本。 运行以下命令： ``` $ aws proton get-service-template-version \ --template-name "fargate-service" \ --major-version "1" \ --minor-version "0" ``` 响应： ``` { "serviceTemplateMinorVersion": { "arn": "arn:aws:proton:us-east-1:123456789012:service-template/fargate-service:1.0", "compatibleEnvironmentTemplates": [ { "majorVersion": "1", "templateName": "simple-env" } ], "createdAt": "2020-11-11T23:02:57.912000+00:00", "description": "Version 1", "lastModifiedAt": "2020-11-11T23:03:04.767000+00:00", "majorVersion": "1", "minorVersion": "0", "schema": "schema:\n format:\n openapi: \"3.0.0\"\n pipeline_input_type: \"MyPipelineInputType\"\n service_input_type: \"MyServiceInstanceInputType\"\n\n types:\n MyPipelineInputType:\n type: object\n description: \"Pipeline input properties\"\n required:\n - my_sample_pipeline_required_input\n properties:\n my_sample_pipeline_optional_input:\n type: string\n description: \"This is a sample input\"\n default: \"hello world\"\n my_sample_pipeline_required_input:\n type: string\n description: \"Another sample input\"\n\n MyServiceInstanceInputType:\n type: object\n description: \"Service instance input properties\"\n required:\n - my_sample_service_instance_required_input\n properties:\n my_sample_service_instance_optional_input:\n type: string\n description: \"This is a sample input\"\n default: \"hello world\"\n my_sample_service_instance_required_input:\n type: string\n description: \"Another sample input\"", "status": "PUBLISHED", "statusMessage": "", "templateName": "fargate-service" } } ``` ------