CodePipeline でパイプラインを作成する

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

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

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

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

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

注記

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

トピック

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

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

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

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

ビルドステージ
デプロイステージ

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

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

サインインするにはAWS Management ConsoleCodePipeline コンソールhttp://console.aws.amazon.com/codesuite/codepipeline/home。
[Welcome (ようこそ)] ページで、[Create pipeline (パイプラインの作成)] を選択します。

CodePipeline を初めて使用する場合は、[] を選択します。開始方法。
リポジトリの []ステップ 1: パイプラインの設定の選択ページ、[] でパイプライン名パイプラインの名前を入力します。

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

注記

パイプラインを作成したら、その名前を変更することはできません。その他の制限についての詳細については、「のクォータAWSCodePipeline」を参照してください。
[Service role (サービスロール)] で、次のいずれかの操作を行います。
- 選択新しいサービスロールCodePipeline が IAM での新しいサービスロールの作成を許可します。
- IAM で作成済みのサービスロールを使用するには、[Existing service role (既存のサービスロール)] を選択します。[ロール ARN] で、リストからサービスロール ARN を選択します。
注記

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

サービスロールとそのポリシーステートメントの詳細については、「CodePipeline サービスロールを管理する」を参照してください。
(オプション) [詳細設定] を展開します。
[アーティファクトストア] で、以下のいずれかの操作を行います。
1. パイプライン用に選択した AWS リージョンでパイプラインのデフォルトの S3 アーティファクトストア (デフォルトとして指定した S3 アーティファクトバケットなど) を使用するには、[デフォルトの場所] を選択します。
2. S3 アーティファクトバケットなどのアーティファクトストアがパイプラインと同じリージョンに既に存在する場合は、[Custom location (カスタムの場所)] を選択します。[バケット] で、バケット名を選択します。
注記

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

詳細については、「入力および出力アーティファクト」および「CodePipeline パイプライン構造」を参照してください。
[暗号化キー] で、次のいずれかの操作を行います。
1. CodePipeline のデフォルトを使用するにはAWS KMS keyパイプラインアーティファクトストア (S3 バケット) 内のデータを暗号化するには、デフォルト値AWS管理対象キー。
2. お使いのの使用カスタマー管理のキーパイプラインアーティファクトストア (S3 バケット) 内のデータを暗号化するには、カスタマー管理のキー。Cキー ID、キー ARN、エイリアス ARN、エイリアス ARN をフックします。
[Next] を選択します。

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

リポジトリの []ステップ 2: ソースステージを追加するページ、[] でソースプロバイダーで、ソースコードが保存されているリポジトリのタイプを選択し、必要なオプションを指定してから次のステップ。
- GitHub の場合:
  1. []接続既存の接続を選択するか、新しい接続を作成します。GitHub ソースアクション用の接続を作成または管理する方法については、GitHub の接続。
  2. パイプラインのソース場所として使用する GitHub リポジトリを選択します。[Branch ] で、ドロップダウンリストから使用するブランチを選択します。
  3. Eclipse出力アーティファクトのフォーマットで、アーティファクトのフォーマットを選択します。
    
    デフォルトのメソッドを使用して GitHub アクションからの出力アーティファクトを保存するには、CodePipeline。アクションは、GitHub リポジトリからファイルにアクセスし、パイプラインアーティファクトストアの ZIP ファイルにアーティファクトを保存します。
    
    リポジトリへの URL 参照を含む JSON ファイルを保存して、ダウンストリームのアクションで Git コマンドを直接実行できるようにするには、[Full clone (フルクローン)] を選択します。このオプションは、CodeBuild ダウンストリームアクションでのみ使用できます。
    
    このオプションを選択した場合は、CodeBuild プロジェクトサービスロールのパーミッションを更新する必要があります。CodePipeline。を使用する方法を示すチュートリアルについては、フルクローンオプションの詳細については、チュートリアル: GitHub パイプラインソースで完全なクローンを使用する。
- を使用する場合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:
  - Eclipseリポジトリ名で、パイプラインのソース場所として使用する CodeCommit リポジトリの名前を選択します。[Branch name] で、ドロップダウンリストから使用するブランチを選択します。
  - Eclipse出力アーティファクトのフォーマットで、アーティファクトのフォーマットを選択します。
    
    デフォルトのメソッドを使用して CodeCommit アクションからの出力アーティファクトを保存するには、[CodePipeline。アクションは、CodeCommit リポジトリからファイルにアクセスし、パイプラインアーティファクトストアの ZIP ファイルにアーティファクトを保存します。
    
    リポジトリへの URL 参照を含む JSON ファイルを保存して、ダウンストリームのアクションで Git コマンドを直接実行できるようにするには、[Full clone (フルクローン)] を選択します。このオプションは、CodeBuild ダウンストリームアクションでのみ使用できます。
    
    このオプションを選択する場合は、codecommit:GitPullのアクセス許可を CodeBuild サービスロールに追加します。CodeCommit ソースアクションの CodeBuild GitClone アクセス許可を追加する。また、追加する必要がありますcodecommit:GetRepositoryアクセス許可を CodePipeline サービスロールに追加します。CodePipeline サービスロールにアクセス許可を追加する。を使用する方法を示すチュートリアルについては、フルクローンオプションの詳細については、チュートリアル: GitHub パイプラインソースで完全なクローンを使用する。
  - CodeCommit リポジトリ名とブランチを選択すると、メッセージが検出オプションの変更このパイプライン用に作成される Amazon CloudWatch Events ルールを示しています。[Change detection options (変更検出オプション)] で、デフォルト値を受け入れます。これにより、CodePipeline は Amazon CloudWatch Events を使用して、新しいパイプラインの変更を検出できます。
- を使用する場合Amazon ECR:
  - Eclipseリポジトリ名で、Amazon ECR リポジトリの名前を選択します。
  - [Image tag] で、イメージの名前とバージョンを指定します (最新でない場合)。
  - [出力アーティファクト] で、デフォルトの出力アーティファクト (例: MyApp) を選択します。これには、次のステージで使用するイメージの名前およびリポジトリの URI が含まれます。
    
    CodeDeploy を使用した Amazon ECS のパイプラインの作成に関するチュートリアルは、Amazon ECR ソースステージを含む Blue/Green デプロイで 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 でサポートされているコンテナタイプの詳細については、Elastic Beanstalk 環境のカスタマイズと設定およびサポートされているプラットフォーム。CodeDeploy を使用したリビジョンのデプロイの詳細については、アプリケーションリビジョンのアップロードおよびリビジョンの準備。

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

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

リポジトリの []ステップ 3: ビルドステージを追加するページで、以下のいずれかの操作を行い、[次:
- デプロイステージを作成する予定の場合は、[Skip build stage (ビルドステージのスキップ)] を選択します。
- [ビルドプロバイダー] から、ビルドサービスのカスタムアクションプロバイダーを選択し、そのプロバイダーの設定詳細を入力します。Jenkins をビルドプロバイダとして追加する方法の例については、「チュートリアル: 4 ステージのパイプラインを作成する」を参照してください。
- [ビルドプロバイダ] から、[AWS CodeBuild] を選択します。
  
  Eclipseリージョン] で、AWSリソースが存在するリージョン。-リージョンフィールドは、AWSリソースは、このアクションタイプとプロバイダタイプに対して作成されます。このフィールドは、アクションプロバイダーがAWSサービス。-リージョンフィールドのデフォルトはAWSパイプラインとしてのリージョン
  
  [プロジェクト名] で、ビルドプロジェクトを選択します。CodeBuild でビルドプロジェクトがすでにある場合は、選択します。または、CodeBuild でビルドプロジェクトを作成し、その後でこのタスクに戻ります。「」の指示に従って、CodeBuild を使用するパイプラインを作成するのCodeBuild ユーザーガイド。
  
  Eclipse環境変数で、ビルドアクションに CodeBuild 環境変数を追加するには、環境変数の追加。各変数は、次の 3 つのエントリで構成されます。
  - [名前] には、環境変数の名前またはキーを入力します。
  - [値] には、環境変数の値を入力します。を選択するとParameter変数タイプに対して、この値が既に保存されているパラメータの名前であることを確認してください。AWSSystems Manager パラメータストア。
    
    注記
    
    機密情報、特に、保存する場合には、環境変数を使用しないことを強くお勧めします。AWSシークレットキー ID とシークレットアクセスキー。CodeBuild コンソールやAWSCLI では、環境変数はプレーンテキストで表示されます。機密の値の場合は、代わりに [パラメータ] 型を使用することをお勧めします。
  - (オプション) [型] に、環境変数の型を入力します。有効な値は、[プレーンテキスト] または [パラメータ] です。デフォルトは [プレーンテキスト] です。
  （オプション）ビルドタイプで、以下のいずれかを選択します。
  - 1 つのビルドアクションの実行で各ビルドを実行するには、1 つのビルド。
  - 同じビルドアクションの実行で複数のビルドを実行するには、Batch ビルド。
  （オプション）バッチビルドを実行することを選択した場合は、バッチのすべてのアーチファクトを1つの場所に結合するを使用して、すべてのビルド成果物を単一の出力成果物に配置します。

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

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

リポジトリの []ステップ 4: デプロイステージを追加するページで、以下のいずれかの操作を行い、[次:
- 前のステップでビルドステージを作成した場合は、[Skip deploy stage (デプロイステージのスキップ)] を選択します。
  
  注記
  
  すでにビルドステージをスキップしている場合、このオプションは表示されません。
- [デプロイプロバイダ] で、デプロイプロバイダ用に作成したカスタムアクションを選択します。
  
  Eclipseリージョン[クロスリージョンアクションのみ] で、AWSリソースが作成されるリージョン。-リージョンフィールドは、AWSリソースは、このアクションタイプとプロバイダタイプに対して作成されます。このフィールドには、アクションプロバイダーがAWSサービス。-リージョンフィールドのデフォルトはAWSパイプラインとしてのリージョン
- [デプロイプロバイダ] で、デフォルトプロバイダ用の以下のフィールドを使用できます。
  - CodeDeploy
    
    Eclipseアプリケーション名既存の CodeDeploy アプリケーションの名前を入力または選択します。[デプロイグループ] に、アプリケーションのデプロイグループの名前を入力します。[Next] を選択します。アプリケーション、デプロイグループ、または両方を CodeDeploy コンソールで作成することもできます。
  - AWS Elastic Beanstalk
    
    Eclipseアプリケーション名で、既存の Elastic Beanstalk アプリケーションの名前を入力または選択します。[環境名] に、アプリケーションの環境を入力します。[Next] を選択します。アプリケーション、環境、または両方を Elastic Beanstalk コンソールで作成することもできます。
  - AWS OpsWorks Stacks
    
    [スタック] で、使用するスタックの名前を入力または選択します。[レイヤー] で、ターゲットインスタンスがあるレイヤーを選択します。[デプロイ] で、更新およびデプロイするアプリケーションを選択します。アプリケーションを作成する必要がある場合は、[Create a new one in AWS OpsWorks] を選択します。
    
    スタックと Layer へのアプリケーションの追加の詳細については、AWS OpsWorks「」を参照してください。アプリケーションの追加のAWS OpsWorksユーザーガイド。
    
    CodePipeline でシンプルなパイプラインを、実行するコードのソースとして使用する方法のエンドツーエンドの例については、AWS OpsWorksレイヤーの詳細については、」CodePipeline の使用AWS OpsWorks Stacks。
  - AWS CloudFormation
    
    次のいずれかを行ってください。
    
    [アクションモード] で、[スタックの作成または更新] を選択し、スタック名とテンプレートファイル名を入力します。次に、AWS CloudFormation で引き受けるロールの名前を選択します。必要に応じて、設定ファイルの名前を入力し、IAM 機能オプションを選択します。
    
    [アクションモード] で [変更セットの作成または置換] を選択し、スタック名を入力して、セット名を変更します。次に、AWS CloudFormation で引き受けるロールの名前を選択します。必要に応じて、設定ファイルの名前を入力し、IAM 機能オプションを選択します。
    
    の統合について説明しますAWS CloudFormation機能を CodePipeline でパイプラインにインポートする方法については、CodePipeline による継続的なのAWS CloudFormationユーザーガイド。
  - Amazon ECS
    
    Eclipseクラスター名既存の Amazon ECS クラスターの名前を入力または選択します。[サービス名] で、クラスターで実行されているサービスの名前を入力または選択します。クラスターとサービスを作成することもできます。[イメージのファイル名] で、サービスのコンテナとイメージを説明するイメージ定義ファイルの名前を入力します。
    
    注記
    
    Amazon ECS デプロイアクションには、imagedefinitions.jsonファイルをデプロイアクションへの入力として。ファイルのデフォルトのファイル名は、imagedefinitions.json です。別のファイル名を使用することを選択した場合は、パイプラインデプロイステージを作成するときにそれを指定する必要があります。詳細については、「imagedefinitions.json ファイル」を参照してください。
    
    [次へ] を選択します。
    
    注記
    
    Amazon ECS クラスターが 2 つ以上のインスタンスで設定されていることを確認してください。Amazon ECS クラスターには、少なくとも 2 つのインスタンスが必要です。1 つはプライマリインスタンスとして維持し、もう 1 つは新しいデプロイに対応するために使用します。
    
    パイプラインを使用したコンテナベースのアプリケーションのデプロイに関するチュートリアルについては、チュートリアル: CodePipeline を使用した継続。
  - Amazon ECS (Blue/Green)
    
    CodeDeploy アプリケーションとデプロイグループ、Amazon ECS タスク定義、AppSpec ファイル情報を入力して、[次。
    
    注記
    
    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 Skill をデプロイするパイプラインを作成する」を参照してください。
  - Amazon S3
    
    [バケット] に、使用する S3 バケットの名前を入力します。デプロイステージへの入力アーティファクトが ZIP ファイルの場合は、[Extract file before deploy (デプロイ前にファイルを展開)] を選択します。[Extract file before deploy (デプロイ前にファイルを展開)] を選択した場合は、オプションで [Deployment path (デプロイパス)] に ZIP ファイルの解凍先を入力できます。選択しなかった場合は、[S3 object key (S3 オブジェクトキー)] に値を入力する必要があります。
    
    注記
    
    ほとんどのソースステージおよびビルドステージの出力アーティファクトは圧縮されます。Amazon S3 を除くすべてのパイプラインソースプロバイダーは、ソースファイルを、次のアクションへの入力アーティファクトとして渡す前に圧縮します。
    
    （オプション）既定 ACL[] に、[既定 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 リファレンス。

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

前提条件:

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

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

注記

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

トピック

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

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

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

このパイプラインのアーティファクトの保存先の 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 に設定すると、定期的なチェックが無効になります。これは、推奨される変更検出メソッドを使用している場合には、必要ではありません。

パイプラインとは異なるリージョンでビルド、テスト、またはデプロイアクションを作成するには、パイプライン構造に以下を追加する必要があります。手順については、「CodePipeline でクロスリージョンアクションを追加する」を参照してください。
- Region パラメータをアクションのパイプライン構造に追加します。
- を使用するartifactStores各アーティファクトバケットを指定するには、パラメータを使用します。AWSアクションがあるリージョン。
その構造で問題がなければ、pipeline.json のような名前でファイルを保存します。

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

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

という名前のパイプラインを作成するにはMySecondPipelineという名前を含む pipeline.json という名前の JSON ファイルでMySecondPipeline「の値としてnameJSONでは、コマンドは次のようになります。
```
aws codepipeline create-pipeline --cli-input-json file://pipeline.json
```
重要

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

このコマンドは、作成したパイプライン全体の構造を返します。
パイプラインを表示するには、CodePipeline コンソールを開いてパイプラインのリストから選択するか、get-pipeline-stateコマンドを実行します。詳細については、「CodePipelineでパイプラインの詳細と履歴を表示する」を参照してください。
パイプラインの作成に CLI を使用する場合には、推奨される変更検出リソースを手動でパイプラインに作成する必要があります。
- CodeCommit リポジトリを使用するパイプラインの場合、CloudWatch イベントルールを手動で作成する必要があります。詳しくは、「」を参照してください。CodeCommit ソースの CloudWatch Events ルールを作成する (CLI)。
- Amazon S3 ソースを使用するパイプラインでは、CloudWatch Events ルールを手動で作成し、AWS CloudTrailトレイル（を参照）Amazon S3 ソースアクションと CloudWatch イベント。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

パイプライン実行を停止する

パイプラインを編集する