AWS CodePipeline アクションリファレンスを呼び出す - AWS CodePipeline
アクションタイプ設定パラメータ 入力アーティファクト出力アーティファクトCodePipeline 呼び出しアクションのサービスロールポリシーのアクセス許可アクションの宣言関連情報

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

AWS CodePipeline アクションリファレンスを呼び出す

CodePipeline 呼び出しアクションを使用して、ダウンストリームパイプライン実行のトリガーと、パイプライン変数とソースリビジョンをパイプライン間で渡す処理を簡素化します。

注記

このアクションは V2 タイプのパイプラインでのみサポートされています。

アクションタイプ

  • カテゴリ:Invoke

  • 所有者: AWS

  • プロバイダー: CodePipeline

  • バージョン: 1

設定パラメータ

PipelineName

必須: はい

実行中に現在のターゲットパイプラインを開始するパイプラインの名前。呼び出しパイプラインを既に作成している必要があります。my-s3-pipeline という名前の (呼び出し) パイプラインが実行を開始すると、アクションは s3-pipeline-test (ターゲット) パイプラインを開始します。

SourceRevisions

必須: いいえ

呼び出しパイプラインによって開始されたときにターゲットパイプラインで使用するソースリビジョン。例えば、S3 ソースアクションは、S3 バージョン ID やオブジェクトキーなどの出力変数を提供します。パイプラインが呼び出されるときに使用するリビジョン値を指定できます。

CLI では、ソースリビジョンをシリアル化された JSON 文字列として指定します。ソースリビジョンオーバーライドの使用の詳細については、「CodePipeline API ガイド」の「SourceRevisionOverride」を参照してください。

マッピングでは、次の例に示すように文字列形式を使用します。

[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]
[変数]

必須: いいえ

アクションでサポートする変数の名前と値。

CLI では、シリアル化された JSON 文字列として変数を指定します。パイプライン変数の使用の詳細については、「CodePipeline API ガイド」の「PipelineVariable」を参照してください。

マッピングでは、次の例に示すように文字列形式を使用します。

[{"name":"VAR1","value":"VALUE1"}]

次の図は、コンソールでパイプラインに追加されたアクションの例を示しています。

S3 ソースを含むパイプライン、およびパイプライン呼び出しアクションを含むビルドステージ

次の画像は、アクションの [編集] ページの例を示しています。次の例では、s3-pipeline-test という名前のパイプラインに、コンソールに示されているように設定されたパイプライン呼び出しアクションがあります。my-s3-pipeline という名前のパイプラインの実行が完了すると、アクションによって s3-pipeline-test パイプラインが開始されます。この例では、指定されたリビジョン値が zq8mjNYEexample の S3_OBJECT_VERSION_ID ソースオーバーライドのソースリビジョンオーバーライドを示しています。

パイプライン呼び出しアクションを使用した、新しいパイプラインの [アクションを編集する] ページ

入力アーティファクト

  • アーティファクトの数: 0

  • 説明: 入力アーティファクトは、このアクションタイプには適用されません。

出力アーティファクト

  • アーティファクトの数: 0

  • 説明: 出力アーティファクトは、このアクションタイプには適用されません。

CodePipeline 呼び出しアクションのサービスロールポリシーのアクセス許可

CodePipeline がアクションを実行する際、CodePipeline サービスロールポリシーには、最小特権でアクセスを維持するために、パイプラインリソース ARN に適切にスコープダウンされた codepipeline:StartPipelineExecution アクセス許可が必要です。

 {
            "Sid": "StatementForPipelineInvokeAction",
            "Effect": "Allow",
            "Action": "codepipeline:StartPipelineExecution",
            "Resource": [
                "arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}"
            ]
        }

アクションの宣言

YAML
name: Invoke-pipeline
actionTypeId:
  category: Invoke
  owner: AWS
  provider: CodePipeline
  version: '1'
runOrder: 2
configuration:
  PipelineName: my-s3-pipeline
  SourceRevisions: '[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision
Value":"zq8mjNEXAMPLE"}]'
  Variables: '[{"name":"VAR1","value":"VALUE1"}]'
JSON
{
    "name": "Invoke-pipeline",
    "actionTypeId": {
        "category": "Invoke",
        "owner": "AWS",
        "provider": "CodePipeline",
        "version": "1"
    },
    "runOrder": 2,
    "configuration": {
        "PipelineName": "my-s3-pipeline",
        "SourceRevisions": "[{\"actionName\":\"Source\",\"revisionType\":\"S3_OBJECT_VERSION_ID\",\"revisionValue\":\"zq8mjNEXAMPLE"}]",
        "Variables": "[{\"name\":\"VAR1\",\"value\":\"VALUE1\"}]"
    }
},

このアクションを利用する際に役立つ関連リソースは以下の通りです。