Build-Abhängigkeiten verwalten

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

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

Wenn Sie keine Abhängigkeiten in Ihre Build-Konfigurationsdatei aufnehmen, klont Cloud Build das Quellcode-Repository, das Ihre Build-Konfigurationsdatei enthält (für ausgelöste Builds), oder das Repository, das Ihren Quellcode enthält (für Builds, die Sie über die Befehlszeile aufrufen). Wenn Sie Abhängigkeiten in Ihre Build-Konfigurationsdatei aufnehmen, klont Cloud Build keine Repositorys, 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 werden Abhängigkeiten abgerufen, bevor nutzerspezifische Logik ausgeführt wird. Das Abrufen von Abhängigkeiten ist also vertrauenswürdig.

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

Hinweise

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

Bitten Sie Ihren Administrator, Ihrem Dienstkonto die IAM-Rolle „Developer Connect Read Token Accessor“ (developerconnect.readTokenAccessor) zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Hinzufügen eines Developer Connect-Repositorys 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 der Build-Konfigurationsdatei eine dependencies-Stanza hinzufügen. dependencies ist eine Eigenschaft der obersten Ebene in der Build-Konfiguration, Sie können sie aber an einer beliebigen Stelle in der Datei platzieren.

Im Folgenden finden Sie die Syntax für den dependencies-Abschnitt:

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 Repositorys, das abgerufen werden soll. 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 Branchname, der aus dem Repository abgerufen werden soll.

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

  • DEPTH: Optional. Gibt an, wie tief in den Repository-Verlauf abgerufen werden soll. Wenn nichts angegeben ist, 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 dest_path-Wert 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