本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
教學課程:建立使用 AWS AppConfig 做為部署提供者的管道
在本教學課程中,您會設定管道,以使用 AWS AppConfig 做為部署階段的部署動作提供者,持續交付組態檔案。
重要
在建立管道的過程中,CodePipeline 將使用客戶提供的 S3 成品儲存貯體來製作成品。(這與用於 S3 來源動作的儲存貯體不同。) 如果 S3 成品儲存貯體位於與管道帳戶不同的帳戶中,請確定 S3 成品儲存貯體屬於 AWS 帳戶 安全且可靠的 。
必要條件
開始之前,您必須完成下列操作:
-
此範例會為您的管道使用 S3 來源。建立或使用已啟用版本控制的 Amazon S3 儲存貯體。遵循步驟 1:為您的應用程式建立 S3 來源儲存貯體中的說明,建立 S3 儲存貯體。
步驟 1:建立您的 AWS AppConfig 資源
在本節中,您可以建立下列資源:
-
應用程式 in AWS AppConfig 是為您的客戶提供功能的邏輯程式碼單位。
-
環境 in AWS AppConfig 是 AppConfig 目標的邏輯部署群組,例如 Beta 版或生產環境中的應用程式。
-
組態描述檔是一組會影響應用程式行為的設定。組態描述檔可讓 AWS AppConfig 在其儲存的位置存取您的組態。
-
(選用) AppConfig 中的 AWS 部署策略會定義組態部署的行為,例如在部署期間的任何指定時間,應接收新部署組態的用戶端百分比。
建立應用程式、環境、組態設定檔和部署策略
-
登入 AWS Management Console。
-
使用下列主題中的步驟,在 AppConfig 中 AWS 建立您的資源。
-
建立環境。
-
(選用) 選擇預先定義的部署策略或建立您自己的部署策略。
步驟 2:將檔案上傳至 S3 來源儲存貯體
在本節中,建立您的組態檔案。然後將來源檔案壓縮並推送至管道用於來源階段的儲存貯體。
建立組態檔案
-
為每個區域中的每個組態建立
configuration.json
檔案。包含下列內容:Hello World!
-
使用下列步驟來壓縮和上傳您的組態檔案。
壓縮和上傳來源檔案
-
使用 檔案建立 .zip 檔案,並命名 .zip 檔案
configuration-files.zip
。例如,您的 .zip 檔案可以使用下列結構:. └── appconfig-configurations └── MyConfigurations ├── us-east-1 │ └── configuration.json └── us-west-2 └── configuration.json
-
在儲存貯體的 Amazon S3 主控台中,選擇上傳,然後依照指示上傳您的 .zip 檔案。
步驟 3:建立管道
在本節中,您可以採取下列動作建立管道:
-
具有 Amazon S3 動作的來源階段,其中來源成品是您組態的檔案。
-
具有 AppConfig 部署動作的部署階段。
使用精靈建立管道
登入 AWS Management Console ,並在 https://http://console.aws.amazon.com/codesuite/codepipeline/home
開啟 CodePipeline 主控台。 -
在 Welcome (歡迎) 頁面、Getting started (入門) 頁面、或者 Pipelines (管道) 頁面上,選擇 Create pipeline (建立管道)。
-
在步驟 1:選擇建立選項頁面的建立選項下,選擇建置自訂管道選項。選擇 Next (下一步)。
-
在步驟 2:選擇管道設定,在管道名稱中輸入
MyAppConfigPipeline
。 -
CodePipeline 提供 V1 和 V2 類型的管道,其特性和價格有所不同。V2 類型是您可以在 主控台中選擇的唯一類型。如需詳細資訊,請參閱管道類型。如需 CodePipeline 定價的相關資訊,請參閱定價
。 -
在服務角色中,選擇新服務角色,以允許 CodePipeline 在 IAM 中建立服務角色。
-
將 Advanced settings (進階設定) 下的設定保留為預設值,然後選擇 Next (下一步)。
-
在步驟 3:新增來源階段中,在來源提供者中選擇 Amazon S3。在儲存貯體中,選擇 S3 來源儲存貯體的名稱。
在 S3 物件金鑰中,輸入 .zip 檔案的名稱:
configuration-files.zip
。選擇 Next (下一步)。
-
在步驟 4:新增建置階段,選擇略過建置階段,然後再次選擇略過以接受警告訊息。
選擇 Next (下一步)。
-
在步驟 5:新增測試階段中,選擇略過測試階段,然後再次選擇略過以接受警告訊息。
選擇 Next (下一步)。
-
在步驟 6:新增部署階段:
-
在部署提供者中,選擇 AWS AppConfig。
-
在應用程式中,選擇您在 AWS AppConfig 中建立的應用程式名稱。欄位會顯示您應用程式的 ID。
-
在環境中,選擇您在 AWS AppConfig 中建立的環境名稱。欄位會顯示您環境的 ID。
-
在組態設定檔中,選擇您在 AWS AppConfig 中建立的組態設定檔名稱。欄位會顯示組態設定檔的 ID。
-
在部署策略中,選擇部署策略的名稱。這可以是您在 AppConfig 中建立的部署策略,也可以是您在 AppConfig 中選擇的預先定義部署策略。欄位會顯示部署策略的 ID。
-
在輸入成品組態路徑中,輸入檔案路徑。請確定輸入成品組態路徑符合 S3 儲存貯體 .zip 檔案中的目錄結構。在此範例中,輸入下列檔案路徑:
appconfig-configurations/MyConfigurations/us-west-2/configuration.json
。 -
選擇 Next (下一步)。
-
-
在步驟 7:檢閱中,檢閱資訊,然後選擇建立管道。
步驟 4:變更任何來源檔案並驗證部署
變更來源檔案,並將變更上傳至儲存貯體。這會觸發您的管道執行。檢視 版本,確認您的組態是否可用。