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:
-
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.
Umgebungsvariablen festlegen
Sie können Umgebungsvariablen mit der Google Cloud CLI festlegen, wenn Sie einen neuen Worker-Pool erstellen oder eine neue Überarbeitung bereitstellen:
gcloud
Wenn Sie Umgebungsvariablen beim Bereitstellen Ihres Worker-Pools angeben möchten, verwenden Sie das Flag --set-env-vars
:
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2
Ersetzen Sie:
- WORKER_POOL: der Name Ihres Worker-Pools
- KEY1=VALUE1,KEY2=VALUE2: Eine durch Kommas getrennte Liste der Variablennamen und ‑werte.
- IMAGE_URL durch einen Verweis auf das Container-Image, das den Worker-Pool enthält, z. B.
us-docker.pkg.dev/cloudrun/container/worker-pool:latest
.
Umgebungsvariablen aktualisieren
Sie können Laufzeit-Umgebungsvariablen für vorhandene Dienste aktualisieren. Bei diesem nicht destruktiven Ansatz werden Laufzeit-Umgebungsvariablen geändert oder hinzugefügt, jedoch nicht gelöscht.
gcloud
Verwenden Sie das Flag --update-env-vars
, um Umgebungsvariablen eines vorhandenen Worker-Pools zu aktualisieren:
gcloud beta run worker-pools update WORKER_POOL --update-env-vars KEY1=VALUE1,KEY2=VALUE2
Ersetzen Sie:
- WORKER_POOL: der Name Ihres Worker-Pools
- KEY1=VALUE1,KEY2=VALUE2: Eine durch Kommas getrennte Liste der Variablennamen und ‑werte.
Umgebungsvariablen löschen
gcloud
Wenn Sie Umgebungsvariablen selektiv aus einem vorhandenen Worker-Pool entfernen möchten, verwenden Sie das Flag --remove-env-vars
:
gcloud beta run worker-pools update WORKER_POOL --remove-env-vars KEY1,KEY2
Ersetzen Sie:
- 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 beta run worker-pools update WORKER_POOL --clear-env-vars
Ersetzen Sie WORKER_POOL durch den Namen Ihres Worker-Pools.
Konfiguration der Umgebungsvariablen für den Worker-Pool ansehen
Rufen Sie in der Google Cloud Console Cloud Run auf:
Klicken Sie auf Worker-Pools, um die Liste der bereitgestellten Worker-Pools aufzurufen.
Klicken Sie auf den Worker-Pool, den Sie untersuchen möchten, um den zugehörigen Detailbereich aufzurufen.
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 Informationen finden Sie in der Buildpack-Dokumentation für: