AWS CodeBuild Step Functions를 사용한 호출

Step Functions는 Amazon States Language (ASL) 에서 직접 특정 AWS 서비스를 제어할 수 있습니다. 자세한 내용은 다른 서비스와 함께 사용 및 파라미터를 서비스 API에 전달 섹션을 참조하세요.

최적화된 CodeBuild 통합과 CodeBuild AWS SDK 통합의 차이점

• 작업 실행(.sync) 통합 패턴이 지원됩니다.

• StopBuild또는 StopBuildBatch 를 호출한 후에는 빌드 또는 빌드의 상태를 CodeBuild 확정하기 위한 내부 작업이 완료될 때까지 빌드 또는 빌드 배치를 즉시 삭제할 수 없습니다. 이 기간 동안 BatchDeleteBuilds 또는 DeleteBuildBatch를 사용하려고 하면 빌드나 빌드 배치가 삭제되지 않을 수 있습니다. BatchDeleteBuilds 및 DeleteBuildBatch의 최적화된 서비스 통합에는 중지 후 즉시 삭제하는 사용 사례를 단순화하기 위한 내부 재시도가 포함되어 있습니다.

와의 AWS Step Functions 서비스 통합을 AWS CodeBuild 통해 Step Functions를 사용하여 빌드를 트리거, 중지, 관리하고 빌드 보고서를 공유할 수 있습니다. Step Functions를 사용하면 애플리케이션의 소프트웨어 변경 사항을 검증할 수 있도록 지속적인 통합 파이프라인을 설계하고 실행할 수 있습니다.

다음 표에 나와 있는 것처럼 일부 API는 일부 통합 패턴을 지원하지 않습니다.

API	요청 및 응답	작업 실행(.sync)
StartBuild	✓	✓
StopBuild	✓
BatchDeleteBuilds	✓
BatchGetReports	✓
StartBuildBatch	✓	✓
StopBuildBatch	✓
RetryBuildBatch	✓	✓
DeleteBuildBatch	✓

참고

네이티브 서비스 Step Functions API가 PascalCase CamelCase인 경우에도 의 파라미터는 로 표현됩니다. 예를 들어 Step Functions API 작업 startSyncExecution을 사용하고 해당 파라미터를 StateMachineArn으로 지정할 수 있습니다.

지원되는 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

  • 응답 구문

• StartBuildBatch

  • 요청 구문

  • 지원되는 파라미터:

    • ProjectName

    • ArtifactsOverride

    • BuildBatchConfigOverride

    • BuildspecOverride

    • BuildTimeoutInMinutesOverride

    • CacheOverride

    • CertificateOverride

    • ComputeTypeOverride

    • DebugSessionEnabled

    • EncryptionKeyOverride

    • EnvironmentTypeOverride

    • EnvironmentVariablesOverride

    • GitCloneDepthOverride

    • GitSubmodulesConfigOverride

    • IdempotencyToken

    • ImageOverride

    • ImagePullCredentialsTypeOverride

    • InsecureSslOverride

    • LogsConfigOverride

    • PrivilegedModeOverride

    • QueuedTimeoutInMinutesOverride

    • RegistryCredentialOverride

    • ReportBuildBatchStatusOverride

    • SecondaryArtifactsOverride

    • SecondarySourcesOverride

    • SecondarySourcesVersionOverride

    • ServiceRoleOverride

    • SourceAuthOverride

    • SourceLocationOverride

    • SourceTypeOverride

    • SourceVersion

  • 응답 구문

• StopBuildBatch

  • 요청 구문

  • 지원되는 파라미터:

    • Id

  • 응답 구문

• RetryBuildBatch

  • 요청 구문

  • 지원되는 파라미터:

    • Id

    • IdempotencyToken

    • RetryType

  • 응답 구문

• DeleteBuildBatch

  • 요청 구문

  • 지원되는 파라미터:

    • Id

  • 응답 구문

참고

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 정책.