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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

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

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

注記

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

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

重要

この手順でパイプラインに追加するアクションの多くには、パイプラインを作成する前に作成する必要がある AWS リソースが含まれます。ソースアクションの AWS リソースは、パイプラインを作成する同じ AWS リージョンに作成する必要があります。たとえば、パイプラインを米国東部 (オハイオ) リージョンに作成する場合、CodeCommit リポジトリは米国東部 (オハイオ) リージョン内にあることが必要です。

パイプラインの作成時に、クロスリージョンアクションを追加できます。クロスリージョンアクションの AWS リソースは、アクションを実行する予定の同じ AWS リージョンに存在する必要があります。詳細については、「CodePipeline でクロスリージョンアクションを追加する」を参照してください。

開始する前に、「コードパイプラインの使用」の前提条件を完了する必要があります。

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

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

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

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

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

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

    注記

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

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

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

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

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

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

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

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

      • 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. という名前のポリシーを検索し、選択します。Amazonec2Roleforawscodeデプロイ[] を選択してから、[次へ: タグ

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

    注記

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

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

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

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

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

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

  4. リポジトリの []ステップ 2: インスタンスタイプの選択ページで、対象となる無料利用枠を選択します。t2.microインスタンスのハードウェア設定として、[] を選択します。その後、次へ: インスタンスの詳細の設定

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

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

    • [Auto-assign Public IP] で、[Enable] を選択します。

    • EclipseIAM ロール,前の手順で作成した 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: (次へ:)] を選択します ストレージの追加

  6. [] のままにするステップ 4: ストレージの追加ページは変更せず、[] を選択します。次へ: タグの追加

  7. [タグの追加] ページで、[タグの追加] を選択します。Enter名前()キーフィールドに [] と入力します。MyCodePipelineDemo()フィールドを選択し、次へ: セキュリティグループの設定

    重要

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

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

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

  10. [Review Instance Launch] ページで、[Launch] を選択します。Wkey pair 入力を求められた例] で、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. Eclipseアプリケーション名[] と入力します。MyDemoApplication

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

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

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

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

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

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

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

  5. [環境設定] で、[Amazon EC2 インスタンス] を選択します。選択名前()キーフィールド、およびフィールドに [] と入力します。MyCodePipelineDemo

    重要

    同じ値を選択するには、名前EC2 インスタンスに割り当てたキーsを作成したときそれら。インスタンスにタグを付けた場合s以外のものとMyCodePipelineDemoここでもその作業を使用してください。

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

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

  8. アドバンストセクションを開いて、[] のままにしておきます。。

  9. [Create deployment group (デプロイグループの作成)] を選択します。

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

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

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

  1. にサインインします。AWS Management Consoleを開き、CodePipeline コンソールをhttp://console.aws.amazon.com/codesuite/codepipeline/home

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

  3. Eclipseステップ 1: パイプラインの設定の選択, でパイプライン名[] と入力します。MyFirstPipeline

    注記

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

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

    • 選択新しいサービスロールCodePipeline が IAM での新しいサービスロールの作成を許可します。Eclipseロール名ロールとポリシーの名前はいずれもデフォルトでという形式になります。AWSCODEPIPELINEServicerole-リージョン-pipeline。たとえば、このチュートリアル用に作成されたサービスロールは次のとおりです。AWSCodePipelineServiceRole-eu-west-2-MyFirstPipeline.

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

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

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

    SampleApp_Windows.zip

    [Next step] を選択します。

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

    [Next (次へ)] を選択します。

  7. Eclipseステップ 3: ビルドステージの追加] で、ビルドステージのスキップ[] を選択して、警告メッセージを受け入れます。スキップをクリックします。[Next (次へ)] を選択します。

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

    注記

    Deploy という名前は、デフォルトでステップ 4: デプロイステージの追加ステップでは、Source はパイプラインの最初のステージに付けられる名前です。

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

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

おめでとうございます。CodePipelineでシンプルなパイプラインを作成しました。パイプラインには 2 つのステージがあります。

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

  • Aデプロイステージでは、CodeDeploy を使用してそれらの変更が EC2 インスタンスにデプロイされます。

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

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

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

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

  3. デプロイグループタブにあるデプロイライフサイクルイベント] で、、インスタンス ID を。これにより、EC2 コンソールが開きます。

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

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

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

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

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

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

注記

チュートリアルのこの部分では、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. Eclipseサービスロール[] で、最初のデプロイに使用したのと同じ 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 Management Consoleを開き、CodePipeline コンソールをhttp://console.aws.amazon.com/codesuite/codepipeline/home

  2. Eclipse名前[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、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、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. ステージの名前とデプロイグループの詳細を変更します。

    以下の例では、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 番目のデプロイグループ用のインスタンスが残っていないために失敗しています。

    注記

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

(オプション)STEP 6: CodePipelineでステージ間の遷移を無効/有効にする

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

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

  1. CodePipeline コンソールを開き、MyFirstPipelineパイプラインのリストから。

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

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

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

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

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

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

    注記

    この 3 番目のステージを成功させるには、遷移を有効にする前に CodePipelineProductionFleet デプロイグループを編集し、アプリケーションのデプロイ先として別の一連の EC2 インスタンスを指定します。これを行う方法については、」変更dエプロウGロップsセッティング。追加の EC2 インスタンスを作成すると、追加のコストが発生する場合があります。

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

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

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

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

  1. CodePipeline リソースをクリーンアップするには、」の削除pAWS CodePipeline

  2. CodeDeploy リソースをクリーンアップするには、」リソース (コンソール) をクリーンアップするには

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