AWS CodeBuild Builds mit Step Functions verwalten

Sie können Step Functions integrieren, AWS CodeBuild um Builds zu starten, zu stoppen und zu verwalten. Auf dieser Seite werden die unterstützten Funktionen aufgeführt, die CodeBuild APIs Sie mit Step verwenden können.

Step Functions kann bestimmte AWS Dienste direkt von Amazon States Language (ASL) aus steuern. Weitere Informationen hierzu finden Sie unter Integration anderer Services und Übergeben von Parametern an einen Dienst API in Step Functions.

Die AWS Step Functions Serviceintegration mit AWS CodeBuild ermöglicht es Ihnen, Step Functions zu verwenden, um Builds auszulösen, zu stoppen und zu verwalten und Build-Berichte gemeinsam zu nutzen. Mithilfe von Step Functions können Sie Pipelines für die kontinuierliche Integration entwerfen und ausführen, um Ihre Softwareänderungen für Anwendungen zu validieren.

Worin unterscheidet sich die optimierte CodeBuild Integration von der Integration CodeBuild AWS SDK

• Das Ausführen einer Aufgabe (.sync) Integrationsmuster wird unterstützt.

• Nachdem Sie StopBuild oder aufgerufen habenStopBuildBatch, kann der Build oder der Build-Batch nicht sofort gelöscht werden, bis einige interne Arbeiten abgeschlossen sind, CodeBuild um den Status des Builds oder der Builds abzuschließen. Wenn Sie versuchen, BatchDeleteBuilds oder DeleteBuildBatch während dieses Zeitraums zu verwenden, wird der Build oder der Build-Batch möglicherweise nicht gelöscht. Die optimierten Serviceintegrationen DeleteBuildBatch bieten einen internen Wiederholungsversuch, um den Anwendungsfall des Löschens unmittelbar nach dem Beenden zu vereinfachen. BatchDeleteBuilds

Nicht alle APIs unterstützen alle Integrationsmuster, wie in der folgenden Tabelle dargestellt.

API	Request Response (Antwort anfordern)	Ausführen einer Aufgabe (.sync)
StartBuild	✓	✓
StopBuild	✓
BatchDeleteBuilds	✓
BatchGetReports	✓
StartBuildBatch	✓	✓
StopBuildBatch	✓
RetryBuildBatch	✓	✓
DeleteBuildBatch	✓

Die Parameter in Step Functions werden ausgedrückt in PascalCase

Auch wenn der systemeigene Dienst API aktiviert istcamelCase, z. B. die API AktionstartSyncExecution, geben Sie Parameter in an PascalCase, z. B.:StateMachineArn.

Unterstützt CodeBuild APIs und Syntax:

• StartBuild

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • 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

  • Antwortsyntax

• StopBuild

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Id

  • Antwortsyntax

• BatchDeleteBuilds

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Ids

  • Antwortsyntax

• BatchGetReports

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • ReportArns

  • Antwortsyntax

• StartBuildBatch

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • 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

  • Antwortsyntax

• StopBuildBatch

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Id

  • Antwortsyntax

• RetryBuildBatch

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Id

    • IdempotencyToken

    • RetryType

  • Antwortsyntax

• DeleteBuildBatch

  • Erforderliche Syntax

  • Unterstützte Parameter:

    • Id

  • Antwortsyntax

Anmerkung

Sie können den JSONPath-(..)Operator für rekursiven Abstieg für BatchDeleteBuilds verwenden. Dies gibt ein Array zurück und ermöglicht es Ihnen, das Arn-Feld von StartBuild in einen Ids-Pluralparameter umzuwandeln, wie im folgenden Beispiel gezeigt.

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

Informationen zur Konfiguration von IAM Berechtigungen bei der Verwendung Step Functions mit anderen AWS Diensten finden Sie unterSo generiert Step Functions IAM Richtlinien für integrierte Dienste.