Instanz-Splits und Rollbacks für Cloud Run-Worker-Pools

Worker-Pools verarbeiten Arbeitslasten, die keine Anfragen sind. Für Anwendungsfälle, bei denen die Arbeit auf mehrere Überarbeitungen aufgeteilt werden muss, z. B. beim Bereitstellen einer neuen Überarbeitung, verwenden Worker-Pools die Instanzaufteilung.

In Cloud Run können Sie angeben, welche Überarbeitungen Instanzen erhalten, und die Prozentsätze für die Instanzzuweisung für jede Überarbeitung festlegen. Mit dieser Funktion können Sie ein Rollback zu einer vorherigen Überarbeitung durchführen, Instanzen auf mehrere Überarbeitungen aufteilen und Instanzen der neuesten Überarbeitung zuweisen. Auf dieser Seite wird beschrieben, wie Sie mit dieser Funktion die Instanzzuweisung zu Ihren Cloud Run-Überarbeitungen verwalten.

Anpassungen der Instanzzuweisung erfolgen nicht sofort. Wenn Sie die Instanzzuweisung für Überarbeitungen ändern, werden alle aktuell verarbeiteten Anfragen fortgesetzt, bis sie abgeschlossen sind. InFlight-Anfragen werden nicht verworfen und Cloud Run leitet diese Anfragen während der Übergangsphase möglicherweise entweder an eine neue oder an eine vorherige Überarbeitung weiter.

Lebenszyklus von Instanzaufteilungen

Wenn Sie Instanzen auf mehrere Überarbeitungen aufteilen oder einer vorherigen Überarbeitung zuweisen, wird dieses Instanzaufteilungsmuster für alle nachfolgenden Bereitstellungen verwendet. Wenn Sie nur die neueste Überarbeitung ohne Instanz aufteilung verwenden möchten, senden Sie alle Instanzen an die neueste Überarbeitung.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Run-Entwickler (roles/run.developer) für Ihren Cloud Run-Worker-Pool zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Cloud Run-Worker-Pools und -Überarbeitungen benötigen.

Eine Liste der IAM-Rollen und -Berechtigungen im Zusammenhang mit Cloud Run finden Sie unter IAM-Rollen für Cloud Run und IAM-Berechtigungen für Cloud Run. Wenn Ihr Cloud Run-Worker-Pool mit Google Cloud APIs wie Cloud-Clientbibliotheken verknüpft ist, lesen Sie die Konfigurationsanleitung für Dienstidentitäten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Bereitstellungsberechtigungen und Zugriff verwalten.

Rollback zu einer vorherigen Überarbeitung durchführen

Verwenden Sie die Google Cloud console oder die Google Cloud CLI, um ein Rollback zu einer vorherigen Überarbeitung durchzuführen:

Console

  1. Rufen Sie in der Google Cloud console die Seite „Cloud Run-Worker-Pools“ auf:

    Zu Cloud Run

  2. Suchen Sie den Worker-Pool in der Liste und klicken Sie darauf.

  3. Klicken Sie auf den Tab Überarbeitungen , um eine Liste der aktuellen Überarbeitungen für diesen Worker-Pool anzuzeigen.

  4. Klicken Sie auf Instanzaufteilungen verwalten , um das Formular zum Verwalten von Instanzen aufzurufen. In Cloud Run wird die neueste bereitstellende Überarbeitung aufgeführt. Konfigurieren Sie im Formular die folgenden Details:

    1. Klicken Sie auf Überarbeitung hinzufügen und wählen Sie in der Drop-down-Liste eine vorherige Überarbeitung aus.
    2. Legen Sie den Instanzprozentsatz der vorherigen Überarbeitung auf 100 fest.
    3. Legen Sie den Prozentsatz der neuesten bereitstellenden Überarbeitung auf 0 fest.
    4. Klicken Sie auf Speichern.

gcloud

Geben Sie die Überarbeitungen an, zu denen ein Rollback durchgeführt werden soll, indem Sie den folgenden Befehl ausführen.

   gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=REVISION=100

Ersetzen Sie Folgendes:

  • WORKER_POOL: Der Name des Worker-Pools.
  • REVISION: Der Name der Überarbeitung, zu der Sie ein Rollback durchführen.

Instanzen auf mehrere Überarbeitungen aufteilen

Verwenden Sie die Google Cloud console oder die Google Cloud CLI, um Instanzen auf zwei oder mehr Überarbeitungen aufzuteilen:

Wenn Sie Instanzen auf mehrere Überarbeitungen aufteilen, muss der Gesamt prozentsatz aller Überarbeitungen 100 % betragen. Die Anzahl der manuellen Instanzen muss größer sein als die Anzahl der Instanzaufteilungen, die die Arbeitslast verarbeiten.

Console

  1. Rufen Sie in der Google Cloud console die Seite „Cloud Run-Worker-Pools“ auf:

    Zu Cloud Run

  2. Suchen Sie den Worker-Pool in der Liste und klicken Sie darauf.

  3. Klicken Sie auf den Tab Überarbeitungen , um eine Liste der aktuellen Überarbeitungen für diesen Worker-Pool anzuzeigen.

  4. Klicken Sie auf Instanzaufteilungen verwalten , um das Formular zum Verwalten von Instanzen aufzurufen. In Cloud Run wird die neueste bereitstellende Überarbeitung aufgeführt. Konfigurieren Sie im Formular die folgenden Details:

    1. Legen Sie den Prozentsatz der neuesten bereitstellenden Überarbeitung auf die erforderliche Aufteilung fest, z. B. reduzieren Sie ihn von 100%.

    2. Klicken Sie auf Überarbeitung hinzufügen und wählen Sie in der Drop-down-Liste eine vorherige Überarbeitung aus. Legen Sie dann die entsprechende prozentuale Aufteilung fest.

    3. Wenn Sie Instanzen mit zusätzlichen Überarbeitungen aufteilen möchten, klicken Sie auf Überarbeitung hinzufügen, und wählen Sie eine weitere Überarbeitung aus und legen Sie den Prozentsatz fest.

    4. Klicken Sie auf Speichern.

gcloud

Geben Sie die Überarbeitungen und den Prozentsatz der Instanzen an, indem Sie den folgenden Befehl ausführen. Weisen Sie jeder Überarbeitung Instanzen zu in einer durch Kommas getrennten Liste:

   gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=LIST

Ersetzen Sie Folgendes:

  • WORKER_POOL: Der Name des Worker-Pools.

  • LIST: Eine durch Kommas getrennte Liste von Überarbeitungen und Prozentsätzen:

    REVISION1=PERCENTAGE1,REVISION2=PERCENTAGE2,REVISIONn=PERCENTAGEx.

    Beispiel: my-worker-pool-s5sxn=10,my-worker-pool-cp9kw=90.

Instanzen der neuesten Überarbeitung zuweisen

Wenn Sie eine neue Überarbeitung bereitstellen, können Sie dieser Überarbeitung und allen zukünftigen Überarbeitungen 100% der Instanzen zuweisen. Damit wird jede bestehende Instanzaufteilung überschrieben. Führen Sie die folgenden Befehle aus, um der neuesten Überarbeitung 100% der Instanzen zuzuweisen:

  • Verwenden Sie das Flag --to-latest, um 100% der Instanzen an die neueste Überarbeitung weiterzuleiten und alle Instanzen automatisch jeder neuen Überarbeitung zuzuweisen, die Sie bereitstellen:

    gcloud beta run worker-pools update-instance-split WORKER_POOL --to-latest

  • Optional können Sie das Flag --to-revisions mit dem Schlüsselwort LATEST verwenden, um der neuesten Überarbeitung immer einen variablen Prozentsatz von Instanzen zuzuweisen, wenn Sie eine bereitstellen. Führen Sie den folgenden Befehl aus, um einen Prozentsatz von Instanzen festzulegen, die immer der neuesten Überarbeitung zugewiesen werden:

    gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=LATEST=PERCENTAGE

    Ersetzen Sie Folgendes:

    • WORKER_POOL: Der Name des Worker-Pools.
    • PERCENTAGE: Der Prozentsatz der Instanzen, die für die neuesten und zukünftigen neuesten Überarbeitungen zugewiesen werden sollen.

Nächste Schritte