View a markdown version of this page

Das Überschreiben von Bezeichnungen wird vom Actions-Runner CodeBuild-hosted GitHub unterstützt - AWS CodeBuild
Außerkraftsetzung einzelner Labels (Legacy)

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.

Das Überschreiben von Bezeichnungen wird vom Actions-Runner CodeBuild-hosted GitHub unterstützt

In Ihrem GitHub Aktions-Workflow-YAML können Sie eine Vielzahl von Label-Overrides bereitstellen, die Ihren selbst gehosteten Runner-Build modifizieren. Alle Builds, die von nicht erkannt werden, CodeBuild werden ignoriert, aber Ihre Webhook-Anfrage wird nicht fehlschlagen. Zum Beispiel beinhaltet der folgende Workflow-YAML Überschreibungen für Image, Instance-Größe, Flotte und Buildspec:

name: Hello World
on: [push]
jobs:
  Hello-World-Job:
    runs-on:
      - codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}
        image:${{ matrix.os }}
        instance-size:${{ matrix.size }}
        fleet:myFleet
        buildspec-override:true
    strategy:
      matrix:
        include:
          - os: arm-3.0
            size: small
          - os: linux-5.0
            size: large
    steps:
      - run: echo "Hello World!"
Anmerkung

Wenn Ihr Workflow-Job hängengeblieben ist GitHub, finden Sie weitere Informationen unter Beheben Sie Probleme mit dem Webhook und Verwenden von benutzerdefinierten Labels zur Weiterleitung von Aufträgen.

codebuild-<project-name>-${{github.run_id}}-${{github.run_attempt}} (Erforderlich)

  • Beispiel: codebuild-fake-project-${{ github.run_id }}-${{ github.run_attempt }}

  • Erforderlich für alle GitHub Aktions-Workflow-YAMLs. <project name>sollte dem Namen des Projekts entsprechen, für das der selbst gehostete Runner-Webhook konfiguriert ist.

image:<environment-type>-<image-identifier>

  • Beispiel: image:arm-3.0

  • Überschreibt das Image und den Umgebungstyp, die verwendet werden, wenn der selbst gehostete Runner-Build mit einem kuratierten Image gestartet wird. Weitere Informationen zu unterstützten Werten finden Sie unter. Bilder berechnen, die vom Actions-Runner unterstützt CodeBuild-hosted GitHub werden

    • Um das Bild und den Umgebungstyp, die mit einem benutzerdefinierten Image verwendet werden, zu überschreiben, verwenden Sie image:custom-<environment-type>-<custom-image-identifier>

    • Beispiel: image:custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0

      Anmerkung

      Wenn sich das benutzerdefinierte Image in einer privaten Registrierung befindet, finden Sie weitere Informationen unterKonfigurieren Sie private Registrierungsdaten für selbst gehostete Runner.

instance-size:<instance-size>

fleet:<fleet-name>

buildspec-override:<boolean>

  • Beispiel: buildspec-override:true

  • Ermöglicht dem Build die Ausführung von Buildspec-Befehlen in den POST_BUILD Phasen, und INSTALLPRE_BUILD, sofern auf gesetzt. true

Außerkraftsetzung einzelner Labels (Legacy)

CodeBuild ermöglicht es Ihnen, mehrere Überschreibungen in einem einzigen Label bereitzustellen, indem Sie Folgendes verwenden:

  • Verwenden Sie die folgende Syntax, um Ihre Umgebungseinstellungen für einen EC2/Lambda Amazon-Compute-Build zu überschreiben:

    runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<environment-type>-<image-identifier>-<instance-size>

  • Verwenden Sie die folgende Syntax, um Ihre Flotteneinstellungen für Amazon EC2 Compute Build zu überschreiben:

    runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-fleet-<fleet-name>

  • Verwenden Sie die folgende Syntax, um sowohl die Flotte als auch das für den Build verwendete Image zu überschreiben:

    runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-image-<image-version>-fleet-<fleet-name>

  • Um Buildspec-Befehle während des Builds auszuführen, -with-buildspec können dem Label als Suffix hinzugefügt werden:

    runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<image>-<image-version>-<instance-size>-with-buildspec

  • Optional können Sie eine Überschreibung der Instanzgröße angeben, ohne das Image zu überschreiben. Für Amazon EC2 EC2-Builds können Sie sowohl den Umgebungstyp als auch die Image-ID ausschließen. Bei Lambda-Builds können Sie die Image-ID ausschließen.