Umgebungsvariablen für Worker-Pools konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Umgebungsvariablen für Ihren Cloud Run-Worker-Pool konfigurieren.

Jede Konfigurationsänderung führt zur Erstellung einer neuen Überarbeitung. Für nachfolgende Überarbeitungen gilt automatisch dieselbe Konfigurationseinstellung, sofern Sie sie nicht explizit aktualisieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren und Bereitstellen von Cloud Run-Worker-Pools benötigen:

• Rolle Cloud Run-Entwickler (roles/run.developer) im Cloud Run-Worker-Pool
• Dienstkontonutzer (roles/iam.serviceAccountUser) für die Dienstidentität

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.

Warnung :Wenn Ihr Cloud Run-Worker-Pool die Dienstidentität verwendet, um den Zugriff auf Google Cloud -APIs zu authentifizieren, legen Sie niemals GOOGLE_APPLICATION_CREDENTIALS als Umgebungsvariable in einem Cloud Run-Worker-Pool fest. Konfigurieren Sie stattdessen immer ein nutzerverwaltetes Dienstkonto.

Umgebungsvariablen festlegen

Sie können Umgebungsvariablen für einen Cloud Run-Worker-Pool über dieGoogle Cloud Console, die Google Cloud CLI, YAML oder Terraform festlegen:

Console

1. Rufen Sie in der Google Cloud Console die Seite „Cloud Run“ auf:

   Zu Cloud Run

2. Wählen Sie im Cloud Run-Navigationsmenü Worker-Pools aus:

   1. Wenn Sie einen vorhandenen Worker-Pool konfigurieren möchten, klicken Sie auf den Worker-Pool und dann auf Neue Überarbeitung bearbeiten und bereitstellen.

   2. Wenn Sie einen neuen Workerpool konfigurieren, klicken Sie auf Container bereitstellen und füllen Sie dann die Seite mit den anfänglichen Workerpooleinstellungen aus. Klicken Sie dann auf Container, Netzwerk, Sicherheit, um die Konfigurationsseite für Worker-Pools zu maximieren.

3. Klicken Sie auf den Tab Variablen und Secrets.

4. Klicken Sie auf Variable hinzufügen, um eine neue Umgebungsvariable hinzuzufügen.

   1. Geben Sie im Feld Name den Namen der Umgebungsvariable ein.

   2. Geben Sie im Feld Wert den Wert der Umgebungsvariablen ein.

      Weitere Informationen zum Festlegen mehrerer Umgebungsvariablen oder zum Escapen von Sonderzeichen finden Sie unter Mehrere Umgebungsvariablen festlegen.

   3. Klicken Sie auf Fertig.

5. Klicken Sie auf Erstellen oder Bereitstellen.

gcloud

Wenn Sie Umgebungsvariablen beim Bereitstellen Ihres Worker-Pools angeben möchten, verwenden Sie das Flag --set-env-vars:

gcloud run worker-pools deploy WORKER_POOL --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

Ersetzen Sie Folgendes:

• WORKER_POOL: der Name Ihres Worker-Pools
• KEY1=VALUE1,KEY2=VALUE2: Eine durch Kommas getrennte Liste mit Variablennamen und ‑werten.
• IMAGE_URL: ein Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest

Weitere Informationen zum Festlegen mehrerer Umgebungsvariablen oder zum Escapen von Sonderzeichen finden Sie unter Mehrere Umgebungsvariablen festlegen.

YAML

1. Wenn Sie einen neuen Worker-Pool erstellen, überspringen Sie diesen Schritt. Wenn Sie einen vorhandenen Worker-Pool aktualisieren, laden Sie die zugehörige YAML-Konfiguration herunter:

   gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml

2. Das folgende Beispiel enthält die YAML-Konfiguration:

   apiVersion: run.googleapis.com/v1
   kind: WorkerPool
   metadata:
     name: WORKER_POOL
   spec:
     template:
       spec:
         containers:
         - name:
           image: IMAGE_URL
           env:
           - name: NAME
             value: VALUE
           - name: NAME2
             value: VALUE2

   Ersetzen Sie Folgendes:

   • WORKER_POOL: Der Name Ihres Cloud Run-Worker-Pools.
   • IMAGE_URL: ein Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest
   • NAME und VALUE: Name und Werte der Umgebungsvariablen.

3. Erstellen oder aktualisieren Sie den Worker-Pool mit dem folgenden Befehl:

   gcloud run worker-pools replace worker-pool.yaml

   Der Befehl gcloud run worker-pools replace verwendet standardmäßig die Datei worker-pool.yaml, sofern sie vorhanden ist.

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
      env {
        name  = "KEY1"
        value = "VALUE1"
      }
      env {
        name  = "KEY2"
        value = "VALUE2"
      }
    }
  }
}

Ersetzen Sie Folgendes:

• WORKER_POOL: der Name des Worker-Pools.
• REGION: die Google Cloud Region, z. B. europe-west1
• IMAGE_URL: ein Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• KEY1 und VALUE1: Die Umgebungsvariable und der Wert. Fügen Sie bei Bedarf weitere Variablen und Werte hinzu.

Standardumgebungsvariablen im Container festlegen

Sie können die ENV-Anweisung in einer Dockerfile verwenden, um Standardwerte für Umgebungsvariablen festzulegen:

ENV KEY1=VALUE1,KEY2=VALUE2

Reihenfolge der Priorität: Container- im Vergleich zu Worker-Pool-Variablen

Wenn im Container eine Standard-Umgebungsvariable und für den Cloud Run-Worker-Pool eine Umgebungsvariable mit demselben Namen festgelegt ist, hat der für den Worker-Pool festgelegte Wert Vorrang.

Mehrere Umgebungsvariablen festlegen

Sie können mehrere Umgebungsvariablen mit der Datei .env oder dem Flag --set-env-vars festlegen.

Mehrere Umgebungsvariablen mit der Datei .env festlegen

Console

1. Rufen Sie in der Google Cloud Console die Seite „Cloud Run“ auf:

   Zu Cloud Run

2. Wählen Sie im Cloud Run-Navigationsmenü Worker-Pools aus:

   1. Wenn Sie einen vorhandenen Worker-Pool konfigurieren möchten, klicken Sie auf den Worker-Pool und dann auf Neue Überarbeitung bearbeiten und bereitstellen.

   2. Wenn Sie einen neuen Workerpool konfigurieren, klicken Sie auf Container bereitstellen und füllen Sie dann die Seite mit den anfänglichen Workerpooleinstellungen aus. Klicken Sie dann auf Container, Netzwerk, Sicherheit, um die Konfigurationsseite für Worker-Pools zu maximieren.

3. Klicken Sie auf den Tab Variablen und Secrets.

4. Klicken Sie auf Variable hinzufügen.

5. Fügen Sie im Feld Name den Inhalt Ihrer .env-Datei ein. Cloud Run füllt das Feld Wert automatisch aus und erstellt neue Variablen für jedes Schlüssel/Wert-Paar, das Sie in der Datei .env definieren.

6. Klicken Sie auf Fertig.

7. Klicken Sie auf Erstellen oder Bereitstellen.

gcloud

Wenn Sie mehrere Umgebungsvariablen aus der Datei .env angeben möchten, führen Sie den folgenden Befehl aus:

gcloud run worker-pools deploy WORKER_POOL --image IMAGE_URL --env-vars-file=ENV_FILE_PATH

Ersetzen Sie Folgendes:

• WORKER_POOL: der Name des Worker-Pools.
• IMAGE_URL: ein Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• ENV_FILE_PATH: Pfad zur Datei .env.

Mehrere Umgebungsvariablen mit dem Flag --set-env-vars festlegen

Wenn Sie mehrere Umgebungsvariablen haben, die nicht im Format KEY1=VALUE1,KEY2=VALUE2 aufgelistet werden können, können Sie das Flag --set-env-vars mehrmals wiederholen:

   [...]
   --set-env-vars "KEY1=VALUE1" \
   --set-env-vars "KEY2=VALUE2" \
   --set-env-vars "KEY3=VALUE3"

Escape-Zeichen

Da das Komma , verwendet wird, um Umgebungsvariablen aufzuteilen, wenn Ihre Umgebungsvariable Kommas als Werte enthält, müssen Sie diese Trennzeichen vermeiden und ein anderes Trennzeichen angeben, zum Beispiel @:

--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

Umgebungsvariablen aktualisieren

Sie können Laufzeit-Umgebungsvariablen für vorhandene Worker-Pools aktualisieren. Bei diesem nicht destruktiven Ansatz werden Laufzeit-Umgebungsvariablen geändert oder hinzugefügt, jedoch nicht gelöscht.

Sie können Umgebungsvariablen in der Google Cloud Console, der Google Cloud CLI, YAML oder Terraform aktualisieren:

Console

1. Rufen Sie in der Google Cloud Console Cloud Run auf:

   Zu Cloud Run

2. Wählen Sie im Menü Worker-Pools aus, klicken Sie auf den Worker-Pool, den Sie aktualisieren möchten, und dann auf Neue Überarbeitung bearbeiten und bereitstellen.

3. Klicken Sie auf Container, Netzwerk, Sicherheit, um die Konfigurationsseite für Worker-Pools zu maximieren.

4. Klicken Sie auf den Tab Variablen und Secrets.

5. Suchen Sie die Umgebungsvariable, die Sie aktualisieren möchten, und geben Sie dann einen anderen Namen für die Variable oder einen anderen Wert in den Feldern Name und Wert an.

6. Klicken Sie auf Bereitstellen.

gcloud

Verwenden Sie das Flag --update-env-vars, um Umgebungsvariablen eines vorhandenen Worker-Pools zu aktualisieren:

gcloud run worker-pools update WORKER_POOL --update-env-vars KEY1=VALUE1,KEY2=VALUE2

Ersetzen Sie Folgendes:

• WORKER_POOL: der Name Ihres Worker-Pools
• KEY1=VALUE1,KEY2=VALUE2: Eine durch Kommas getrennte Liste mit Variablennamen und ‑werten.

YAML

1. Laden Sie die YAML-Konfiguration für den Worker-Pool herunter:

   gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml

2. Bearbeiten Sie die Variablen für Name und Wert.

3. Aktualisieren Sie den Worker-Pool mit dem folgenden Befehl:

   gcloud run worker-pools replace worker-pool.yaml

Terraform

Wenn Sie die Umgebungsvariablen eines vorhandenen Worker-Pools aktualisieren möchten, öffnen Sie die main.tf-Datei, die dem Worker-Pool entspricht, und bearbeiten Sie die Variablen „name“ und „value“. Führen Sie dann den Befehl aus, um die Terraform-Konfiguration anzuwenden.

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Umgebungsvariablen löschen

Console

1. Rufen Sie in der Google Cloud Console Cloud Run auf:

   Zu Cloud Run

2. Wählen Sie im Menü Worker-Pools aus, klicken Sie auf den Worker-Pool, den Sie aktualisieren möchten, und dann auf Neue Überarbeitung bearbeiten und bereitstellen.

3. Klicken Sie auf Container, Netzwerk, Sicherheit, um die Konfigurationsseite für Worker-Pools zu maximieren.

4. Klicken Sie auf den Tab Variablen und Secrets.

5. Suchen Sie die Umgebungsvariable, die Sie löschen möchten, und klicken Sie rechts neben dem Feld Wert auf das Papierkorbsymbol, um die Umgebungsvariable zu löschen.

6. Klicken Sie auf Bereitstellen.

gcloud

Wenn Sie Umgebungsvariablen selektiv aus einem vorhandenen Worker-Pool entfernen möchten, verwenden Sie das Flag --remove-env-vars:

gcloud run worker-pools update WORKER_POOL --remove-env-vars KEY1,KEY2

Ersetzen Sie Folgendes:

• WORKER_POOL: der Name Ihres Worker-Pools
• KEY1,KEY2: Die durch Kommas getrennte Liste der Variablennamen.

Alternativ können Sie alle zuvor festgelegten Umgebungsvariablen mit dem Flag --clear-env-vars löschen:

gcloud run worker-pools update WORKER_POOL --clear-env-vars

Ersetzen Sie WORKER_POOL durch den Namen Ihres Worker-Pools.

Konfiguration von Umgebungsvariablen für den Worker-Pool ansehen

1. Rufen Sie in der Google Cloud Console Cloud Run auf:

   Zu Cloud Run

2. Klicken Sie auf Worker-Pools, um die Liste der bereitgestellten Worker-Pools aufzurufen.

3. Klicken Sie auf den Worker-Pool, den Sie untersuchen möchten, um den zugehörigen Detailbereich aufzurufen.

4. Klicken Sie auf den Tab Container, um die Containerkonfiguration des Worker-Pools aufzurufen.

Beispielcode

Ein Codebeispiel für den Zugriff auf Umgebungsvariablen in Ihrem Code finden Sie in der Anleitung zur Endnutzerauthentifizierung unter Mit Secret Manager vertrauliche Konfigurationen verwalten.

Nächste Schritte

Sie können Umgebungsvariablen verwenden, um eine Buildpacks-Konfiguration festzulegen. Sprachspezifische Details finden Sie in der Buildpack-Dokumentation für:

• Node.js
• Python
• Go
• Ruby
• PHP
• Java