终止支持通知：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 Proton APIs，请确认你已经安装了它。如果尚未安装，请参阅[设置 AWS CLI](#ag-setting-up-cli)。
**AWS Proton 具体配置：**
+ **创建和管理模板：**
+ 如果您使用[模板同步配置](ag-template-sync-configs.md)，请建立一个 [AWS CodeStar 连接](#setting-up-vcontrol)。
+ 否则，请设置一个 [Amazon S3 存储桶](#setting-up-bucket)。
+ **预置基础设施：**
+ 对于[自托管式预置](ag-works-prov-methods.md#ag-works-prov-methods-self)，您必须建立一个 [AWS CodeStar 连接](#setting-up-vcontrol)。
+ **（可选）预置管道：**
+ 对于[AWS托管配置](ag-works-prov-methods.md#ag-works-prov-methods-direct)和[CodeBuild基于管理的配置](ag-works-prov-methods.md#ag-works-prov-methods-codebuild)，请设置[管道角色](#setting-up-pr-role)。
+ 对于[自托管式预置](ag-works-prov-methods.md#ag-works-prov-methods-self)，设置一个[管道存储库](#setting-up-pr-repo)。
有关预置方法的更多信息，请参阅[AWS托管配置的工作原理](ag-works-prov-methods.md#ag-works-prov-methods-direct)。
## 设置 Amazon S3 存储桶
要设置 S3 存储桶，请按照[创建您的第一个 S3 存储桶](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)中的说明设置一个 S3 存储桶。将您的输入放在 AWS Proton 可以检索它们的存储桶 AWS Proton 中。这些输入称为模板捆绑包。您可以在本指南的其他章节中了解模板捆绑包的更多信息。
## 设置 AWS CodeStar 连接
要 AWS Proton 连接到存储库，您需要创建一个 AWS CodeStar 连接，以便在第三方源代码存储库上进行新提交时激活管道。
**AWS Proton 将连接用于：**
+ 在存储库源代码上进行新提交时激活服务管道。
+ 对基础设施即代码存储库发出拉取请求。
+ 每次将提交推送到模板存储库以更改某个模板时，都会创建新的模板次要或主要版本（如果该版本尚不存在）。
您可以使用连接到 Bitbucket GitHub、、 GitHub 企业和 GitHub 企业服务器存储库。 CodeConnections有关更多信息，请参阅《AWS CodePipeline 用户指南》**中的 [CodeConnections](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodestarConnectionSource.html)。
**建立 CodeStar 连接。**
1. 打开 [AWS Proton 管理控制台](https://console.aws.amazon.com//proton/)。
1. 在导航窗格中，选择**设置**，然后选择**存储库连接**以转到**开发人员工具****设置**中的**连接**页面。该页面显示一个连接列表。
1. 选择**创建连接**，并按照说明进行操作。
## 设置账户 CI/CD 渠道设置
AWS Proton 可以预置 CI/CD 管道，用于将应用程序代码部署到您的服务实例中。管道配置所需的 AWS Proton 设置取决于您为管道选择的配置方法。
### AWS-托管和 CodeBuild基于管理的配置-设置管道角色
借助[AWS托管配置](ag-works-prov-methods.md#ag-works-prov-methods-direct)和[CodeBuild 配置](ag-works-prov-methods.md#ag-works-prov-methods-codebuild)， AWS Proton 可以为您配置管道。因此， AWS Proton 需要一个为置备管道提供权限的服务角色。这两种预置方法都使用自己的服务角色。这些角色在所有 AWS Proton 服务管道中共享，您只需在账户设置中对其进行一次配置。
**使用控制台创建管道服务角色**
1. 打开 [AWS Proton 管理控制台](https://console.aws.amazon.com//proton/)。
1. 在导航窗格中，选择**设置**，然后选择**账户设置**。
1. 在 ** CI/CD “账户设置”** 页面中，选择 “**配置**”。
1. 请执行以下操作之一：
+ **为你 AWS Proton 创建一个管道服务角色**
[启用 AWS托管式管道预置] 在**配置账户设置**页面上的 **AWS托管式预置管道角色**部分中：
1. 选择**新服务角色**。
1. 输入角色的名称，例如 **myProtonPipelineServiceRole**。
1. 选中该复选框以同意在您的账户中创建具有管理权限的 AWS Proton 角色。
[启用 CodeBuild基于管道的置备] 在 “**配置账户设置**” 页面的 “**CodeBuild管道角色**” 部分，选择 “**现有服务角色**”，然后选择您在**CloudFormation 管道角色部分创建的服务角色**。或者，如果您没有分配 CloudFormation 管道角色，请重复前三个步骤来创建新的服务角色。
+ **选择现有的管道服务角色**
[启用 AWS托管式管道预置] 在**配置账户设置**页面上的 **AWS托管式预置管道角色**部分中，选择**现有的服务角色**，然后在您的 AWS 账户中选择一个服务角色。
[启用管道 CodeBuild 配置] 在 “**配置账户设置”** 页面的 “**CodeBuild管道配置角色**” 部分，选择 “**现有服务角色**”，然后在您的 AWS 账户中选择一个服务角色。
1. 选择**保存更改**。
将在**账户设置**页面上显示您的新管道服务角色。
### 自托管式预置 - 设置管道存储库
使用[自我管理配置](ag-works-prov-methods.md#ag-works-prov-methods-self)， AWS Proton 将拉取请求 (PR) 发送到您已设置的配置存储库，您的自动化代码负责配置管道。因此， AWS Proton 不需要服务角色来配置管道。相反，它需要使用注册的预置存储库。存储库中的自动化代码必须担任相应的角色，以提供预置管道的权限。
**使用控制台注册管道预置存储库**
1. 如果您尚未创建 CI/CD 管道配置存储库，请创建一个。有关自托管式预置中的管道的更多信息，请参阅[自托管式预置的工作方式](ag-works-prov-methods.md#ag-works-prov-methods-self)。
1. 在导航窗格中，选择**设置**，然后选择**账户设置**。
1. 在 ** CI/CD “账户设置”** 页面中，选择 “**配置**”。
1. 在**配置账户设置**页面上的 **CI/CD 管道存储库**部分中：
1. 选择**新存储库**，然后选择存储库提供商之一。
1. 要进行**CodeStar 连接**，请选择其中一个连接。
**注意**
如果您尚未连接到相关的存储库提供商帐户，请选择**添加新 CodeStar连接**，完成连接创建过程，然后选择**CodeStar连接**菜单旁边的刷新按钮。您现在应该可以在菜单中选择您的新连接。
1. 对于**存储库名称**，选择您的管道预置存储库。下拉菜单显示提供商账户中的存储库列表。
1. 对于**分支名称**，选择存储库分支之一。
1. 选择**保存更改**。
将在**账户设置**页面上显示您的管道存储库。
## 设置 AWS CLI
要使用进行 AWS CLI AWS Proton API 调用，请确认您已安装最新版本的 AWS CLI。有关更多信息，请参阅《AWS Command Line Interface 用户指南》**中的 [AWS CLI入门](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)。然后，要开始使用 with AWS CLI AWS Proton，请参阅[开始使用 AWS CLI](ag-getting-started-cli.md)。