チュートリアル: AWS AppConfig をデプロイプロバイダとして使用するパイプラインを作成します。
このチュートリアルでは、デプロイステージでデプロイアクションプロバイダとして AWS AppConfig を使用して設定ファイルを継続的に配信するパイプラインを設定します。
重要
パイプライン作成の一環として、CodePipeline は、ユーザーが指定した S3 アーティファクトバケットをアーティファクトとして使用します (これは S3 ソースアクションで使用するバケットとは異なります)。S3 アーティファクトバケットがパイプラインのアカウントとは異なるアカウントにある場合は、S3 アーティファクトバケットを所有している AWS アカウントが安全で信頼できることを確認してください。
トピック
前提条件
開始する前に、次を完了しておく必要があります。
-
この例では、パイプラインに S3 ソースを使用します。バージョニングが有効になっている Amazon S3 バケットを作成するか、使用します。「ステップ 1: アプリケーションの S3 バケットを作成する」の手順に従って、S3 バケットを作成します。
ステップ 1 : AWS AppConfig リソースを作成します。
このセクションでは、次のリソースを作成します。
-
AWS AppConfig の アプリケーション は、顧客に機能を提供するコードの論理単位です。
-
AWS AppConfig の 環境 は、beta環境または製造環境のアプリケーションなどの AppConfig ターゲットの論理的デプロイグループです。
-
設定プロファイル は、アプリケーションの動作に影響する設定のコレクションです。設定プロファイルは、保存場所の設定にアクセスする AWS AppConfig を有効にします。
-
(オプション)AWS AppConfig の デプロイメント戦略 は、デプロイメント中の任意の時点で、クライアントの何パーセントが新しいデプロイされた設定を受け取る必要があるかなど、設定デプロイメントの動作を定義します。
アプリケーション、環境、設定プロファイル、デプロイ戦略を作成します。
-
AWS Management Consoleにサインインします。
-
AWS AppConfig のリソースを作成するには、次のトピックのステップを使用します
ステップ 2:ファイルを S3 ソースバケットにアップロードします。
このセクションでは、設定ファイルを作成します。次に、パイプラインがソースステージに使用するバケットにソースファイルを zip してプッシュします。
設定ファイルを作成します。
-
各リージョンの設定ごとに
configuration.json
ファイルを作成します。次の内容を含めます。:Hello World!
-
次のステップを使用して、設定ファイルを zip してアップロードします。
ソースファイルを zip してアップロードします。
-
ファイルで .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 にサインインして、 CodePipeline コンソール https://console.aws.amazon.com/codesuite/codebuild/home
を開きます。 -
[ようこそ] ページ、[開始方法] ページ、または [パイプライン] ページで、[パイプラインの作成] を選択します。
-
[ステップ 1: 作成オプションを選択する] ページの [作成オプション] で、[カスタムパイプラインを構築する] オプションを選択します。[次へ] を選択します。
-
[ステップ 2: パイプラインの設定を選択する] ページで、[パイプライン名] に「
MyAppConfigPipeline
」と入力します。 -
CodePipeline は、特徴と料金が異なる V1 タイプと V2 タイプのパイプラインを提供しています。V2 タイプは、コンソールで選択できる唯一のタイプです。詳細については、「パイプラインタイプ」を参照してください。CodePipeline の料金については、コスト
を参照してください。 -
サービスロール で、新しいサービスロール を選択して、CodePipeline が IAM でサービスロールを作成できるようにします。
-
[詳細設定] をデフォルト設定のままにし、[次へ] を選択します。
-
[ステップ 3: ソースステージを追加する] の [ソースプロバイダー] で、[Amazon S3] を選択します。バケット で、S3 ソースバケットの名前を選択します。
S3 オブジェクトキー に、ZIP ファイル名に
configuration-files.zip
を入力します。[Next] を選択します。
-
[ステップ 4: ビルドステージを追加する] で、[ビルドステージをスキップ] を選択し、もう一度 [スキップ] を選択して警告メッセージを受け入れます。
[Next] を選択します。
-
[ステップ 5: デプロイステージを追加する] で、次の操作を行います。
-
[デプロイプロバイダー] で、[AWS AppConfig] を選択します。
-
アプリケーション で、AWS AppConfig で作成したアプリケーションの名前を選択します。フィールドにはアプリケーションの ID が表示されます。
-
環境 で、AWS AppConfig で作成した環境の名前を選択します。フィールドには環境の ID が表示されます。
-
設定プロファイルで、AWSAppConfig で作成した設定プロファイルの名前を選択します。このフィールドには、設定プロファイルの ID が表示されます。
-
デプロイ戦略 で、デプロイ戦略の名前を選択します。これは、AppConfig で作成したデプロイ戦略、または AppConfig の事前定義されたデプロイ戦略から選択したデプロイ戦略のいずれかです。このフィールドには、デプロイ戦略の ID が表示されます。
-
アーティファクト設定パスを入力 に、ファイルパスを入力します。入力アーティファクト設定パスが S3 バケット.zip ファイルのディレクトリ構造と一致していることを確認します。この例では、次のファイルパス :
appconfig-configurations/MyConfigurations/us-west-2/configuration.json
を入力します。 -
[Next] を選択します。
-
-
[ステップ 6: 確認] で情報を確認し、[パイプラインの作成] を選択します。
ステップ 4 : 任意のソースファイルに変更を加えてデプロイを確認します。
ソースファイルに変更を加え、変更をバケットにアップロードします。これにより、パイプラインの実行がトリガーされます。バージョンを表示して、設定が使用可能であることを確認します。