View a markdown version of this page

Führen Sie einen Batch-Build aus (AWS CLI) - AWS CodeBuild

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Führen Sie einen Batch-Build aus (AWS CLI)

  1. Führen Sie den Befehl start-build-batch auf eine der folgenden Weisen aus:

    aws codebuild start-build-batch --project-name <project-name>

    Sie können diesen Befehl verwenden, wenn Sie ein Build ausführen möchten, dass die neueste Version des Build-Eingabeartifakts und die vorhandenen Einstellungen des Build-Projekts einsetzt.

    aws codebuild start-build-batch --generate-cli-skeleton > <json-file>

    Verwenden Sie diesen Befehl, wenn Sie einen Build mit einer früheren Version des Build-Eingabeartefakts verwenden oder die Einstellungen für Build-Ausgabeartefakte, Umgebungsvariablen, Build-Spezifikationen oder Standard-Build-Zeitbeschränkungen überschreiben möchten.

  2. Wenn Sie den start-build-batch Befehl mit der --project-name Option ausführen, ersetzen Sie ihn durch den Namen des Build-Projekts, und fahren Sie dann <project-name> mit Schritt 6 dieses Verfahrens fort. Informationen zum Abrufen einer Liste von Build-Projekten finden Sie unter Namen von Build-Projekten anzeigen.

  3. Wenn Sie den start-build-batch Befehl mit der --idempotency-token Option ausführen, ist ein eindeutiger Bezeichner, bei dem zwischen Groß- und Kleinschreibung unterschieden wird, in der start-build-batch Anforderung enthalten. Das Token ist nach der Anforderung 5 Minuten gültig. Wenn Sie die start-build-batch Anforderung mit demselben Token wiederholen, aber einen Parameter ändern, wird ein Fehler CodeBuild zurückgegeben, der nicht übereinstimmt.

  4. Wenn Sie den start-build-batch Befehl mit der --generate-cli-skeleton Option ausführen, JSON-formatted werden Daten in die <json-file> Datei ausgegeben. Diese Datei ähnelt dem durch den start-build Befehl erzeugten Skelett, mit dem Zusatz des folgenden Objekts. Weitere Hinweise zu den häufig verwendeten Objekten finden Sie unterFühre einen Build aus (AWS CLI).

    Ändern Sie diese Datei, um alle Build-Overrides hinzuzufügen, und speichern Sie Ihre Ergebnisse.

      "buildBatchConfigOverride": {
    "combineArtifacts": combineArtifacts,
    "restrictions": {
      "computeTypesAllowed": [
        allowedComputeTypes
      ],
      "maximumBuildsAllowed": maximumBuildsAllowed
    },
    "serviceRole": "batchServiceRole",
    "timeoutInMins": batchTimeout
  }

    Das buildBatchConfigOverride Objekt ist eine ProjectBuildBatchConfig Struktur, die die Batch-Build-Konfigurationsüberschreibungen für diesen Build enthält.

    combineArtifacts

    Ein boolescher Wert, der angibt, ob die Build-Artefakte für den Batch-Build an einer einzigen Artefaktposition zusammengefasst werden sollen.

    allowedComputeTypes

    Ein Array von Zeichenfolgen, die die Datenverarbeitungstypen angeben, die für den Stapel-Build zulässig sind. Diese Werte finden Sie unter Berechnungstypen für Build-Umgebungen.

    maximumBuildsAllowed

    Gibt die maximal zulässige Anzahl von Builds an.

    batchServiceRole

    Gibt die Servicerollen-ARN für das Stapel-Build-Projekt an.

    batchTimeout

    Gibt die maximale Zeitspanne in Minuten an, in der die Stapelerstellung abgeschlossen werden muss.

  5. Wechseln Sie in das Verzeichnis, das die soeben gespeicherte Datei enthält, und führen Sie den Befehl start-build-batch erneut aus.

    aws codebuild start-build-batch --cli-input-json file://start-build.json

  6. Bei Erfolg wird die JSON-Darstellung eines BuildBatch Objekts in der Konsolenausgabe angezeigt. Ein Beispiel für diese Daten finden Sie in der StartBuildBatch Antwortsyntax.