CodePipeline でパイプラインを作成します。 - AWS CodePipeline

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

CodePipeline でパイプラインを作成します。

AWS CodePipeline コンソールまたは AWS CLI を使用してパイプラインを作成できます。パイプラインには少なくとも 2 つのステージが必要です。パイプラインの第 1 ステージは、ソースステージである必要があります。パイプラインには、ビルドまたはデプロイステージである他のステージが少なくとも 1 つ必要です。

アクションを、パイプラインとは異なる AWS のリージョン内にあるパイプラインに追加できます。クロスリージョンアクションは、AWS のサービスがアクションのプロバイダーであり、アクションタイプまたはプロバイダータイプがパイプラインとは異なる AWS のリージョンにあるアクションです。詳細については、「CodePipeline にクロスリージョンアクションを追加する」を参照してください。

Amazon ECS をデプロイプロバイダとして使用して、コンテナベースのアプリケーションを構築およびデプロイするパイプラインを作成することもできます。Amazon ECS でコンテナベースのアプリケーションをデプロイするパイプラインを作成する前に、イメージ定義ファイルのリファレンス の説明に従ってイメージ定義ファイルを作成する必要があります。

CodePipeline は、ソースコードの変更がプッシュされたときにパイプラインを開始するように、変更検出方法を使用してします。この検出方法はソースタイプに基づいています。

  • CodePipeline は Amazon CloudWatch Events を使用して、CodeCommit ソースリポジトリとブランチの変更や S3 ソースバケットの変更を検出します。

注記

コンソールを使用してパイプラインを作成または編集すると、変更検出リソースが作成されます。AWS のCLI を使用してパイプラインを作成する際は、追加のリソースを各自で作成する必要があります。詳細については、「 CodeCommit ソースアクションと CloudWatch イベント」を参照してください。

パイプラインを作成する (コンソール)

コンソールでパイプラインを作成するには、ソースファイルの場所と、アクションに使用するプロバイダに関する情報を提供する必要があります。

コンソールを使用してパイプラインを作成する場合、ソースステージに加えて、以下のいずれかまたは両方が必要です。

  • ビルドステージ

  • デプロイステージ

パイプラインウィザードを使用する場合、CodePipeline はステージの名前 (ソース、ビルド、ステージング) を作成します。これらの名前は変更できません。ステージの後半で、より詳細な名前 (たとえば、BuildToGamma または DeployToProd) を使用することもできます。

ステップ 1: パイプラインの作成と名前付け

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

  2. [Welcome (ようこそ)] ページで、[Create pipeline (パイプラインの作成)] を選択します。

    CodePipeline を初めて使用する場合は、Get Started を選択します。

  3. リポジトリの []ステップ 1: パイプラインの設定の選択[] ページパイプライン名[] を選択し、パイプラインの名前を入力します。

    単一の AWS のアカウントで、AWS のリージョン内に作成するパイプラインごとに一意の名前が必要です。名前は、異なるリージョンのパイプラインに再利用できます。

    注記

    パイプラインを作成したら、その名前を変更することはできません。その他の制限についての詳細については、「AWS の CodePipeline 中のクォータ」を参照してください。

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

    • New service role を選択して、CodePipelineに IAM での新しいサービスロールの作成を許可します。

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

    注記

    サービスロールを作成したタイミングに応じて、追加の AWS のサービスをサポートするためにロールのアクセス権限の更新が必要になる場合があります。詳細については、CodePipeline サービスロールにアクセス許可を追加する を参照してください。

    サービスロールとそのポリシーステートメントの詳細については、「の管理 CodePipeline サービスロール」を参照してください。

  5. (オプション) [詳細設定] を展開します。

  6. [アーティファクトストア] で、以下のいずれかの操作を行います。

    1. 選択デフォルトの場所[] のパイプラインにデフォルトのアーティファクトストア (デフォルトとして指定された S3 アーティファクトバケットなど) を使用するには、AWS リージョンパイプライン用に選択しました。

    2. S3 アーティファクトバケットなどのアーティファクトストアがパイプラインと同じリージョンに既に存在する場合は、[Custom location (カスタムの場所)] を選択します。[バケット] で、バケット名を選択します。

    注記

    これはソースコードのソースバケットではありません。パイプラインのアーティファクトストアです。パイプラインごとに S3 バケットなどの個別のアーティファクトストアが必要です。パイプラインを作成または編集する場合は、パイプラインリージョンにアーティファクトバケットが必要であり、アクションを実行する AWS リージョンごとに 1 つのアーティファクトバケットが必要です。

    詳細については、「入力および出力アーティファクト」および「CodePipeline パイプライン構造リファレンス」を参照してください。

  7. [暗号化キー] で、次のいずれかの操作を行います。

    1. CodePipeline のデフォルト AWS KMS key を用いて、パイプラインアーティファクトストア(S3 バケット) 内のデータを暗号化するには、Default AWS Managed Key を選択します。

    2. のカスタマーマネージドキー を使用してパイプラインアーティファクトストア (S3 バケット) 内のデータを暗号化するには、Customer Managed Key を選択します。 キー ID、キー ARN、またはエイリアスの ARN を選択します。

  8. [Next] (次へ) をクリックします。

ステップ 2: ソースステージを作成する

  • リポジトリの []ステップ 2: ソースステージを追加する[] ページソースプロバイダー[] を選択し、ソースコードが保存されているリポジトリのタイプを選択し、必要なオプションを指定してから次のステップ

    • GitHub の場合:

      1. Connection 下で、既存の接続を選択するか、新しい接続を作成します。GitHub ソースアクションのための接続を作成または管理するには、GitHub コネクション を参照してください。

      2. パイプラインのソース場所として使用する GitHub リポジトリを選択します。[Branch ] で、ドロップダウンリストから使用するブランチを選択します。

      3. Output artifact format で、アーティファクトのフォーマットを選択します。

        • デフォルトのメソッドを使用して GitHub アクションからの出力アーティファクトを保存するには、CodePipeline default を選択します。アクションは、Bitbucket リポジトリからファイルにアクセスし、パイプラインアーティファクトストアの ZIP ファイルにアーティファクトを保存します。

        • リポジトリへの URL 参照を含む JSON ファイルを保存して、ダウンストリームのアクションで Git コマンドを直接実行できるようにするには、[Full clone (フルクローン)] を選択します。このオプションは、CodeBuild ダウンストリームアクションでのみ使用できます。

          このオプションを選択した場合は、CodePipeline のトラブルシューティング で示されるように CodeBuild プロジェクトサービスロールの権限を更新する必要があります。Full clone オプションを使用する方法を示すチュートリアルについては、チュートリアル: CodeCommGitHub パイプラインソースで完全なクローンを使用する を参照してください。

    • Amazon S3 については:

      1. [Amazon S3 の場所] で、S3 バケットの名前と、バージョニングが有効になっているバケット内のオブジェクトへのパスを指定します。バケット名とパスの形式は以下のようになります。

        s3://bucketName/folderName/objectName
        注記

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

      2. S3 ソースバケットを選択した後、CodePipeline は、このパイプライン用に Amazon CloudWatch Events ルールと AWS CloudTrail の証跡を作成します。[Change detection options (変更検出オプション)] で、デフォルト値を受け入れます。これにより、CodePipeline は Amazon CloudWatch Events と AWS CloudTrail を使用して、新しいパイプラインの変更を検出できます。[Next] (次へ) をクリックします。

    • 複数 AWS CodeCommit:

      • Repository name で、パイプラインのソース場所として使用する CodeCommitリポジトリの名前を選択します。[Branch name] で、ドロップダウンリストから使用するブランチを選択します。

      • Output artifact format で、アーティファクトのフォーマットを選択します。

        • デフォルトのメソッドを使用して CodeCommit アクションからの出力アーティファクトを保存するには、CodePipeline default を選択します。アクションは、CodeCommit リポジトリからファイルにアクセスし、パイプラインアーティファクトストアの ZIP ファイル中にアーティファクトを保存します。

        • リポジトリへの URL 参照を含む JSON ファイルを保存して、ダウンストリームのアクションで Git コマンドを直接実行できるようにするには、[Full clone (フルクローン)] を選択します。このオプションは、CodeBuild ダウンストリームアクションでのみ使用できます。

          このオプションを選択する場合、codecommit:GitPull に示すように、CodeBuild サービスロールに を追加します。 CodeBuild ソースアクションの CodeCommit GitClone のアクセス許可 の許可を追加する必要があります。また、codecommit:GetRepository に示すように、CodePipeline のサービス・ロールに CodePipeline サービスロールにアクセス許可を追加する の許可を追加する必要もあります。Full clone オプションを使用する方法を示すチュートリアルについては、チュートリアル: CodeCommGitHub パイプラインソースで完全なクローンを使用する を参照してください。

      • CodeCommit リポジトリ名とブランチを選択すると、Change detection options にメッセージが表示されて、このパイプライン用に作成される Amazon CloudWatch Events ルールが示されます。[Change detection options (変更検出オプション)] で、デフォルト値を受け入れます。これにより、CodePipeline は、 Amazon CloudWatch Events を使用して、新しいパイプラインの変更を検出できます。

    • Amazon ECR については:

      • Repository name で、Amazon ECR リポジトリの名前を選択します。

      • [Image tag] で、イメージの名前とバージョンを指定します (最新でない場合)。

      • [出力アーティファクト] で、デフォルトの出力アーティファクト (例: MyApp) を選択します。これには、次のステージで使用するイメージの名前およびリポジトリの URI が含まれます。

        Amazon ECR ソースステージを含む、CodeDeploy ブルー-グリーンデプロイを用いての Amazon ECS のパイプラインの作成に関するチュートリアルについては、チュートリアル: Amazon ECR ソース、ECS-CodeDeploy 間のデプロイでパイプラインを作成する を参照してください。

      パイプラインに Amazon ECR のソースステージを含めると、変更をコミットしたときにソースアクションによって、出力アーティファクトとして imageDetail.json のファイルが生成されます。imageDetail.json ファイルの詳細については、「Amazon ECS Blue/Green デプロイアクション用の imageDetail.json ファイル」を参照してください。

    注記

    オブジェクトとファイルのタイプは、使用するデプロイシステム (Elastic Beanstalk や CodeDeploy など) と互換性があることが必要です。サポートされているファイルのタイプは .zip、.tar、.tgz ファイルなどです。Elastic Beanstalk でサポートされているコンテナのタイプの詳細については、Customizing and Configuring Elastic Beanstalk EnvironmentsSupported Platforms を参照してください。CodeDeploy によるデプロイのリビジョンの詳細については、Uploading Your Application RevisionPrepare a Revision を参照してください。

ステップ 3: ビルドステージを作成する

デプロイステージを作成する予定の場合、このステップはオプションです。

  • リポジトリの []ステップ 3: ビルドステージを追加する[] ページで、以下のいずれかの操作を行い、[] を選択します。:

    • デプロイステージを作成する予定の場合は、[Skip build stage (ビルドステージのスキップ)] を選択します。

    • [ビルドプロバイダー] から、ビルドサービスのカスタムアクションプロバイダーを選択し、そのプロバイダーの設定詳細を入力します。Jenkins をビルドプロバイダとして追加する方法の例については、「チュートリアル: 4 ステージのパイプラインを作成する」を参照してください。

    • [ビルドプロバイダ] から、[AWS CodeBuild] を選択します。

      Region で、リソースが存在する AWS のリージョンを選択します。Region フィールドは、このアクションタイプとプロバイダータイプに対して作成済みの AWS のリソースの場所を示します。このフィールドには、アクションプロバイダーが AWS のサービスである場合にのみ表示されます。Region フィールドは、デフォルトでパイプラインと同じ AWS のリージョンになります。

      [プロジェクト名] で、ビルドプロジェクトを選択します。CodeBuild にビルドプロジェクトがすでにある場合は、それを選択します。または、CodeBuild でビルドプロジェクトを作成し、その後でこのタスクに戻ります。CodeBuild User Guide 中の Create a Pipeline That Uses CodeBuild の指示に従います。

      Environment variables で、ビルドアクションに CodeBuild 環境変数を追加するには、Add environment variable を選択します。各変数は、次の 3 つのエントリで構成されます。

      • [名前] には、環境変数の名前またはキーを入力します。

      • [] には、環境変数の値を入力します。変数タイプで Parameter を選択した場合は、この値が、AWS のSystems Manager パラメータストアに既に保存されているパラメータの名前であることを確認してください。

        注記

        機密情報、特に AWS のシークレットキー ID とシークレットアクセスキーを保存する場合は、環境変数を使用しないことを強くお勧めします。CodeBuild コンソールまたは AWS のCLI を使用する場合、環境変数はプレーンテキストで表示されます。機密の値の場合は、代わりに [パラメータ] 型を使用することをお勧めします。

      • (オプション) [] に、環境変数の型を入力します。有効な値は、[プレーンテキスト] または [パラメータ] です。デフォルトは [プレーンテキスト] です。

      (オプション) Build type で、次のいずれかを選択します。

      • 各ビルドを 1 回のビルドアクション実行で実行するには、Single build を選択します。

      • 同じビルドアクションの実行で複数のビルドを実行するには、Batch build を選択します。

      (オプション) バッチビルドを選択した場合、Combine all artifacts from batch into a single location を選択して、すべてのビルドアーティファクトを 1 つの出力アーティファクトに配置します。

ステップ 4: デプロイステージを作成する

ビルドステージをすでに作成している場合、このステップはオプションです。

  • リポジトリの []ステップ 4: デプロイステージを追加する[] ページで、以下のいずれかの操作を行い、[] を選択します。:

    • 前のステップでビルドステージを作成した場合は、[Skip deploy stage (デプロイステージのスキップ)] を選択します。

      注記

      すでにビルドステージをスキップしている場合、このオプションは表示されません。

    • [デプロイプロバイダ] で、デプロイプロバイダ用に作成したカスタムアクションを選択します。

      Region で、クロスリージョンアクション専用に、リソースの作成先となる AWS のリージョンを選択します。Region フィールドは、このアクションタイプとプロバイダータイプに対して作成済みの AWS のリソースの場所を示します。このフィールドには、アクションプロバイダが AWS サービスであるアクションのみが表示されます。Region フィールドは、デフォルトでパイプラインと同じ AWS のリージョンになります。

    • [デプロイプロバイダ] で、デフォルトプロバイダ用の以下のフィールドを使用できます。

      • CodeDeploy

        Application name で、既存の CodeDeploy アプリケーションの名前を入力または選択します。[デプロイグループ] に、アプリケーションのデプロイグループの名前を入力します。[Next] (次へ) をクリックします。アプリケーション、デプロイグループ、または両方を CodeDeploy コンソールで作成することもできます。

      • AWS Elastic Beanstalk

        Application name で、既存の Elastic Beanstalk アプリケーションの名前を入力または選択します。[環境名] に、アプリケーションの環境を入力します。[Next] (次へ) をクリックします。アプリケーション、環境、または両方を Elastic Beanstalk コンソールで作成することもできます。

      • AWS OpsWorks Stacks

        [スタック] で、使用するスタックの名前を入力または選択します。[レイヤー] で、ターゲットインスタンスがあるレイヤーを選択します。[デプロイ] で、更新およびデプロイするアプリケーションを選択します。アプリケーションを作成する必要がある場合は、[Create a new one in AWS OpsWorks] を選択します。

        AWS OpsWorks でスタックとレイヤーにアプリケーションを追加する情報ついては、AWS OpsWorksユーザーガイドAdding Apps を参照してください。

        CodePipelineでシンプルなパイプラインを、AWS OpsWorks のレイヤーで実行するコードのソースとして使用する方法のエンドツーエンドの例については、Using CodePipeline with AWS OpsWorks Stacks を参照してください。

      • AWS CloudFormation

        以下の いずれかを 実行します。

        • [アクションモード] で、[スタックの作成または更新] を選択し、スタック名とテンプレートファイル名を入力します。次に、AWS CloudFormation で引き受けるロールの名前を選択します。必要に応じて、設定ファイルの名前を入力し、IAM 機能オプションを選択します。

        • [アクションモード] で [変更セットの作成または置換] を選択し、スタック名を入力して、セット名を変更します。次に、AWS CloudFormation で引き受けるロールの名前を選択します。必要に応じて、設定ファイルの名前を入力し、IAM 機能オプションを選択します。

        AWS CloudFormation の機能を CodePipeline のパイプラインに統合する情報ついては、AWS CloudFormation ユーザーガイドContinuous Delivery with CodePipeline を参照してください。

      • Amazon ECS

        Cluster name で、既存の Amazon ECS クラスターの名前を入力または選択します。[サービス名] で、クラスターで実行されているサービスの名前を入力または選択します。クラスターとサービスを作成することもできます。[イメージのファイル名] で、サービスのコンテナとイメージを説明するイメージ定義ファイルの名前を入力します。

        注記

        Amazon ECS デプロイアクションでは、デプロイアクションへの入力として imagedefinitions.json のファイルが必要です。ファイルのデフォルトのファイル名は、imagedefinitions.json です。別のファイル名を使用することを選択した場合は、パイプラインデプロイステージを作成するときにそれを指定する必要があります。詳細については、「Amazon ECS 標準デプロイアクション用の imagedefinitions.json ファイル」を参照してください。

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

        注記

        Amazon ECS クラスターが 2 つ以上のインスタンスで設定されていることを確認してください。Amazon ECS クラスターには、少なくとも 2 つのインスタンスが必要です。1 つはプライマリインスタンスとして維持し、もう 1 つは新しいデプロイに対応するために使用します。

        パイプラインを使用したコンテナベースのアプリケーションのデプロイに関するチュートリアルについては、「」を参照してください。チュートリアル: CodePipeline を使用した継続的

      • Amazon ECS (Blue/Green)

        CodeDeploy アプリケーションとデプロイグループ、 Amazon ECS タスク定義、AppSpec ファイル情報を入力して、Next を選択します。

        注記

        Amazon ECS (Blue/Green) アクションには、デプロイアクションの入力アーティファクトとして imageDetail.json ファイルが必要です。Amazon ECR ソースアクションがこのファイルを作成するので、Amazon ECR ソースアクションを持つパイプラインは、imageDetail.json のファイルを提供する必要はありません。詳細については、「Amazon ECS Blue/Green デプロイアクション用の imageDetail.json ファイル」を参照してください。

        CodeDeploy を使用して Amazon ECS クラスターへの blue-green デプロイ用のパイプラインを作成するためのチュートリアルについては、チュートリアル: Amazon ECR ソース、ECS-CodeDeploy 間のデプロイでパイプラインを作成する を参照してください。

      • AWS Service Catalog

        コンソールのフィールドを使用して設定を指定する場合は [Enter deployment configuration (デプロイ設定の入力)] を選択します。あるいは、個別の設定ファイルがある場合は [設定ファイル] を選択します。製品と設定の情報を入力し、[次へ] を選択します。

        パイプラインを使用して製品の変更を AWS Service Catalog にデプロイする方法のチュートリアルについては、「チュートリアル: にデプロイするパイプラインを作成するAWS Service Catalog」を参照してください。

      • Alexa Skills Kit

        [Alexa Skill ID (Alexa スキル ID)] に Alexa スキルのスキル ID を入力します。[クライアント ID] と [クライアントシークレット] に、Login with Amazon (LWA) セキュリティプロファイルを使用して生成された認証情報を入力します。[Refresh token (更新トークン)] に、ASK CLI コマンドを使用して生成した更新トークンを入力します。[Next] (次へ) をクリックします。

        パイプラインにより Alexa スキルをデプロイする方法、LWA 認証情報を生成する方法のチュートリアルについては、「チュートリアル: Amazon Alexa Skills Skills をデプロイするパイプラインを作成する」を参照してください。

      • [Amazon S3]

        [バケット] に、使用する S3 バケットの名前を入力します。デプロイステージへの入力アーティファクトが ZIP ファイルの場合は、[Extract file before deploy (デプロイ前にファイルを展開)] を選択します。[Extract file before deploy (デプロイ前にファイルを展開)] を選択した場合は、オプションで [Deployment path (デプロイパス)] に ZIP ファイルの解凍先を入力できます。選択しなかった場合は、[S3 object key (S3 オブジェクトキー)] に値を入力する必要があります。

        注記

        ほとんどのソースステージおよびビルドステージの出力アーティファクトは圧縮されます。Amazon S3 zip を除くすべてのパイプラインソースプロバイダーは、ソースファイルを Zip してから、次のアクションに入力アーティファクトとして提供します。

        (オプション) Canned ACL で、canned ACL を入力し、Amazon S3 にデプロイされたオブジェクトに適用します。

        注記

        既定 ACL を適用すると、オブジェクトに適用された既存の ACL が上書きされます。

        (オプション) [キャッシュコントロール] で、バケットからオブジェクトをダウンロードするリクエストのキャッシュコントロールパラメータを指定します。有効な値のリストについては、HTTP オペレーションの Cache-Control ヘッダーフィールドを参照してください。[Cache control (キャッシュコントロール)] に複数の値を入力するには、各値の間にカンマを使用します。この例に示すように、各カンマの後にスペースを追加できます (オプション)。

        上記のエントリ例は、CLI に次のように表示されます。

        "CacheControl": "public, max-age=0, no-transform"

        [Next] (次へ) をクリックします。

        Amazon S3 デプロイアクションプロバイダとして を使用するパイプラインを作成する方法のチュートリアルについては、チュートリアル: デプロイプロバイダーとして Amazon S3 を使用するパイプラインを作成する を参照してください。

ステップ 5: パイプラインの確認

  • リポジトリの []ステップ 5: 確認[] ページで、パイプラインの設定を確認し、[パイプラインの作成パイプラインを作成するか[戻る][] をクリックして選択内容を編集します。パイプラインを作成せずにウィザードを終了するには、[Cancel] を選択します。

パイプラインが作成され、コンソールで表示できるようになりました。パイプラインは、作成後に実行されます。詳細については、「CodePipeline でパイプラインの詳細と履歴を表示します。」を参照してください。パイプラインを変更する方法の詳細については、「CodePipeline でパイプラインを編集する」を参照してください。

パイプラインを作成する (CLI)

AWS CLI を使用してパイプラインを作成するには、JSON ファイルを作成してパイプライン構造を定義し、--cli-input-json パラメータを指定して create-pipeline コマンドを実行します。

重要

AWS CLI を使用して、パートナーアクションを含むパイプラインを作成することはできません。代わりに CodePipeline コンソールを使用する必要があります。

パイプライン構造に関する詳細については、CodePipeline パイプライン構造リファレンス およびCodePipeline API Referencecreate-pipeline を参照してください。

JSON ファイルを作成するには、同じパイプラインの JSON ファイルを使用して編集し、create-pipeline コマンドを実行するときにこのファイルを呼び出します。

前提条件:

CodePipeline の使用開始 で CodePipeline 用に作成したサービスロールの ARN が必要です。create-pipeline のコマンドの実行時、パイプライン JSON ファイル中の CodePipeline サービスロールの ARN を使用します。サービスロールの作成の詳細については、「CodePipeline サービスロールを作成する」を参照してください。コンソールとは異なり、AWS CLI で create-pipeline のコマンドを実行する場合、CodePipeline サービスロールを作成するオプションはありません。サービスロールがすでに存在している必要があります。

パイプラインのアーティファクトの保存先である S3 バケットの名前が必要です。このバケットはパイプラインと同じリージョンに存在する必要があります。バケット名は、create-pipeline コマンドの実行時にパイプライン JSON ファイルで使用します。コンソールとは異なり、AWS CLI で create-pipeline コマンドを実行しても、アーティファクトを保存する S3 バケットは作成されません。バケットが存在している必要があります。

注記

get-pipeline コマンドを使用して、パイプラインの JSON 構造のコピーを取得し、プレーンテキストエディタで構造を変更することもできます。

トピック

    JSON ファイルを作成するには

    1. ターミナル (Linux、 macOS、あるいは Unix)またはコマンドプロンプト(Windows)で、ローカルディレクトリに新規のテキストファイルを作成します。

    2. プレーンテキストエディタでファイルを開き、作成する構造を反映するように値を編集します。少なくとも、パイプラインの名前を変更する必要があります。また、変更するかを考慮する必要もあります。

      • このパイプラインのアーティファクトの保存先の S3 バケット。

      • コードのソースの場所。

      • デプロイのプロバイダ。

      • コードをデプロイする方法。

      • パイプラインのタグ。

      以下の 2 ステージのサンプルパイプライン構造では、変更を検討する必要があるパイプラインの値を強調表示しています。パイプラインには多くの場合、2 つ以上のステージが含まれます。

      { "pipeline": { "roleArn": "arn:aws:iam::80398EXAMPLE::role/AWS-CodePipeline-Service", "stages": [ { "name": "Source", "actions": [ { "inputArtifacts": [], "name": "Source", "actionTypeId": { "category": "Source", "owner": "AWS", "version": "1", "provider": "S3" }, "outputArtifacts": [ { "name": "MyApp" } ], "configuration": { "S3Bucket": "awscodepipeline-demobucket-example-date", "S3ObjectKey": "ExampleCodePipelineSampleBundle.zip", "PollForSourceChanges": "false" }, "runOrder": 1 } ] }, { "name": "Staging", "actions": [ { "inputArtifacts": [ { "name": "MyApp" } ], "name": "Deploy-CodeDeploy-Application", "actionTypeId": { "category": "Deploy", "owner": "AWS", "version": "1", "provider": "CodeDeploy" }, "outputArtifacts": [], "configuration": { "ApplicationName": "CodePipelineDemoApplication", "DeploymentGroupName": "CodePipelineDemoFleet" }, "runOrder": 1 } ] } ], "artifactStore": { "type": "S3", "location": "codepipeline-us-east-2-250656481468" }, "name": "MyFirstPipeline", "version": 1 }, "metadata": { "pipelineArn": "arn:aws:codepipeline:us-east-2:80398EXAMPLE:MyFirstPipeline", "updated": 1501626591.112, "created": 1501626591.112 }, "tags": [{ "key": "Project", "value": "ProjectA" }] }

      この例では、パイプラインの Project タグキーと ProjectA 値を含めることによって、タグ付けをパイプラインに追加します。CodePipeline のタグ付けリソースのさらなる詳細については、リソースのタグ付け を参照してください。

      JSON ファイルの PollForSourceChanges パラメータが次のように設定されていることを確認します。

      "PollForSourceChanges": "false",

      CodePipeline は、Amazon CloudWatch Events を使用して、CodeCommit ソースリポジトリとブランチの変更、あるいは S3 ソースバケットの変更を検出します。次のステップには、パイプラインにこれらのリソースを手動で作成する手順が含まれています。フラグを false に設定すると、定期的なチェックが無効になります。これは、推奨される変更検出メソッドを使用している場合には、必要ではありません。

    3. パイプラインとは異なるリージョンでビルド、テスト、またはデプロイアクションを作成するには、パイプライン構造に以下を追加する必要があります。手順については、CodePipeline にクロスリージョンアクションを追加する を参照してください。

      • Region パラメータをアクションのパイプライン構造に追加します。

      • artifactStores のパラメーターを使って、アクションがある AWS のリージョンごとにアーティファクトバケットを指定します。

    4. その構造で問題がなければ、pipeline.json のような名前でファイルを保存します。

    パイプラインを作成するには

    1. 先ほど作成した JSON ファイルを --cli-input-json パラメータで指定して、create-pipeline コマンドを実行します。

      MySecondPipeline という名前を JSON 内の name のための値として含む [pipeline.json] という名前の JSON ファイルを使用して MySecondPipeline という名前のパイプラインを作成するには、コマンドは以下のように見えます:

      aws codepipeline create-pipeline --cli-input-json file://pipeline.json
      重要

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

      このコマンドは、作成したパイプライン全体の構造を返します。

    2. パイプラインを表示するには、CodePipeline コンソールを開いてパイプラインのリストから選択するか、get-pipeline-state のコマンドを使用します。詳細については、「CodePipeline でパイプラインの詳細と履歴を表示します。」を参照してください。

    3. パイプラインの作成に CLI を使用する場合には、推奨される変更検出リソースを手動でパイプラインに作成する必要があります。