Rufen Sie AWS CodeBuild mit Step Functions auf

Step Functions kann bestimmte AWS Dienste direkt von Amazon States Language (ASL) aus steuern. Weitere Informationen hierzu finden Sie unter Arbeiten mit anderen -Services und Parameter an eine Service-API übergeben.

Wie unterscheidet sich die optimierte CodeBuild Integration von der CodeBuild AWS SDK-Integration

• 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

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.

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

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

Anmerkung

Parameter in Step Functions werden in ausgedrückt PascalCase, auch wenn sich die native Service-API in CamelCase befindet. Sie könnten beispielsweise die Step Functions API-Aktion verwenden startSyncExecution und ihren Parameter als angeben. StateMachineArn

Unterstützte 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 unterIAM-Richtlinien für integrierte Dienste.