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 Ihre Build-Konfigurationsdatei aufnehmen, 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.
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.
Erforderliche Rollen
Wenn eines der Repositories, das Sie als Abhängigkeit hinzufügen, ein Developer Connect-Repository ist, benötigt Ihr Dienstkonto die Rolle Developer Connect Read Token Accessor:
Diese Rolle ist zusätzlich zu allen anderen erforderlichen Cloud Build-Rollen erforderlich.
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 sieht so aus:
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 Commit2
: die letzten beiden Commits3
: die letzten drei Commits-1
: alle Commits
DEST_PATH: erforderlich. Der Pfad zum Verzeichnis, in das das Repository geklont werden soll. Beispiel:
my/repo
.Wenn Sie
dest_path
festlegen, wird das Repository in/workspace/<dest_path>
abgerufen. Der Wert fürdest_path
muss ein relativer Pfad sein, der sich auf das Arbeitsverzeichnis des Builds bezieht.
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
Weitere Informationen zum Verbinden eines Repositories mit Cloud Build über Cloud Build-Repositories
Weitere Informationen zum Verbinden eines Repositories mit Cloud Build über Developer Connect