終止支援通知：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 使用 連線來：**
+ 當您的儲存庫原始程式碼進行新的遞交時，請啟用服務管道。
+ 在 基礎設施上提出提取請求做為程式碼儲存庫。
+ 每當遞交推送到變更其中一個範本的範本儲存庫時，如果版本尚未存在，請建立新的範本次要或主要版本。
您可以使用 CodeConnections 連線至 Bitbucket、GitHub、GitHub Enterprise 和 GitHub Enterprise Server 儲存庫。如需詳細資訊，請參閱*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)。然後，若要開始使用 AWS CLI 搭配 AWS Proton，請參閱 [開始使用 AWS CLI](ag-getting-started-cli.md)。