Auf dieser Seite wird beschrieben, wie Sie private Cloud Build-Pools erstellen, aktualisieren, anzeigen und löschen. Wenn Sie mit privaten Pools nicht vertraut sind, lesen Sie die Übersicht zu privaten Pools.
Hinweis
Erstellen Sie ein neues Cloud-Projekt oder wählen Sie ein vorhandenes Projekt aus. Sie verwenden dieses Projekt, um den privaten Pool zu erstellen.
- Aktivieren Sie die Cloud Build API.
Um die Befehlszeilenbeispiele in dieser Anleitung zu verwenden, installieren und konfigurieren Sie das Cloud SDK.
[Optional] Damit Builds über Ihr Virtual Private Cloud-Netzwerk auf private Ressourcen zugreifen können, müssen Sie eine Peering-Verbindung zwischen Ihrem Virtual Private Cloud-Netzwerk und dem Virtual Private Cloud-Netzwerk einrichten, in dem sich private Pools befinden. Eine Anleitung dazu finden Sie unter Umgebung für das Erstellen privater Pools einrichten.
Neuen privaten Pool erstellen
IAM-Berechtigungen: Zur Ausführung dieser Aufgabe benötigen Sie die Rolle Inhaber von Cloud Build-WorkerPools. Eine Anleitung zum Zuweisen dieser Rolle finden Sie unter Zugriff auf Cloud Build-Ressourcen konfigurieren.
Sie können bis zu zehn private Pools pro Cloud-Projekt und Region erstellen. So erstellen Sie einen neuen privaten Pool:
Console
Öffnen Sie die Seite Worker-Pool in der Google Cloud Console:
Wählen Sie das Projekt aus, in dem Sie den privaten Pool erstellen möchten.
Klicken Sie auf der Seite Worker-Pool auf Erstellen.
Gehen Sie in der Seitenleiste Privaten Pool erstellen so vor:
Geben Sie einen Namen für den privaten Pool ein. Dieser Wert muss zwischen 1 und 63 Zeichen lang sein und gültige Zeichen sind /[az][0-9]-/.
Wählen Sie die Region aus, in der der private Pool erstellt werden soll.
Wählen Sie den Compute Engine-Maschinentyp aus, den Sie für den privaten Pool verwenden möchten.
Geben Sie eine Laufwerkgröße für Ihren privaten Pool ein. Geben Sie einen Wert größer oder gleich 100 und kleiner oder gleich 1.000 an. Wenn nicht angegeben, verwendet Cloud Build eine Laufwerkgröße von 100.
Geben Sie die Projektnummer des Cloud-Projekts ein, in dem sich Ihr Virtual Private Cloud-Netzwerk befindet. Wenn Sie dieses Feld leer lassen, verwendet der private Pool das Netzwerk des Diensterstellers. Informationen zu den verfügbaren Optionen und Auswirkungen für die Netzwerkkonfiguration finden Sie unter Umgebung einrichten.
Geben Sie den Namen Ihres VPC-Netzwerks ein. Wenn Sie dieses Feld leer lassen, verwendet der private Pool das Netzwerk des Diensterstellers. Informationen zu den verfügbaren Optionen und Auswirkungen auf die Netzwerkkonfiguration finden Sie unter Umgebung einrichten.
Die Option Externe IP-Adressen zuweisen ist standardmäßig ausgewählt. Wenn Sie diese Option auswählen, kann ein privater Pool auf das öffentliche Internet zugreifen.
Klicken Sie auf Erstellen.
gcloud
Sie haben zwei Möglichkeiten, einen neuen privaten Pool zu erstellen:gcloud : Sie können Ihre Worker-Pool-Konfigurationsdatei entweder an diegcloud oder die Konfigurationsoptionen direkt an diegcloud Befehl.
Übertragen der Konfiguration des Worker-Pools an den Befehl gcloud:
Erstellen Sie die Konfigurationsdatei für den Worker-Pool im YAML- oder JSON-Format.
Führen Sie den folgenden
gcloud-Befehl aus, wobeiWORKERPOOL_IDeine eindeutige Kennzeichnung für den benutzerdefinierten Worker-Pool,WORKERPOOL_CONFIG_FILEder Name der Konfigurationsdatei für den Worker-Pool undREGIONist die Region, in der Sie den Worker-Pool erstellen möchten:gcloud builds worker-pools create WORKERPOOL_ID --config-from-file WORKERPOOL_CONFIG_FILE --region REGIONDie Ausgabe sollte in etwa so aussehen:
Created [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/private-pool]. NAME CREATE_TIME STATUS private-pool 2018-11-19T16:08:24+00:00 RUNNING
Übergabe der Konfigurationsoptionen direkt an den Befehl gcloud:
Führen Sie folgenden Befehl gcloud aus:
gcloud builds worker-pools create WORKERPOOL_ID \
--project=WORKERPOOL_PROJECT_ID \
--region=REGION \
--peered-network=PEERED_NETWORK \
--worker-machine-type=WORKERPOOL_MACHINE_TYPE \
--worker-disk-size=WORKERPOOL_DISK_SIZE_GB \
--no-public-egress
Ersetzen Sie die Platzhalterwerte in den obigen Befehlen durch Folgendes:
WORKERPOOL_IDist eine eindeutige Kennung für Ihren privaten Pool. Dieser Wert sollte 1-63 Zeichen umfassen und gültige Zeichen sind[a-zA-Z0-9_-]+.WORKERPOOL_PROJECT_ID: Die ID des Cloud-Projekts, in dem Sie Ihren privaten Pool erstellen möchten.REGION: Eine der unterstützten Regionen.PEERED_NETWORK: die URL der Netzwerkressource des Netzwerks, das über Peering mit dem Netzwerk des Diensterstellers verbunden ist.PEERED_NETWORKmuss das Format habenprojects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, wobeiNETWORK_PROJECT_IDist die Projekt-ID des Cloud-Projekts, das Ihr VPC-Netzwerk enthält.NETWORK_NAMEist der Name Ihres VPC-Netzwerks. Wenn Sie keinen Wert angeben, verwendet Cloud Build das Netzwerk des Dienstanbieters.WORKERPOOL_DISK_SIZE_GB: durch die Größe des Laufwerks, das an den privaten Pool angehängt ist. Geben Sie einen Wert größer oder gleich 100 und kleiner oder gleich 1.000 an. Wenn nicht angegeben, verwendet Cloud Build eine Laufwerkgröße von 100.--worker-disk-sizewird überschrieben, wenn Sie mithilfe von--disk-sizewährendgcloud builds submiteine andere Laufwerksgröße angeben.WORKERPOOL_MACHINE_TYPE: Der Maschinentyp des Workers. Bleibt das Flag leer, verwendet Cloud Build den Standardwerte2-standard-2. Eine Liste der unterstützten Maschinentypen finden Sie unter Schemakonfigurationsdatei für Worker-Pool.--worker-machine-typewird überschrieben, wenn Sie mitgcloud builds submiteinen anderen Maschinentyp mit--machine-typeangeben.--no-public-egress: Wenn dieses Flag festgelegt ist, wird der private Pool ohne externe IP-Adresse erstellt. Legen Sie dieses Flag fest, wenn Sie den privaten Pool innerhalb eines VPC Service Controls-Perimeters erstellen.
API
Erstellen Sie die Worker-Pool-Konfigurationsdatei mit dem Namen
workerpool.json.Rufen Sie die Cloud Build API mit cURL auf:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" \ https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools/?workerPoolId=WORKERPOOL_ID -d @workerpool.jsonErsetzen Sie die Platzhalterwerte im obigen Befehl durch Folgendes:
WORKERPOOL_PROJECT_ID: Die ID des Cloud-Projekts, in dem Sie Ihren privaten Pool erstellen möchten.WORKERPOOL_IDist die ID für Ihren privaten Pool. Dieser Wert sollte 1-63 Zeichen umfassen und gültige Zeichen sind[a-zA-Z0-9_-]+.REGION: Eine der unterstützten Regionen zum Erstellen des Worker-Pools.
Privaten Pool in einem VPC Service Controls-Perimeter erstellen
Wenn Sie einen privaten Pool innerhalb eines VPC Service Controls-Perimeters erstellen, finden Sie weitere Informationen unter VPC Service Controls verwenden.
Privaten Pool aktualisieren
IAM-Berechtigungen: Zur Ausführung dieser Aufgabe benötigen Sie die Rolle Cloud Build-WorkerPool-Bearbeiter. Eine Anleitung zum Zuweisen dieser Rolle finden Sie unter Zugriff auf Cloud Build-Ressourcen konfigurieren.
Sie können die Größe des Worker-Laufwerks und den Worker-Maschinentyp eines vorhandenen privaten Pools aktualisieren. So aktualisieren Sie einen privaten Pool:
Console
Öffnen Sie die Seite Worker-Pool in der Google Cloud Console:
Wählen Sie das Projekt aus, in dem Sie den privaten Pool erstellt haben.
Klicken Sie auf den Namen des Worker-Pools.
Aktualisieren Sie in der Seitenleiste Privaten Pool bearbeiten den Maschinentyp und/oder die Laufwerkgröße.
Klicken Sie auf Speichern.
gcloud
So aktualisieren Sie die Konfigurationsdatei des Worker-Pools:
Aktualisieren Sie das Feld, das Sie in Ihrer Konfigurationsdatei für den Worker-Pool ändern möchten.
Führen Sie den folgenden Befehl aus, wobei WORKERPOOL_ID die eindeutige Kennung für Ihren privaten Pool und WORKERPOOL_CONFIG_FILE der Name Ihrer Worker-Pool-Konfigurationsdatei ist:
gcloud builds worker-pools update WORKERPOOL_ID --config-from-file=WORKERPOOL_CONFIG_FILE
So übergeben Sie den Wert für die Aktualisierung direkt an den Befehl gcloud builds
worker-pools update:
gcloud builds worker-pools update WORKERPOOL_ID \
--worker-disk-size=WORKERPOOL_DISK_SIZE \
--worker-machine-type=WORKERPOOL_MACHINE_TYPE
Ersetzen Sie die Platzhalterwerte in den obigen Befehlen durch Folgendes:
WORKERPOOL_ID: Die ID Ihres vorhandenen privaten Pools. Sie können diesen Wert nicht aktualisieren; müssen Sie eine vorhandene Worker-Pool-ID angeben.WORKERPOOL_DISK_SIZE: Die aktualisierte Laufwerkgröße.WORKERPOOL_MACHINE_TYPEist der aktualisierte Maschinentyp.
API
Aktualisieren Sie in der Konfigurationsdatei für den Worker-Pool die Größe des Worker-Laufwerks und/oder den Worker-Maschinentyp.
Verwenden Sie cURL, um die Cloud Build API aufzurufen, und ersetzen Sie die Variablen durch die entsprechenden Werte:
curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools/WORKERPOOL_ID \ -d @workerpool.jsonErsetzen Sie die Platzhalterwerte im obigen Befehl durch Folgendes:
WORKERPOOL_IDist die ID Ihres privaten Pools.WORKERPOOL_PROJECT_ID: Die ID des Cloud-Projekts, das Ihren privaten Pool enthält.REGION: Eine der unterstützten Regionen zum Erstellen des Worker-Pools.
Details Ihres privaten Pools aufrufen
IAM-Berechtigungen: Zum Ausführen dieser Aufgabe benötigen Sie die Rolle Cloud Build-WorkerPool-Betrachter. Eine Anleitung zum Zuweisen dieser Rolle finden Sie unter Zugriff auf Cloud Build-Ressourcen konfigurieren.
So rufen Sie die Details eines privaten Pools auf:
Console
Öffnen Sie die Seite Worker-Pool in der Cloud Console:
Wählen Sie das Projekt aus, in dem Sie den privaten Pool erstellt haben.
Klicken Sie auf den Namen des Worker-Pools.
Die Seitenleiste Privaten Pool bearbeiten mit den Details des privaten Pools wird angezeigt.
gcloud
Wenn Sie die ID Ihres privaten Pools nicht kennen, führen Sie den folgenden Befehl aus, um die Details Ihres privaten Pools aufzulisten:
gcloud builds worker-pools list --project=WORKERPOOL_PROJECT_ID
Dabei ist WORKERPOOL_PROJECT_ID die ID des Cloud-Projekts, das den privaten Pool enthält.
Die Ausgabe sollte in etwa so aussehen:
NAME CREATE_TIME STATUS
projects/[WORKERPOOL_PROJECT_ID]/locations/us-central1/workerPools/[WORKERPOOL_ID] 2018-11-19T16:08:24+00:00 RUNNING
Wenn Sie Ihre private Pool-ID kennen, führen Sie den folgenden Befehl aus, um weitere Informationen zum Worker-Pool zu erhalten:
gcloud builds worker-pools describe \
--project=WORKERPOOL_PROJECT_ID WORKERPOOL_ID
Ersetzen Sie die Platzhalterwerte im obigen Befehl durch Folgendes:
WORKERPOOL_IDist die ID Ihres privaten Pools.WORKERPOOL_PROJECT_ID: Die ID des Cloud-Projekts, das Ihren privaten Pool enthält.
API
Wenn Sie die ID Ihres privaten Pools nicht kennen, führen Sie den folgenden cURL-Befehl aus, um die Details Ihres privaten Pools aufzulisten. Dabei ist WORKERPOOL_PROJECT_ID der ID des Cloud-Projekts, das den privaten Pool enthält:
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools
Wenn Sie Ihre private Pool-ID kennen, führen Sie den folgenden cURL-Befehl aus, um die Details Ihres privaten Pools abzurufen:
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools/WORKERPOOL_ID
Ersetzen Sie die Platzhalterwerte in den obigen Befehlen durch Folgendes:
WORKERPOOL_IDist die ID Ihres privaten Pools.WORKERPOOL_PROJECT_ID: Die ID des Cloud-Projekts, das Ihren privaten Pool enthält.REGION: Die Region, in der Sie den Worker-Pool erstellt haben.
Worker-Pool löschen
IAM-Berechtigungen: Zur Ausführung dieser Aufgabe benötigen Sie die Rolle Inhaber von Cloud Build-WorkerPools. Eine Anleitung zum Zuweisen dieser Rolle finden Sie unter Zugriff auf Cloud Build-Ressourcen konfigurieren.
So löschen Sie einen privaten Pool:
Console
Öffnen Sie die Seite Worker-Pool in der Cloud Console:
Klicken Sie in der Zeile mit Ihrem privaten Pool auf das Papierkorbsymbol.
gcloud
Führen Sie den Befehl gcloud builds worker-pools
delete aus, um einen privaten Pool zu löschen:
gcloud builds worker-pools delete WORKERPOOL_ID \
--project=WORKERPOOL_PROJECT_ID
Ersetzen Sie die Platzhalterwerte im obigen Befehl durch Folgendes:
WORKERPOOL_IDist die ID Ihres privaten Pools.WORKERPOOL_PROJECT_ID: Die ID des Cloud-Projekts, das Ihren privaten Pool enthält.
Nachdem der private Pool gelöscht wurde, sollte die Ausgabe in etwa so aussehen:
Deleted [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/[WORKERPOOL_ID].
API
Rufen Sie die Cloud Build API mit cURL auf:
curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://cloudbuild.googleapis.com/v1/projects/WORKERPOOL_PROJECT_ID/locations/REGION/workerPools/WORKERPOOL_ID
Ersetzen Sie die Platzhalterwerte in den obigen Befehlen durch Folgendes:
WORKERPOOL_IDist die ID Ihres privaten Pools.WORKERPOOL_PROJECT_ID: Die ID des Cloud-Projekts, das Ihren privaten Pool enthält.REGION: Die Region, in der Sie den Worker-Pool erstellt haben.