Step Functions を使用して AWS CodeBuild を呼び出す

Step Functions は、特定の AWS サービスをAmazon の言語から直接制御できます。AWS Step Functions とその統合の詳細については、以下を参照してください。

• 他のサービスでの使用

• サービス API にパラメータを渡す

AWS Step Functions サービスと AWS CodeBuild を統合すると、Step Functions を使用してビルドのトリガー、停止、管理、およびビルドレポートの共有を行うことができます。Step Functions を使用すると、アプリケーションのソフトウェア変更を検証するための継続的統合パイプラインを設計および実行できます。

次の表に示すとおり、すべての API がすべての統合パターンをサポートしているわけではありません。

API	リクエストレスポンス	ジョブの実行 (.sync)
StartBuild	✓	✓
StopBuild	✓
BatchDeleteBuilds	✓
BatchGetReports	✓

注記

Step Functions パラメータはPascalCaseの場合でも、ネイティブサービスAPIがcamelCase。

サポートされているCodeBuild API と構文:

• StartBuild

  • リクエストの構文

  • サポートされているパラメータ:

    • ProjectName

    • ArtifactsOverride

    • BuildspecOverride

    • CacheOverride

    • CertificateOverride

    • ComputeTypeOverride

    • EncryptionKeyOverride

    • EnvironmentTypeOverride

    • EnvironmentVariablesOverride

    • GitCloneDepthOverride

    • GitSubmodulesConfigOverride

    • IdempotencyToken

    • ImageOverride

    • ImagePullCredentialsTypeOverride

    • InsecureSslOverride

    • LogsConfigOverride

    • PrivilegedModeOverride

    • QueuedTimeoutInMinutesOverride

    • RegistryCredentialOverride

    • ReportBuildStatusOverride

    • SecondaryArtifactsOverride

    • SecondarySourcesOverride

    • SecondarySourcesVersionOverride

    • ServiceRoleOverride

    • SourceAuthOverride

    • SourceLocationOverride

    • SourceTypeOverride

    • SourceVersion

    • TimeoutInMinutesOverride

  • レスポンスの構文

• StopBuild

  • リクエストの構文

  • サポートされているパラメータ:

    • Id

  • レスポンスの構文

• BatchDeleteBuilds

  • リクエストの構文

  • サポートされているパラメータ:

    • Ids

  • レスポンスの構文

• BatchGetReports

  • リクエストの構文

  • サポートされているパラメータ:

    • ReportArns

  • レスポンスの構文

注記

BatchDeleteBuilds には、JSONPath 再帰的降下 (..) 演算子を使用できます。これは配列を返し、次の例に示すように、Arn フィールドを StartBuild から複数形の Ids パラメータに変換できます。

"BatchDeleteBuilds": {
    "Type": "Task",
    "Resource": "arn:aws:states:::codebuild:batchDeleteBuilds",
    "Parameters": {
        "Ids.$": "$.Build..Arn"
    },
    "Next": "MyNextState"
},

他の AWS サービスStep Functions を使用して IAM を設定する方法の詳細については、「」を参照してください。統合サービスの IAM ポリシー。