本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 教學課程：建立使用 AWS AppConfig 做為部署提供者的管道
<a name="tutorials-AppConfig"></a>

在本教學課程中，您會設定管道，以使用 AWS AppConfig 做為部署階段中的部署動作提供者，持續交付組態檔案。

**重要**  
在建立管道的過程中，CodePipeline 將使用客戶提供的 S3 成品儲存貯體來製作成品。（這與用於 S3 來源動作的 儲存貯體不同。) 如果 S3 成品儲存貯體位於與管道帳戶不同的帳戶中，請確定 S3 成品儲存貯體由 所擁有 AWS 帳戶 ，安全且可靠。

**Topics**
+ [先決條件](#tutorials-AppConfig-prereq)
+ [步驟 1：建立 your AWS AppConfig 資源](#tutorials-AppConfig-application)
+ [步驟 2：將檔案上傳至 S3 來源儲存貯體](#tutorials-AppConfig-bucket)
+ [步驟 3：建立管道](#tutorials-AppConfig-pipeline)
+ [步驟 4：變更任何來源檔案並驗證部署](#tutorials-AppConfig-verify)

## 先決條件
<a name="tutorials-AppConfig-prereq"></a>

開始之前，您必須完成以下項目：
+ 此範例使用管道的 S3 來源。建立或使用已啟用版本控制的 Amazon S3 儲存貯體。遵循[步驟 1：為您的應用程式建立 S3 來源儲存貯體](tutorials-simple-s3.md#s3-create-s3-bucket)中的說明，建立 S3 儲存貯體。

## 步驟 1：建立 your AWS AppConfig 資源
<a name="tutorials-AppConfig-application"></a>

在本節中，您會建立下列資源：
+ *應用程式* in AWS AppConfig 是為您的客戶提供功能的邏輯程式碼單位。
+ *環境* in AWS AppConfig 是 AppConfig 目標的邏輯部署群組，例如 Beta 版或生產環境中的應用程式。
+ *組態描述*檔是一組會影響應用程式行為的設定。組態設定檔可讓 AWS AppConfig 在其儲存的位置存取您的組態。
+ （選用） AppConfig 中的 AWS *部署策略*會定義組態部署的行為，例如在部署期間的任何指定時間，應接收新部署組態的用戶端百分比。

**建立應用程式、環境、組態設定檔和部署策略**

1. 登入 AWS 管理主控台。

1. 使用下列主題中的步驟，在 AppConfig 中 AWS 建立您的 資源。
   + [建立應用程式](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-application.html)。
   + [建立環境](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-environment.html)。
   + [建立 AWS CodePipeline 組態設定檔](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-configuration-and-profile.html)。
   + （選用） [選擇預先定義的部署策略或建立您自己的](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-deployment-strategy.html)部署策略。

## 步驟 2：將檔案上傳至 S3 來源儲存貯體
<a name="tutorials-AppConfig-bucket"></a>

在本節中，建立您的組態檔案。然後將來源檔案壓縮並推送至管道用於來源階段的儲存貯體。

**建立組態檔案**

1. 為每個區域中的每個組態建立`configuration.json`檔案。包含下列內容：

   ```
   Hello World!
   ```

1. 使用下列步驟壓縮和上傳您的組態檔案。

**壓縮和上傳來源檔案**

1. 使用 檔案建立 .zip 檔案，並將 .zip 檔案命名為 `configuration-files.zip`。例如，您的 .zip 檔案可以使用下列結構：

   ```
   .
   └── appconfig-configurations
       └── MyConfigurations
           ├── us-east-1
           │   └── configuration.json
           └── us-west-2
               └── configuration.json
   ```

1. 在儲存貯體的 Amazon S3 主控台中，選擇**上傳**，然後依照指示上傳 .zip 檔案。

## 步驟 3：建立管道
<a name="tutorials-AppConfig-pipeline"></a>

在本節中，您可以採取下列動作建立管道：
+ 具有 Amazon S3 動作的來源階段，其中來源成品是您組態的檔案。
+ 具有 AppConfig 部署動作的部署階段。

**使用精靈建立管道**

1. 登入 AWS 管理主控台 並開啟 CodePipeline 主控台，網址為 https：//[http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Welcome (歡迎)** 頁面、**Getting started (入門)** 頁面、或者 **Pipelines (管道)** 頁面上，選擇 **Create pipeline (建立管道)**。

1. 在**步驟 1：選擇建立選項**頁面的**建立選項**下，選擇**建置自訂管道**選項。選擇**下一步**。

1. 在**步驟 2：選擇管道設定**中，在**管道名稱**中輸入 **MyAppConfigPipeline**。

1. CodePipeline 提供 V1 和 V2 類型的管道，其特性和價格有所不同。V2 類型是您可以在 主控台中選擇的唯一類型。如需詳細資訊，請參閱[管道類型](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel)。如需 CodePipeline 定價的資訊，請參閱 [定價](https://aws.amazon.com/codepipeline/pricing/)。

1. 在**服務角色**中，選擇**新服務角色**，以允許 CodePipeline 在 IAM 中建立服務角色。

1. 將 **Advanced settings (進階設定)** 下的設定保留為預設值，然後選擇 **Next (下一步)**。

1. 在**步驟 3：新增來源階段**的**來源提供者**中，選擇 **Amazon S3**。在**儲存貯**體中，選擇 S3 來源儲存貯體的名稱。

   在 **S3 物件金鑰**中，輸入 .zip 檔案的名稱：`configuration-files.zip`。

   選擇**下一步**。

1. 在**步驟 4：新增建置階段**中，選擇**略過建置階段**，然後再次選擇**略過**以接受警告訊息。

   選擇**下一步**。

1. 在**步驟 5：新增測試階段**中，選擇**略過測試階段**，然後再次選擇**略過**以接受警告訊息。

   選擇**下一步**。

1. 在**步驟 6：新增部署階段**：

   1. 在**部署提供者**中，選擇 **AWS AppConfig**。

   1. 在**應用程式中**，選擇您在 AWS AppConfig 中建立的應用程式名稱。欄位會顯示您應用程式的 ID。

   1. 在**環境中**，選擇您在 AWS AppConfig 中建立的環境名稱。欄位會顯示您環境的 ID。

   1. 在**組態設定檔**中，選擇您在 AWS AppConfig 中建立的組態設定檔名稱。欄位會顯示組態設定檔的 ID。

   1. 在**部署策略**中，選擇部署策略的名稱。這可以是您在 AppConfig 中建立的部署策略，也可以是您在 AppConfig 中選擇的預先定義部署策略。欄位會顯示部署策略的 ID。

   1. 在**輸入成品組態路徑**中，輸入檔案路徑。請確定您的輸入成品組態路徑符合 S3 儲存貯體 .zip 檔案中的目錄結構。在此範例中，輸入下列檔案路徑：`appconfig-configurations/MyConfigurations/us-west-2/configuration.json`。

   1. 選擇**下一步**。

1. 在**步驟 7：檢閱**中，檢閱資訊，然後選擇**建立管道**。

## 步驟 4：變更任何來源檔案並驗證部署
<a name="tutorials-AppConfig-verify"></a>

變更來源檔案，並將變更上傳至儲存貯體。這會觸發您的管道執行。檢視 版本，確認您的組態是否可用。