Chamada AWS CodeBuild com Step Functions

Step Functions pode controlar determinados AWS serviços diretamente do Amazon States Language (ASL). Para saber mais, consulte Como trabalhar com outros serviços e Transmitir parâmetros para uma API de serviço.

Como a CodeBuild integração otimizada é diferente da integração do CodeBuild AWS SDK

• O padrão de integração Executar um trabalho (.sync) é compatível.

• Depois de chamar StopBuild ouStopBuildBatch, a compilação ou o lote de compilação não podem ser excluídos imediatamente até que algum trabalho interno seja concluído CodeBuild para finalizar o estado da compilação ou compilações. Se você tentar usar BatchDeleteBuilds ou DeleteBuildBatch durante esse período, a compilação ou o lote de compilação não poderão ser excluídos. As integrações de serviços otimizadas de BatchDeleteBuilds e DeleteBuildBatch incluem uma nova tentativa interna para simplificar o caso de uso de exclusão imediata após a interrupção.

A integração do AWS Step Functions serviço com AWS CodeBuild permite que você use Step Functions para acionar, interromper e gerenciar compilações e compartilhar relatórios de criação. Com o Step Functions, é possível projetar e executar pipelines de integração contínua para validar as alterações de software para aplicações.

Nem todas as APIs oferecem suporte a todos os padrões de integração, como mostrado na tabela a seguir.

API	Resposta de solicitação	Executar um trabalho (.sync)
StartBuild	✓	✓
StopBuild	✓
BatchDeleteBuilds	✓
BatchGetReports	✓
StartBuildBatch	✓	✓
StopBuildBatch	✓
RetryBuildBatch	✓	✓
DeleteBuildBatch	✓

Os parâmetros em Step Functions são expressos em PascalCase

Mesmo que a API de serviço nativa esteja no CamelCase, por exemplo, a startSyncExecution ação da API, você especifica parâmetros PascalCase em, como:. StateMachineArn

CodeBuild APIs e sintaxe suportadas:

• StartBuild

  • Sintaxe da solicitação

  • Parâmetros compatíveis:

    • 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

  • Sintaxe da resposta

• StopBuild

  • Sintaxe da solicitação

  • Parâmetros compatíveis:

    • Id

  • Sintaxe da resposta

• BatchDeleteBuilds

  • Sintaxe da solicitação

  • Parâmetros compatíveis:

    • Ids

  • Sintaxe da resposta

• BatchGetReports

  • Sintaxe da solicitação

  • Parâmetros compatíveis:

    • ReportArns

  • Sintaxe da resposta

• StartBuildBatch

  • Sintaxe da solicitação

  • Parâmetros compatíveis:

    • 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

  • Sintaxe da resposta

• StopBuildBatch

  • Sintaxe da solicitação

  • Parâmetros compatíveis:

    • Id

  • Sintaxe da resposta

• RetryBuildBatch

  • Sintaxe da solicitação

  • Parâmetros compatíveis:

    • Id

    • IdempotencyToken

    • RetryType

  • Sintaxe da resposta

• DeleteBuildBatch

  • Sintaxe da solicitação

  • Parâmetros compatíveis:

    • Id

  • Sintaxe da resposta

nota

É possível usar o operador de descida recursiva JSONPath (..) para BatchDeleteBuilds. Isso retorna uma matriz e permite que você transforme o campo Arn de StartBuild em um parâmetro plural Ids, como mostrado no exemplo a seguir.

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

Para obter informações sobre como configurar IAM permissões ao usar Step Functions com outros AWS serviços, consultePolíticas do IAM para serviços integrados.