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 das Aufteilen von Instanzen.

Mit 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 Version durchführen, Instanzen auf mehrere Versionen aufteilen und Instanzen der neuesten Version zuweisen. Auf dieser Seite wird beschrieben, wie Sie mit diesem Feature die Instanzzuweisung für Ihre 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. In-Flight-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 Instanz-Splits

Wenn Sie Instanzen auf mehrere Überarbeitungen aufteilen oder Instanzen einer früheren Überarbeitung zuweisen, wird dieses Muster für alle nachfolgenden Bereitstellungen verwendet. Wenn Sie wieder nur die neueste Überarbeitung ohne Instanzaufteilung verwenden möchten, leiten Sie alle Instanzen an die neueste Überarbeitung weiter.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Run Developer (roles/run.developer) für Ihren Cloud Run-Workerpool zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Verwalten von Cloud Run-Workerpools und -Workerpool-Versionen 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-Workerpool mitGoogle 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

Wenn Sie zu einer früheren Version zurückkehren möchten, verwenden Sie die Google Cloud Console oder die Google Cloud CLI:

Console

  1. Rufen Sie in der Google Cloud Console Cloud Run-Workerpools 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 aufzurufen.

  4. Klicken Sie auf Instanz-Splits verwalten, um das Formular zum Verwalten von Instanzen aufzurufen. In Cloud Run wird die letzte bereitgestellte Ü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 frühere Ü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 Versionen an, auf die ein Rollback durchgeführt werden soll, indem Sie den folgenden Befehl ausführen.

   gcloud 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

Wenn Sie Instanzen auf zwei oder mehr Überarbeitungen aufteilen möchten, verwenden Sie die Google Cloud Console oder die Google Cloud CLI:

Wenn Sie Instanzen auf mehrere Überarbeitungen aufteilen, muss die Summe der Prozentsätze aller Überarbeitungen 100 % ergeben. Außerdem muss die Anzahl der manuellen Instanzen größer sein als die Anzahl der Instanzaufteilungen, die die Arbeitslast bedienen.

Console

  1. Rufen Sie in der Google Cloud Console Cloud Run-Workerpools 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 aufzurufen.

  4. Klicken Sie auf Instanz-Splits verwalten, um das Formular zum Verwalten von Instanzen aufzurufen. In Cloud Run wird die letzte bereitgestellte Ü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. indem Sie ihn von 100 % reduzieren.

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

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

    4. Klicken Sie auf Speichern.

gcloud

Geben Sie die Überarbeitungen und den Prozentsatz der Instanzen mit dem folgenden Befehl an. Weisen Sie jeder Version Instanzen zu in einer durch Kommas getrennten Liste:

   gcloud 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 100% der Instanzen der neuesten Revision zuzuweisen:

  • Mit dem Flag --to-latest werden 100% der Instanzen an die neueste Version weitergeleitet und alle Instanzen automatisch einer neuen Version zugewiesen, die Sie bereitstellen:

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

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

    gcloud 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 Revisionen zugewiesen werden sollen.

Nächste Schritte