教學課程:建立使用 AWS AppConfig 做為部署提供者的管道 - AWS CodePipeline

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

教學課程:建立使用 AWS AppConfig 做為部署提供者的管道

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

重要

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

必要條件

開始之前,您必須完成下列操作:

步驟 1:建立您的 AWS AppConfig 資源

在本節中,您可以建立下列資源:

  • 應用程式 in AWS AppConfig 是為您的客戶提供功能的邏輯程式碼單位。

  • 環境 in AWS AppConfig 是 AppConfig 目標的邏輯部署群組,例如 Beta 版或生產環境中的應用程式。

  • 組態描述檔是一組會影響應用程式行為的設定。組態描述檔可讓 AWS AppConfig 在其儲存的位置存取您的組態。

  • (選用) AppConfig 中的 AWS 部署策略會定義組態部署的行為,例如在部署期間的任何指定時間,應接收新部署組態的用戶端百分比。

建立應用程式、環境、組態設定檔和部署策略
  1. 登入 AWS Management Console。

  2. 使用下列主題中的步驟,在 AppConfig 中 AWS 建立您的資源。

步驟 2:將檔案上傳至 S3 來源儲存貯體

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

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

    Hello World!
  2. 使用下列步驟來壓縮和上傳您的組態檔案。

壓縮和上傳來源檔案
  1. 使用 檔案建立 .zip 檔案,並命名 .zip 檔案 configuration-files.zip。例如,您的 .zip 檔案可以使用下列結構:

    . └── appconfig-configurations └── MyConfigurations ├── us-east-1 │ └── configuration.json └── us-west-2 └── configuration.json
  2. 在儲存貯體的 Amazon S3 主控台中,選擇上傳,然後依照指示上傳您的 .zip 檔案。

步驟 3:建立管道

在本節中,您可以採取下列動作建立管道:

  • 具有 Amazon S3 動作的來源階段,其中來源成品是您組態的檔案。

  • 具有 AppConfig 部署動作的部署階段。

使用精靈建立管道
  1. 登入 AWS Management Console ,並在 https://http://console.aws.amazon.com/codesuite/codepipeline/home 開啟 CodePipeline 主控台。

  2. Welcome (歡迎) 頁面、Getting started (入門) 頁面、或者 Pipelines (管道) 頁面上,選擇 Create pipeline (建立管道)

  3. 步驟 1:選擇建立選項頁面的建立選項下,選擇建置自訂管道選項。選擇 Next (下一步)

  4. 步驟 2:選擇管道設定,在管道名稱中輸入 MyAppConfigPipeline

  5. CodePipeline 提供 V1 和 V2 類型的管道,其特性和價格有所不同。V2 類型是您可以在 主控台中選擇的唯一類型。如需詳細資訊,請參閱管道類型。如需 CodePipeline 定價的相關資訊,請參閱定價

  6. 服務角色中,選擇新服務角色,以允許 CodePipeline 在 IAM 中建立服務角色。

  7. Advanced settings (進階設定) 下的設定保留為預設值,然後選擇 Next (下一步)

  8. 步驟 3:新增來源階段中,在來源提供者中選擇 Amazon S3。在儲存貯體中,選擇 S3 來源儲存貯體的名稱。

    S3 物件金鑰中,輸入 .zip 檔案的名稱:configuration-files.zip

    選擇 Next (下一步)

  9. 步驟 4:新增建置階段,選擇略過建置階段,然後再次選擇略過以接受警告訊息。

    選擇 Next (下一步)

  10. 步驟 5:新增測試階段中,選擇略過測試階段,然後再次選擇略過以接受警告訊息。

    選擇 Next (下一步)

  11. 步驟 6:新增部署階段

    1. 部署提供者中,選擇 AWS AppConfig

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

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

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

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

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

    7. 選擇 Next (下一步)

  12. 步驟 7:檢閱中,檢閱資訊,然後選擇建立管道

步驟 4:變更任何來源檔案並驗證部署

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