Build-Abhängigkeiten verwalten

Auf dieser Seite wird erläutert, wie Sie Buildabhängigkeiten angeben. Mit Cloud Build können Sie Quellcodeabhängigkeiten getrennt vom Buildprozess verwalten.

In der Build-Konfigurationsdatei können Sie ein oder mehrere Git-Repositories auflisten, die für Ihren Build geklont werden sollen, und die Reihenfolge, in der sie abgerufen werden sollen. Wenn Sie Abhängigkeiten auf diese Weise angeben, wird der Abruf von Abhängigkeiten vom Buildprozess getrennt.

Wenn Sie keine Abhängigkeiten in Ihrer Build-Konfigurationsdatei angeben, klont Cloud Build das Quellcode-Repository, das Ihre Build-Konfigurationsdatei enthält (bei ausgelösten Builds) oder das Repository, das Ihren Quellcode enthält (bei Builds, die Sie über die Befehlszeile aufrufen). Wenn Sie Abhängigkeiten in Ihrer Build-Konfigurationsdatei angeben, klont Cloud Build keine Repositories, die nicht im Feld dependencies angegeben sind.

Jedes Quellcode-Repository, das Sie im Feld dependencies angeben, muss über Developer Connect mit Cloud Build verbunden sein oder ein öffentliches Repository sein.

Abhängigkeiten werden in der Reihenfolge geklont, in der Sie sie in dieser Konfiguration angeben. Außerdem wird das Abrufen von Abhängigkeiten ausgeführt, bevor eine vom Nutzer angegebene Logik ausgeführt wird. Das Abrufen von Abhängigkeiten gilt daher als vertrauenswürdig.

Abhängigkeiten werden auf der Seite Build-Details auf dem Tab Build-Abhängigkeiten angezeigt.

Hinweise

In der Anleitung auf dieser Seite wird davon ausgegangen, dass Sie ein oder mehrere Git-Repositories haben, die entweder öffentliche Repositories sind oder über Developer Connect verknüpft wurden.

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Developer Connect Read Token Accessor“ (developerconnect.readTokenAccessor) für Ihr Dienstkonto zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Hinzufügen eines Developer Connect-Repositories als Abhängigkeit benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Abhängigkeiten angeben

Abhängigkeiten werden angegeben, indem Sie Ihrer Build-Konfigurationsdatei eine dependencies-Stanza hinzufügen. dependencies ist eine Eigenschaft der obersten Ebene in der Build-Konfiguration, kann aber an einer beliebigen Stelle in der Datei platziert werden.

Die Syntax für den dependencies-Abschnitt lautet:

YAML 

 dependencies:
 - gitSource:
     repository:
       url: 'URL'
       developerConnect: 'RESOURCE_PATH'
     revision: 'REVISION'
     recurseSubmodules: 'true|false'
     depth: DEPTH'
     destPath: 'DEST_PATH'

JSON 

 {
     "dependencies": {
         "gitSource": {
             "repository": {
                 "url": "URL"
                 "developerConnect": "RESOURCE_PATH"
             },
             "revision": "REVISION",
             "recurseSubmodules": true|false,
             "depth": "DEPTH",
             "destPath": "DEST_PATH",
         },
     },
 }

Ersetzen Sie die folgenden Werte:

  • URL: Optional. Die HTTPS-URL des zu abrufenden Repositorys. Sie müssen entweder eine URL oder einen Developer Connect-Ressourcenpfad angeben.

  • RESOURCE_PATH: Optional. Der Google Cloud Ressourcenpfad zu diesem Developer Connect-Repository. Beispiel: projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo. Sie müssen entweder eine URL oder einen Developer Connect-Ressourcenpfad angeben. Geben Sie dieses Feld an, wenn das abzurufende Repository über Developer Connect mit Cloud Build verbunden ist.

  • REVISION: erforderlich. Die Version, der Commit-Hash, das Tag oder der Name des Branches, der aus dem Repository abgerufen werden soll.

  • recurseSubmodules: „true|false“: Gibt an, ob Untermodule abgerufen werden sollen.

  • DEPTH: Optional: Wie weit in den Repository-Verlauf hinein abgerufen werden soll. Wenn keine Angabe erfolgt, wird der letzte Commit abgerufen.

    • 1: der letzte Commit
    • 2: die letzten beiden Commits
    • 3: die letzten drei Commits
    • -1: alle Commits

  • DEST_PATH: erforderlich. Der Pfad zum Verzeichnis, in das das Repository geklont wird. Beispiel: my/repo.

    Wenn Sie dest_path festlegen, wird das Repository in /workspace/<dest_path> abgerufen. Der Wert für dest_path muss ein Pfad relativ zum Arbeitsverzeichnis des Builds sein.

Developer Connect-Repository als Abhängigkeit angeben

  • Wenn Sie ein Developer Connect-Repository als Abhängigkeit angeben, müssen Sie dem Cloud Build-Dienstkonto die Rolle Developer Connect Read Token Accessor zuweisen. Weitere Informationen finden Sie unter Cloud Build Zugriff auf ein Developer Connect-Repository gewähren.

  • Ihr Build muss sich in derselben Region wie die Developer Connect-Verbindung befinden.

Nächste Schritte