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

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

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

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

注記

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

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

重要

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

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

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

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

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

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

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

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

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

    注記

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

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

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

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

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

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

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

    1. 次のいずれかを選択します。. 選択 SampleApp_Windows.zip Windows Serverインスタンスのこのチュートリアルの手順に従ってください。

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

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

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

  8. の Amazon S3 バケットに対して、次のファイルをアップロードします。

    1. [Upload (アップロード)] を選択します。

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

    3. [Upload (アップロード)] を選択します。

ステップ 2. 作成 Amazon EC2 Windowsインスタンスを使用して、 CodeDeploy エージェント

注記

このチュートリアルでは、Amazon EC2 Windows インスタンスを作成するサンプル手順を示します。作成のサンプル手順 Amazon EC2 Linux インスタンス、を参照Linuxインスタンス、ショウ ステップ 3: EC2 Linux インスタンスを作成して CodeDeploy エージェントをインストールする. 作成するインスタンス数の入力を求められたら、 2 インスタンス。

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

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

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

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

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

  4. [信頼されたエンティティの種類を選択] で、[AWS のサービス] を選択します。以下 使用例を選択、選択 EC2を選択し、次に 次へ: アクセス許可

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

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

    注記

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

    [Create role] を選択します。

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

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

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

  3. ステップ1: Amazon Machine Image(AMI)を選択する ページを開き、 Microsoft Windows Server 2019ベース オプションを選択し、次に 選択. (この AMI は "Free tier eligible" とラベル付けされており、リストの先頭にあります)。

  4. ステップ2: インスタンスタイプの選択 ページで、対象となる無料会員資格を選択してください。 t2.micro インスタンスのハードウェア構成としてを入力し、 次へ: インスタンスの詳細の設定

  5. ステップ3: インスタンスの詳細の構成 ページを開き、以下を実行します。

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

    • [Auto-assign Public 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 あなたの地域のリソースキットファイル。たとえば、米国西部 (オレゴン州) 地域の場合は、bucket-name 付き aws-codedeploy-us-west-2。 バケット名のリストについては、以下を参照してください。 地域別リソースキットバケット名.

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

    • 残りの項目は ステップ3: インスタンスの詳細の構成 ページに変更はありません。[次] を選択します。ストレージの追加:

  6. 離席 ステップ4: ストレージの追加 ページを変更せずに、 次へ: タグの追加

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

    重要

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

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

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

  10. [Review Instance Launch] ページで、[Launch] を選択します。Wキーペアをプロンプトしました、選択 キー ペアなしで続行.

    注記

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

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

  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. アプリケーションが表示されるページで、[デプロイグループの作成] を選択します。

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

  3. [サービスロール] で、「CodeDeploy のサービスロールを作成する」で説明されている信頼およびアクセス許可を少なくとも持つ、AWS 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 マネジメントコンソール にサインインし、CodePipeline コンソール (http://console.aws.amazon.com/codesuite/codepipeline/home) を開きます。

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

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

    SampleApp_Windows.zip

    [次のステップ] を選択します。

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

    [] を選択します。

  7. ステップ3: ビルドステージを追加、選択 ビルドステージをスキップを選択し、警告メッセージを承認します。 スキップ もう一度。[] を選択します。

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

    注記

    Deployという名前は、 ステップ4: 展開ステージの追加 step、Source はパイプラインの最初のステージに与えられた名前と同じです。

  9. ステップ5: レビュー情報を確認してから、 パイプラインの作成.

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

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

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

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

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

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

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

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

  3. 展開グループ タブ、下 導入ライフサイクル イベント、選択 A インスタンスID。これにより、EC2 コンソールが開きます。

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

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

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

(オプション) S9月5日: パイプラインに別のステージを追加

次に、別のステージをパイプラインに追加し、CodeDeploy を使用してステージングサーバーから本稼働サーバーにデプロイできるようにします。まず、別のデプロイグループを CodeDeploy の CodePipelineDemoApplication に作成します。その後、このデプロイグループを使用するアクションを含むステージを追加します。別のステージを追加するには、CodePipeline コンソールまたは AWS CLI を使用して、JSON ファイルのパイプライン構造を取得し、手動で編集します。その後、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. [サービスロール] で、最初のデプロイに使用したのと同じ 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. ステージを追加、() ステージ名、入力 Production。 選択 ステージを追加.

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

  7. アクションの編集、() アクション名、入力 Deploy-Second-Deployment。 内 アクションプロバイダー、以下 展開、選択 AWSコードデプロイ.

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

    注記

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

(オプション) S9月6日: のステージ間の遷移を無効にして有効化します CodePipeline

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

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

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

  2. パイプラインの詳細ページで、 移行を無効にする ボタン(第2ステージの間)(展開)および前のセクション(生産)。

  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におけるipeline.

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

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