チュートリアル: シンプルなパイプラインを作成する (S3 バケットの場合) - CodePipeline

チュートリアル: シンプルなパイプラインを作成する (S3 バケットの場合)

パイプラインを最も簡単に作成するには、AWS CodePipeline コンソールで [パイプラインの作成] ウィザードを使用します。

このチュートリアルでは、バージョニングされた S3 バケットおよび CodeDeploy を使用して、サンプルアプリケーションをリリースする 2 ステージのパイプラインを作成します。

注記

Amazon S3 がパイプラインのソースプロバイダーである場合、ソースファイルを 1 つの .zip に圧縮し、その .zip をソースバケットにアップロードすることができます。解凍されたファイルを 1 つアップロードすることもできます。ただし、.zip ファイルを想定するダウンストリームアクションは失敗します。

このシンプルなパイプラインを作成したら、別のステージを追加し、ステージ間の移行を無効化または有効化します。

開始する前に、「CodePipeline の使用開始」の前提条件を完了する必要があります。

ステップ 1: アプリケーションの S3 バケットを作成する

ソースファイルまたはアプリケーションをバージョニングされた場所に保存します。このチュートリアルでは、サンプルアプリケーションの S3 バケットを作成し、そのバケットでバージョニングを有効にします。バージョニングを有効化したら、サンプルアプリケーションをそのバケットにコピーします。

S3 バケットを作成するには

  1. AWS マネジメントコンソールにサインインし、Amazon S3 コンソール (https://console.aws.amazon.com/s3/) を開きます。

  2. [バケットを作成する] を選択します。

  3. [バケット名] に、バケットの名前 (awscodepipeline-demobucket-example-date など) を入力します。

    注記

    Amazon S3 内のすべてのバケット名は一意になる必要があるため、例に示す名前ではなく、独自のバケット名を使用してください。例に示す名前は、日付を追加するだけでも変更できます。このチュートリアルの残りの部分で必要となるため、この名前を書き留めます。

    [リージョン] で、パイプラインを作成するリージョン ([米国西部 (オレゴン)] など) を選択し、[バケットの作成] を選択します。

  4. バケットが作成されると、成功バナーが表示されます。[Go to bucket details] を選択します。

  5. [プロパティ] タブで、[バージョニング] を選択します。[バージョニングの有効化] を選択し、[保存] を選択します。

    バージョニングが有効になったら、Amazon S3 によって各オブジェクトのすべてのバージョンがバケットに保存されます。

  6. [アクセス許可] タブは、デフォルト設定のままにします。S3 バケットおよびオブジェクトへのアクセス許可に関する詳細については、「ポリシーでのアクセス許可の指定」を参照してください。

  7. 次に、サンプルをダウンロードし、ローカルコンピュータのフォルダまたはディレクトリに保存します。

    1. 次のいずれかを選択します。Windows Server インスタンスについて、このチュートリアルのステップに従う場合は、SampleApp_Windows.zip を選択します。

      • CodeDeploy を使用して Amazon Linux インスタンスにデプロイする場合は、サンプルアプリケーションを SampleApp_Linux.zip からダウンロードします。

      • CodeDeploy を使用して Windows Server インスタンスにデプロイする場合は、サンプルアプリケーションを SampleApp_Windows.zip からダウンロードします。

    2. 圧縮 (zip) ファイルをダウンロードします。このファイルを解凍しないでください。

  8. バケットの Amazon S3 コンソールで、ファイルをアップロードします。「」を参照してください。

    1. [Upload] を選択します。

    2. ファイルをドラッグアンドドロップするか、[ファイルを追加] を選択してファイルを参照します。

    3. [Upload] を選択します。

ステップ 2: Amazon EC2 Windows インスタンスを作成して CodeDeploy エージェントをインストールする

注記

このチュートリアルでは、Amazon EC2 Windows インスタンスを作成するサンプル手順を示します。Amazon EC2 Linux インスタンスを作成するサンプルステップについては、「ステップ 3: EC2 Linux インスタンスを作成して CodeDeploy エージェントをインストールする」を参照してください。作成するインスタンスの数の入力を求められたら、2 つのインスタンスを指定します。

このステップでは、サンプルアプリケーションをデプロイする Windows Server Amazon EC2 インスタンスを作成します。このプロセスの一環として、CodeDeploy エージェントをインスタンスにインストールします。CodeDeploy エージェントは、CodeDeploy デプロイメントでインスタンスを使用できるようにするソフトウェアパッケージです。

インスタンスロールを作成するには

  1. IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。

  2. コンソールダッシュボードで [ロール] を選択します。

  3. [ロールの作成] を選択します。

  4. [信頼されたエンティティの種類を選択] で、[AWS のサービス] を選択します。[ユースケースの選択] で [EC2] を選択し、[次の手順: アクセス許可] を選択します。

  5. [AmazonEC2RoleforAWSCodeDeploy] という名前のポリシーを検索して選択し、[次へ: タグ] を選択します。

  6. [次へ: レビュー] を選択します。ロールの名前を入力します (例: EC2InstanceRole)。

    注記

    次のステップのロール名をメモしておきます。このロールは、インスタンスの作成時に選択します。

    [Create role (ロールの作成)] を選択します。

インスタンスを起動するには

  1. https://console.aws.amazon.com/ec2/ で Amazon EC2 コンソールを開きます。

  2. コンソールダッシュボードから [インスタンスの作成] を選択し、ポップアップに表示されるオプションから [インスタンスの作成] を選択します。

  3. [ステップ 1: Amazon マシンイメージ (AMI)] ページで [Microsoft Windows Server 2019 Base] オプションを見つけ、[選択] を選択します(この AMI は "Free tier eligible" とラベル付けされており、リストの先頭にあります)。

  4. [ステップ 2: インスタンスタイプの選択] ページで、インスタンスのハードウェア構成として無料利用枠対象の t2.micro タイプを選択してから、[次の手順: インスタンスの詳細の設定] を選択します。

  5. [ステップ 3: インスタンスの詳細の設定] ページで、以下の操作を行います。

    • [インスタンス数] に「2」と入力します。

    • [Auto-assign Public IP (パブリック IP の自動割り当て)] で、[Enable (有効化)] を選択します。

    • [IAM ロール] で、前の手順で作成した IAM ロール (例: EC2InstanceRole) を選択します。

    • [高度な詳細] を展開し、[ユーザーデータ] で [テキストで] を選択した状態で、次のように入力します。

      <powershell> New-Item -Path c:\temp -ItemType "directory" -Force powershell.exe -Command Read-S3Object -BucketName bucket-name/latest -Key codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi Start-Process -Wait -FilePath c:\temp\codedeploy-agent.msi -WindowStyle Hidden </powershell>

      bucket-name は、リージョンの CodeDeploy リソースキットファイルが含まれている S3 バケットの名前です。たとえば、米国西部 (オレゴン) リージョンの場合、bucket-nameaws-codedeploy-us-west-2 に置き換えます。バケット名のリストについては、「リージョン別のリソースキットバケット名」を参照してください。

      このコードは、作成時にインスタンスに CodeDeploy エージェントをインストールします。このスクリプトは Windows インスタンス専用です。

    • [ステップ 3: インスタンスの詳細の設定] ページの残りの項目はそのままにします。[Next: Add Storage (次の手順: ストレージの追加) ] を選択します。

  6. [Step 4: Add Storage (ステップ 4: ストレージの追加)] ページは変更せず、[Next: Add Tags (次の手順: タグの追加)] を選択します。

  7. [タグの追加] ページで、[タグの追加] を選択します。[キー] フィールドに「Name」と入力し、[] フィールドに「MyCodePipelineDemo」と入力して、[次の手順: セキュリティグループの設定] を選択します。

    重要

    [キー] ボックスと [] ボックスでは、大文字と小文字が区別されます。

  8. [Configure Security Group (セキュリティグループの設定)] ページで、パブリックインスタンスのエンドポイントにアクセスできるようにポート 80 に通信を許可します。

  9. [Review and Launch] を選択します。

  10. [Review Instance Launch] ページで、[Launch] を選択します。キーペアの入力を求められたら、[Proceed without a key pair (キーペアなしで続行)] を選択します。

    注記

    このチュートリアルでは、キーペアを使用せずに続行できます。SSH を使用してインスタンスに接続するには、キーペアを作成または使用します。

    準備ができたら、確認チェックボックスをオンにし、[インスタンスの起動] を選択します。

  11. [View Instances] を選択して確認ページを閉じ、コンソールに戻ります。

  12. [インスタンス] ページで、起動のステータスを表示できます。インスタンスを起動した直後のステータスは pending です。インスタンスを起動した後は、状態が running に変わり、パブリック DNS 名を受け取ります([パブリック DNS] 列が表示されていない場合は、[表示/非表示] アイコンを選択してから、[パブリック DNS] を選択します)。

  13. インスタンスに接続可能になるまでには、数分かかることがあります。インスタンスのステータスチェックが成功していることを確認します。この情報は、[ステータスチェック] 列で確認できます。

ステップ 3: CodeDeploy でアプリケーションを作成する

CodeDeploy では、アプリケーションは、識別子です。デプロイするコードで指定し、名前形式で表します。CodeDeploy では、この名前を使用して、デプロイ時に、リビジョン、デプロイ設定、デプロイグループが正しい組み合わせで参照されるようにします。このチュートリアルの後半でパイプラインを作成する際、このステップで作成した CodeDeploy アプリケーションの名前を選択します。

CodeDeploy でアプリケーションを作成するには

  1. CodeDeploy コンソール (https://console.aws.amazon.com/codedeploy) を開きます。

  2. [アプリケーション] ページが表示されない場合は、AWS CodeDeploy メニューで [アプリケーション] を選択します。

  3. [Create application] を選択します。

  4. [アプリケーション名] で、MyDemoApplication を入力します。

  5. [コンピューティングプラットフォーム] で [EC2/オンプレミス] を選択します。

  6. [Create application] を選択します。

CodeDeploy でデプロイグループを作成するには

  1. アプリケーションが表示されるページで、[Create deployment group (デプロイグループの作成)] を選択します。

  2. [デプロイグループ名] に「MyDemoDeploymentGroup」と入力します。

  3. [サービスロール] で、「CodeDeploy のサービスロールを作成する」で説明されている信頼およびアクセス許可を少なくとも持つ、AWS CodeDeploy を信頼するサービスロールを選択します。サービスロール ARN を取得するには、「サービスロール ARN の取得 (コンソール)」を参照してください。

  4. [デプロイタイプ] で、[インプレース] を選択します。

  5. [環境設定] で、[Amazon EC2 インスタンス] を選択します。[キー] フィールドで [Name] を選択し、[ ] フィールドに「MyCodePipelineDemo」と入力します。

    重要

    [Name (名前)] キーには、EC2 インスタンスの作成時にインスタンスに割り当てたのと同じ値を選択する必要があります。インスタンスに MyCodePipelineDemo 以外のタグを付けた場合は、ここでもそのタグを使用してください。

  6. [デプロイ設定] で、[CodeDeployDefault.OneAtaTime] を選択します。

  7. [Load Balancer (ロードバランサー)] で、[Enable load balancing (ロードバランシングの有効化)] をオフにします。この例では、ロードバランサーを設定したり、ターゲットグループを選択したりする必要はありません。

  8. [詳細設定] セクションでは、既定のままにしておきます。

  9. [Create deployment group] を選択します。

ステップ 4: CodePipeline で最初のパイプラインを作成する

チュートリアルのこの部分では、パイプラインを作成します。サンプルは、パイプラインを通して自動的に実行されます。

CodePipeline 自動リリースプロセスを作成するには

  1. AWS マネジメントコンソール にサインインし、CodePipeline コンソール (http://console.aws.amazon.com/codesuite/codepipeline/home) を開きます。

  2. [ようこそ] ページ、[Getting started (開始方法)] ページ、または [パイプライン] ページで、[パイプラインの作成] を選択します。

  3. [Step 1: Choose pipeline settings (ステップ 1: パイプラインの設定の選択)] の [パイプライン名] で、MyFirstPipeline と入力します。

    注記

    パイプラインに別の名前を選択した場合は、このチュートリアルの残りの部分で MyFirstPipeline の代わりにその名前を使用してください。パイプラインを作成したら、その名前を変更することはできません。パイプラインの名前にはいくつかの制限がある場合があります。詳細については、「AWS CodePipeline のクォータ」を参照してください。

  4. [Service role (サービスロール)] で、次のいずれかの操作を行います。

    • [New service role (新しいサービスロール)] を選択して、CodePipeline に IAM での新しいサービスロールの作成を許可します。[ロール名] では、ロールとポリシーの名前はいずれもデフォルトで AWSCodePipelineServiceRole-region-pipeline_name という形式になります。たとえば、このチュートリアル用に作成されたサービスロールは AWSCodePipelineServiceRole-eu-west-2-MyFirstPipeline です。

    • IAM で作成済みのサービスロールを使用するには、[Existing service role (既存のサービスロール)] を選択します。[ロール名] で、リストからサービスロールを選択します。

  5. [詳細設定] をデフォルト設定のままにし、[次へ] を選択します。

  6. [Step 2: Add source stage (ステップ 2: ソースステージの追加)] の [ソースプロバイダ] で、[Amazon S3] を選択します。[バケット] に、「ステップ 1: アプリケーションの S3 バケットを作成する」で作成した S3 バケットの名前を入力します。S3 オブジェクトキーで、ファイルパスの有無にかかわらずオブジェクトキーを入力し、必ずファイル拡張子を含めます。たとえば、SampleApp_Windows.zip の場合、次の例に示すように、サンプルファイル名を入力します。

    SampleApp_Windows.zip

    [Next step] を選択します。

    [Change detection options] で、デフォルト値のままにします。これにより、CodePipeline は Amazon CloudWatch Events を使用して、ソースバケットの変更を検出できます。

    [次へ] を選択します。

  7. [Step 3: Add build stage (ステップ 3: ビルドステージの追加)] で、[Skip build stage (ビルドステージのスキップ)] を選択し、もう一度 [スキップ] を選択して警告メッセージを受け入れます。[次へ] を選択します。

  8. [Step 4: Add deploy stage (ステップ 4: デプロイステージを追加する)] の [デプロイプロバイダ] で、[AWS CodeDeploy] を選択します。[リージョン] フィールドは、デフォルトで、パイプラインと同じ AWS リージョンになります。[アプリケーション名] に MyDemoApplication を入力するか、更新ボタンを選択してリストからそのアプリケーション名を選択します。[デプロイグループ] に「MyDemoDeploymentGroup」と入力するか、リストからデプロイグループを選択して [次へ] を選択します。

    注記

    「Deploy」は、[ステップ 4: デプロイステージの追加] ステップで作成したステージにデフォルトで付けられる名前です。パイプラインの最初のステージに付けられる「Source」という名前も同様です。

  9. [ステップ 5: 確認] で情報を確認し、[パイプラインの作成] を選択します。

  10. パイプラインの実行が開始されます。CodePipeline サンプルがウェブページを CodeDeploy デプロイの各 Amazon EC2 インスタンスにデプロイしている間、進行状況と成功/失敗メッセージを表示できます。

これで、 シンプルなパイプラインが CodePipeline に作成されました。パイプラインには 2 つのステージがあります。

  • [Source] という名前のソースステージ。このステージでは、S3 バケットに保存したバージョニング済みのサンプルアプリケーションの変更を検出し、これらの変更をパイプライン内にプルします。

  • [Deploy] ステージ。このステージでは、CodeDeploy を使用して、これらの変更を EC2 インスタンスにデプロイします。

ここで、結果を確認します。

パイプラインが正常に実行されたことを確認するには

  1. パイプラインの最初の進行状況を表示します。各ステージのステータスは、[まだ実行はありません] から [進行中] に変わり、その後、[Succeeded (成功)] または [Failed (失敗)] のいずれかに変わります。パイプラインの最初の実行は数分で完了します。

  2. アクションのステータスに [Succeeded (成功)] が表示されたら、[Deploy (デプロイ)] ステージのステータス領域で [Details (詳細)] を選択します。これにより、AWS CodeDeploy コンソールが開きます。

  3. [デプロイグループ] タブの [Deployment lifecycle events (デプロイライフサイクルイベント)] の下で、インスタンス ID を選択します。これにより、EC2 コンソールが開きます。

  4. [Description] タブの [Public DNS] でアドレスをコピーし、ウェブブラウザのアドレスバーに貼り付けます。S3 バケットにアップロードしたサンプルアプリケーションのインデックスページを表示します。

    次のページは、S3 バケットにアップロードしたサンプルアプリケーションです。

ステージ、アクション、パイプラインの仕組みの詳細については、「CodePipeline 概念 」を参照してください。

(オプション) ステップ 5: 別のステージをパイプラインに追加する

次に、別のステージをパイプラインに追加し、CodeDeploy を使用してステージングサーバーから本稼働サーバーにデプロイできるようにします。まず、別のデプロイグループを CodeDeploy の CodePipelineDemoApplication に作成します。その後、このデプロイグループを使用するアクションを含むステージを追加します。別のステージを追加するには、CodePipeline コンソールまたは AWS CLI を使用して、JSON ファイルのパイプライン構造を取得し、手動で編集します。その後、update-pipeline コマンドを実行して、パイプラインの変更を更新します。

2番目のデプロイグループを CodeDeploy に作成する

注記

チュートリアルのこの部分では、2 番目のデプロイグループを作成しますが、以前と同じ Amazon EC2 インスタンスにデプロイします。このウォークスルーは、デモンストレーションのみを目的としています。CodePipeline でエラーを表示する方法を示すために、意図的に失敗するように設計されています。

CodeDeploy で 2 番目のデプロイグループを作成するには

  1. CodeDeploy コンソール (https://console.aws.amazon.com/codedeploy) を開きます。

  2. [アプリケーション] を選択し、アプリケーションのリストで [MyDemoApplication] を選択します。

  3. [デプロイグループ] タブを選択して、[Create deployment group (デプロイグループの作成)] を選びます。

  4. [Create deployment group (デプロイグループの作成)] ページの [Deployment group name (デプロイグループ名)] に、2 番目のデプロイグループの名前 (たとえば、CodePipelineProductionFleet) を入力します。

  5. [サービスロール] で、最初のデプロイに使用したのと同じ CodeDeploy サービスロール (CodePipeline サービスロールではない) を選択します。

  6. [デプロイタイプ] で、[インプレース] を選択します。

  7. [環境設定] で、[Amazon EC2 インスタンス] を選択します。[キー] ボックスの [名前] を選択し、[] ボックスで、リストから [MyCodePipelineDemo ] を選択します。[デプロイ設定] のデフォルト設定をそのままにします。

  8. [デプロイ設定] で、[CodeDeployDefault.OneAtaTime] を選択します。

  9. [Load Balancer (ロードバランサー)] で、[Enable load balancing (ロードバランシングの有効化)] をオフにします。

  10. [Create deployment group] を選択します。

パイプラインの他のステージとしてデプロイグループを追加する

別のデプロイグループが追加されたため、このデプロイグループを使用するステージを追加して、前に使用したのと同じ EC2 インスタンスにデプロイできます。CodePipeline コンソールまたは AWS CLI を使用してこのステージを追加できます。

3 番目のステージの追加 (コンソールの場合)

CodePipeline コンソールを使用して、新しいデプロイグループを使用する新しいステージを追加できます。このデプロイグループのデプロイ先は、すでに使用した EC2 インスタンスであるため、このステージのデプロイアクションは失敗します。

  1. AWS マネジメントコンソール にサインインし、CodePipeline コンソール (http://console.aws.amazon.com/codesuite/codepipeline/home) を開きます。

  2. [名前] で、作成したパイプラインの名前 MyFirstPipeline を選択します。

  3. パイプライン詳細ページで、[編集] を選択します。

  4. [Edit (編集)] ページで [+ Add stage (+ ステージの追加)] を選択して、[Deploy] ステージの直後にステージを追加します。

  5. [Add stage (ステージの追加)] で、[Stage name (ステージ名)] に、Production​ を入力します。[Add stage (ステージの追加)] を選択します。

  6. 新しいステージで、[+ Add action group (+ アクショングループの追加)] を選択します。

  7. [アクションの編集] の、[アクション名] に、Deploy-Second-Deployment を入力します。​[Action provider (アクションプロバイダ)] の [デプロイ] で、[AWS CodeDeploy] を選択します。

  8. CodeDeploy セクションの [アプリケーション名] で、パイプラインの作成時と同様に、ドロップダウンリストから [MyDemoApplication] を選択します。[デプロイグループ] で、先ほど作成したデプロイグループ CodePipelineProductionFleet を選択します。[入力アーティファクト] で、ソースアクションから入力アーティファクトを選択します。[Save] を選択します。

  9. [Edit (編集)] ページで [Save (保存)] を選択します。[パイプラインの変更を保存] で、[Save (保存)] を選択します。

  10. 新しいステージがパイプラインに追加されていますが、パイプラインの別の実行をトリガーした変更がないため、[まだ実行はありません] というステータスが表示されます。最新のリビジョンを手動で再度実行して、編集されたパイプラインの実行度を確認する必要があります。パイプラインの詳細ページで、[変更のリリース] を選択し、プロンプトが表示されたら [リリース] を選択します。これにより、ソースアクションで指定した各ソース場所における最新のリビジョンがパイプラインで実行されます。

    または、AWS CLI を使用してパイプラインを再実行するには、ローカル Linux, macOS, or Unix マシンのターミナルから、またはローカル Windows マシンのコマンドプロンプトから、パイプラインの名前を指定して start-pipeline-execution コマンドを実行します。これにより、ソースバケット内のアプリケーションの 2 回目の実行がパイプラインで実行されます。

    aws codepipeline start-pipeline-execution --name MyFirstPipeline

    このコマンドは pipelineExecutionId オブジェクトを返します。

  11. CodePipeline コンソールに戻り、パイプラインのリストで [MyFirstPipeline] を選択してビューページを開きます。

    パイプラインには、3 つのステージがあり、それらの各ステージのアーティファクトの状態が示されます。パイプラインがすべてのステージを実行するまでに最大 5 分かかることがあります。前回と同じように、最初の 2 つのステージではデプロイが成功しますが、[Production (本番稼働用)] ステージでは [Deploy-Second-Deployment (2 番目のデプロイをデプロイ)] アクションが失敗したことが示されます。

  12. [Deploy-Second-Deployment] アクションで、[Details] を選択します。CodeDeploy デプロイのページにリダイレクトされます。この場合、最初のインスタンスグループがすべての EC2 インスタンスにデプロイされ、2 番目のデプロイグループ用のインスタンスが残っていないために失敗しています。

    注記

    この失敗は、パイプラインのステージにエラーがある場合にどうなるかを示すために、意図的に起こしたものです。

3 番目のステージの追加 (CLI の場合)

AWS CLI を使用してステージをパイプラインに追加するのは、コンソールを使用するよりも複雑ですが、パイプラインの構造が見やすくなります。

パイプラインの 3 番目のステージを作成するには

  1. ローカル Linux, macOS, or Unix マシンのターミナルセッションを開くか、ローカル Windows マシンのコマンドプロンプトを開き、get-pipeline コマンドを実行して、先ほど作成したパイプラインの構造を表示します。MyFirstPipeline に対して、以下のコマンドを入力します。

    aws codepipeline get-pipeline --name "MyFirstPipeline"

    このコマンドは、MyFirstPipeline の構造を返します。出力の最初の部分は以下のようになります。

    { "pipeline": { "roleArn": "arn:aws:iam::80398EXAMPLE:role/AWS-CodePipeline-Service", "stages": [ ...

    出力の最後のパートにはパイプラインのメタデータが含まれており、次のようになります。

    ... ], "artifactStore": { "type": "S3" "location": "codepipeline-us-east-2-250656481468", }, "name": "MyFirstPipeline", "version": 4 }, "metadata": { "pipelineArn": "arn:aws:codepipeline:us-east-2:80398EXAMPLE:MyFirstPipeline", "updated": 1501626591.112, "created": 1501626591.112 } }
  2. この構造をコピーしてプレーンテキストエディタに貼り付け、ファイルを pipeline.json として保存します。便利なように、aws codepipeline コマンドを実行する同じディレクトリにこのファイルを保存します。

    注記

    以下のように、get-pipeline コマンドを使用して、パイプ処理で JSON をファイルに渡すことができます。

    aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json
  3. [Deploy (デプロイ)] ステージセクションをコピーし、最初の 2 つのステージの後に貼り付けます。これはデプロイステージであるため、[Deploy (デプロイ)] ステージと同様に、3 番目のステージのテンプレートとして使用します。

  4. ステージの名前とデプロイグループの詳細を変更します。

    以下の例では、[Deploy (デプロイ)] ステージの後に pipeline.json ファイルに追加する JSON を示しています。強調表示された要素を新しい値で編集します。[Deploy (デプロイ)] と [Production (本番稼働用)] のステージ定義を区切るには、必ずカンマを使用してください。

    , { "name": "Production", "actions": [ { "inputArtifacts": [ { "name": "MyApp" } ], "name": "Deploy-Second-Deployment", "actionTypeId": { "category": "Deploy", "owner": "AWS", "version": "1", "provider": "CodeDeploy" }, "outputArtifacts": [], "configuration": { "ApplicationName": "CodePipelineDemoApplication", "DeploymentGroupName": "CodePipelineProductionFleet" }, "runOrder": 1 } ] }
  5. get-pipeline コマンドを使用して取得したパイプライン構造を使用している場合、JSON ファイルから metadata 行を削除する必要があります。それ以外の場合は、update-pipeline コマンドで使用することはできません。"metadata": { } 行と、"created""pipelineARN""updated" フィールドを削除します。

    たとえば、構造から以下の行を削除します。

    "metadata": { "pipelineArn": "arn:aws:codepipeline:region:account-ID:pipeline-name", "created": "date", "updated": "date" }

    ファイルを保存します。

  6. 以下のようにパイプライン JSON ファイルを指定して、update-pipeline コマンドを実行します。

    aws codepipeline update-pipeline --cli-input-json file://pipeline.json

    このコマンドは、更新されたパイプラインの構造全体を返します。

    重要

    ファイル名の前に必ず file:// を含めてください。このコマンドでは必須です。

  7. パイプラインの名前を指定して、start-pipeline-execution コマンドを実行します。これにより、ソースバケット内のアプリケーションの 2 回目の実行がパイプラインで実行されます。

    aws codepipeline start-pipeline-execution --name MyFirstPipeline

    このコマンドは pipelineExecutionId オブジェクトを返します。

  8. CodePipeline コンソールを開き、パイプラインのリストから [MyFirstPipeline] を選択します。

    パイプラインには、3 つのステージがあり、それらの各ステージのアーティファクトの状態が示されます。パイプラインがすべてのステージを実行するまでに最大 5 分かかることがあります。前回と同じように、最初の 2 つのステージではデプロイが成功しますが、[Production] ステージでは [Deploy-Second-Deployment] アクションが失敗したことが示されます。

  9. [Deploy-Second-Deployment] アクションで、[Details] を選択すると、その失敗の詳細が表示されます。CodeDeploy デプロイの詳細ページにリダイレクトされます。この場合、最初のインスタンスグループがすべての EC2 インスタンスにデプロイされ、2 番目のデプロイグループ用のインスタンスが残っていないために失敗しています。

    注記

    この失敗は、パイプラインのステージにエラーがある場合にどうなるかを示すために、意図的に起こしたものです。

(オプション) ステップ 6: CodePipeline のステージ間の移行を有効化または無効化する

パイプラインのステージ間の移行を有効化または無効化することができます。ステージ間の移行を無効にすると、ステージ間の移行を手動で制御できるようになります。たとえば、パイプラインの最初の 2 つのステージを実行するが、本番環境にデプロイする準備ができるまで、または問題のトラブルシューティング中か、そのステージが失敗するまで、3 番目のステージへの移行を無効化します。

CodePipeline パイプラインのステージ間の移行を無効/有効にするには

  1. CodePipeline コンソールを開き、パイプラインのリストから [MyFirstPipeline] を選択します。

  2. パイプラインの詳細ページで、2 番目のステージ ([Deploy (デプロイ)]) と前のセクションで追加した 3 番目のステージ ([Production (本番稼働用)]) との間の [移行を無効にする] ボタンを選択します。

  3. [移行を無効にする] で、ステージ間の移行を無効にする理由を入力し、[無効化] を選択します。

    ステージ間の矢印では、アイコンと色の変化、および、[移行を有効にする] ボタンが表示されます。

  4. サンプルをもう一度 S3 バケットにアップロードします。バケットのバージョニングが有効になっているため、この変更によってパイプラインが開始します。詳細については、サンプルアプリケーションのアップロード を参照してください。

  5. パイプラインの詳細ページに戻り、ステージの状態を監視します。パイプラインビューでは、最初の 2 つのステージで進行状況が示されて成功に変わりますが、3 番目のステージで変更はありません。このプロセスには数分かかることがあります。

  6. 2 つのステージの間の [移行を有効にする] ボタンを選択して、遷移を有効にします。[Enable transition] ダイアログボックスで、[Enable] を選択します。3 番目のステージの実行は数分で開始し、パイプラインの最初の 2 つのステージですでに実行されているアーティファクトの処理を試みます。

    注記

    この 3 番目のステージを成功させるには、遷移を有効にする前に CodePipelineProductionFleet デプロイグループを編集し、アプリケーションのデプロイ先として別の一連の EC2 インスタンスを指定します。そのための方法の詳細については、「デプロイグループの設定を変更する」を参照してください。追加の EC2 インスタンスを作成すると、追加のコストが発生する場合があります。

ステップ 7: リソースをクリーンアップする

チュートリアル: 4 ステージのパイプラインを作成する 用にこのチュートリアルで作成したリソースの一部を使用することができます。たとえば、CodeDeploy アプリケーションおよびデプロイメントは再利用できます。クラウド上の完全マネージド型のビルドサービスである、CodeBuild などのプロバイダを使用してビルドアクションを設定できます。また、Jenkins など、ビルドサーバーまたはシステムと備えたプロバイダを使用するビルドアクションを設定することもできます。

ただし、これらのチュートリアルの完了後、これらのリソースに対する継続利用料金が発生しないよう、使用したパイプラインおよびリソースを削除する必要があります。まずパイプラインを削除し、次に CodeDeploy アプリケーションおよびそれに関連付けられている EC2 インスタンスを削除します。最後に S3 バケットを削除します。

このチュートリアルで使用されているリソースをクリーンアップするには

  1. CodePipeline リソースをクリーンアップするには、「AWS CodePipeline でパイプラインを削除する」の手順に従います。

  2. CodeDeploy リソースをクリーンアップするには、「リソースをクリーンアップするには (コンソール)」の手順に従います。

  3. S3 バケットを削除するには、「S3 バケットを削除する/空にする方法」の手順に従います。追加のパイプラインを作成しない場合は、パイプラインのアーティファクトの保存用に作成した S3 バケットを削除します。このバケットの詳細については、「CodePipeline 概念 」を参照してください。