Private Pools erstellen und verwalten

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

  1. Erstellen Sie ein neues Cloud-Projekt oder wählen Sie ein vorhandenes Projekt aus. Sie verwenden dieses Projekt, um den privaten Pool zu erstellen.

  2. Aktivieren Sie die Cloud Build API.

    Aktivieren Sie die API

  3. Um die Befehlszeilenbeispiele in dieser Anleitung zu verwenden, installieren und konfigurieren Sie das Cloud SDK.

  4. [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

  1. Öffnen Sie die Seite Worker-Pool in der Google Cloud Console:

    Seite "Cloud Build-Worker-Pool" öffnen

  2. Wählen Sie das Projekt aus, in dem Sie den privaten Pool erstellen möchten.

  3. Klicken Sie auf der Seite Worker-Pool auf Erstellen.

  4. Gehen Sie in der Seitenleiste Privaten Pool erstellen so vor:

    1. 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]-/.

    2. Wählen Sie die Region aus, in der der private Pool erstellt werden soll.

    3. Wählen Sie den Compute Engine-Maschinentyp aus, den Sie für den privaten Pool verwenden möchten.

    4. 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.

    5. 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.

    6. 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.

    7. 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.

    8. 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:

  1. Erstellen Sie die Konfigurationsdatei für den Worker-Pool im YAML- oder JSON-Format.

  2. Führen Sie den folgenden gcloud-Befehl aus, wobei WORKERPOOL_ID eine eindeutige Kennzeichnung für den benutzerdefinierten Worker-Pool, WORKERPOOL_CONFIG_FILE der Name der Konfigurationsdatei für den Worker-Pool und REGION ist 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 REGION
    

    Die 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_ID ist 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_NETWORK muss das Format haben projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME , wobeiNETWORK_PROJECT_ID ist die Projekt-ID des Cloud-Projekts, das Ihr VPC-Netzwerk enthält.NETWORK_NAME ist 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-size wird überschrieben, wenn Sie mithilfe von --disk-size während gcloud builds submit eine andere Laufwerksgröße angeben.
  • WORKERPOOL_MACHINE_TYPE: Der Maschinentyp des Workers. Bleibt das Flag leer, verwendet Cloud Build den Standardwert e2-standard-2. Eine Liste der unterstützten Maschinentypen finden Sie unter Schemakonfigurationsdatei für Worker-Pool. --worker-machine-type wird überschrieben, wenn Sie mit gcloud builds submit einen anderen Maschinentyp mit --machine-type angeben.
  • --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

  1. Erstellen Sie die Worker-Pool-Konfigurationsdatei mit dem Namen workerpool.json.

  2. 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.json
    

    Ersetzen 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_ID ist 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

  1. Öffnen Sie die Seite Worker-Pool in der Google Cloud Console:

    Seite "Cloud Build-Worker-Pool" öffnen

  2. Wählen Sie das Projekt aus, in dem Sie den privaten Pool erstellt haben.

  3. Klicken Sie auf den Namen des Worker-Pools.

  4. Aktualisieren Sie in der Seitenleiste Privaten Pool bearbeiten den Maschinentyp und/oder die Laufwerkgröße.

  5. Klicken Sie auf Speichern.

gcloud

So aktualisieren Sie die Konfigurationsdatei des Worker-Pools:

  1. Aktualisieren Sie das Feld, das Sie in Ihrer Konfigurationsdatei für den Worker-Pool ändern möchten.

  2. 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_TYPE ist der aktualisierte Maschinentyp.

API

  1. Aktualisieren Sie in der Konfigurationsdatei für den Worker-Pool die Größe des Worker-Laufwerks und/oder den Worker-Maschinentyp.

  2. 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.json
    

    Ersetzen Sie die Platzhalterwerte im obigen Befehl durch Folgendes:

    • WORKERPOOL_ID ist 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

  1. Öffnen Sie die Seite Worker-Pool in der Cloud Console:

    Seite "Cloud Build-Worker-Pool" öffnen

  2. Wählen Sie das Projekt aus, in dem Sie den privaten Pool erstellt haben.

  3. 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_ID ist 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_ID ist 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

  1. Öffnen Sie die Seite Worker-Pool in der Cloud Console:

    Seite "Cloud Build-Worker-Pool" öffnen

  2. 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_ID ist 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_ID ist 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.

Nächste Schritte