Gestisci le AWS CodeBuild build con Step Functions

Puoi integrare Step Functions con AWS CodeBuild per avviare, interrompere e gestire le build. Questa pagina elenca i supporti CodeBuild APIs che è possibile utilizzare con Step Functions.

Step Functions può controllare determinati AWS servizi direttamente da Amazon States Language (ASL). Per ulteriori informazioni, consultare Integrazione con altri servizi e Passaggio di parametri a un servizio API in Step Functions.

L'integrazione del AWS Step Functions servizio con AWS CodeBuild consente di utilizzare Step Functions per attivare, interrompere e gestire le build e condividere report di build. Utilizzando Step Functions, è possibile progettare ed eseguire pipeline di integrazione continua per la convalida delle modifiche software per le applicazioni.

In che modo l' CodeBuild integrazione ottimizzata è diversa dall'integrazione CodeBuild AWS SDK

• Il modello di Esegui un processo (.sync) integrazione è supportato.

• Dopo aver chiamato StopBuild orStopBuildBatch, il batch di build o build non è immediatamente eliminabile finché non viene completato un lavoro interno CodeBuild per finalizzare lo stato della build o delle build. Se si tenta di utilizzare BatchDeleteBuilds o DeleteBuildBatch durante questo periodo, è possibile che la build o il batch di compilazione non vengano eliminati. Le integrazioni di servizio ottimizzate per BatchDeleteBuilds e DeleteBuildBatch includono un nuovo tentativo interno per semplificare il caso d'uso dell'eliminazione immediatamente dopo l'interruzione.

Non tutti APIs supportano tutti i modelli di integrazione, come illustrato nella tabella seguente.

API	Richiesta e risposta	Esegui un processo (.sync)
StartBuild	✓	✓
StopBuild	✓
BatchDeleteBuilds	✓
BatchGetReports	✓
StartBuildBatch	✓	✓
StopBuildBatch	✓
RetryBuildBatch	✓	✓
DeleteBuildBatch	✓

I parametri in Step Functions sono espressi in PascalCase

Anche se il servizio nativo API è attivocamelCase, ad esempio l'APIazionestartSyncExecution, si specificano i parametri in PascalCase, ad esempio:StateMachineArn.

Supportati CodeBuild APIs e sintassi:

• StartBuild

  • Sintassi della richiesta

  • Parametri supportati:

    • 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

  • Sintassi della risposta

• StopBuild

  • Sintassi della richiesta

  • Parametri supportati:

    • Id

  • Sintassi della risposta

• BatchDeleteBuilds

  • Sintassi della richiesta

  • Parametri supportati:

    • Ids

  • Sintassi della risposta

• BatchGetReports

  • Sintassi della richiesta

  • Parametri supportati:

    • ReportArns

  • Sintassi della risposta

• StartBuildBatch

  • Sintassi della richiesta

  • Parametri supportati:

    • 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

  • Sintassi della risposta

• StopBuildBatch

  • Sintassi della richiesta

  • Parametri supportati:

    • Id

  • Sintassi della risposta

• RetryBuildBatch

  • Sintassi della richiesta

  • Parametri supportati:

    • Id

    • IdempotencyToken

    • RetryType

  • Sintassi della risposta

• DeleteBuildBatch

  • Sintassi della richiesta

  • Parametri supportati:

    • Id

  • Sintassi della risposta

Nota

Puoi utilizzare l'operatore di discesa ricorsiva JSONPath (..) per BatchDeleteBuilds. Questo restituisce una matrice e consente di trasformare il campo Arn da StartBuild in un parametro Ids plurale, come illustrato nell'esempio seguente.

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

Per informazioni su come configurare le IAM autorizzazioni quando vengono utilizzate Step Functions con altri AWS servizi, vedere. In che modo Step Functions genera IAM politiche per servizi integrati