Informationen zum Erstellen und Verwenden von Umgebungsvariablen in Cloud Run for Anthos.
Wenn Sie Umgebungsvariablen festlegen, werden diese in den Container eingefügt und sind für Ihren Code aufrufbar.
Umgebungsvariablen werden als Schlüssel/Wert-Paare festgelegt. Angenommen, Sie führen einen Dienst aus, der ein zusätzliches Logging ermöglicht, wenn LOGGING_VERBOSE: true
in der Umgebung gelesen wird. In diesem Szenario legen Sie das Schlüssel/Wert-Paar für die Umgebungsvariable auf LOGGING_VERBOSE=true
fest. In den folgenden Abschnitten sind die genauen Befehle oder die jeweilige UI aufgeführt.
Reservierte Namen
Die im Containerlaufzeitvertrag definierten Umgebungsvariablen sind reserviert. Sie können nicht festgelegt werden. Im Speziellen wird die Umgebungsvariable PORT
von Cloud Run for Anthos in Ihren Container eingefügt. Sie sollten die Variable nicht selbst festlegen.
Umgebungsvariablen für einen Dienst festlegen
Jede Konfigurationsänderung führt zur Erstellung einer neuen Überarbeitung. Für nachfolgende Überarbeitungen gilt automatisch dieselbe Konfigurationseinstellung, sofern Sie sie nicht explizit aktualisieren.
Sie können Umgebungsvariablen mit der Google Cloud Console, der Google Cloud CLI oder einer YAML-Datei festlegen, wenn Sie einen neuen Dienst bereitstellen oder einen vorhandenen Dienst aktualisieren und eine Überarbeitung bereitstellen:
Console
Rufen Sie Cloud Run for Anthos in der Google Cloud Console auf:
Klicken Sie auf Dienst erstellen, wenn Sie einen neuen Dienst für die Bereitstellung konfigurieren. Wenn Sie einen vorhandenen Dienst konfigurieren möchten, klicken Sie auf den Dienst und dann auf Neue Überarbeitung bearbeiten und bereitstellen.
Klicken Sie unter Erweiterte Einstellungen auf Variablen und Secrets.
Gehen Sie dazu so vor:
- Wenn Sie eine Variable hinzufügen, klicken Sie auf Variable hinzufügen. Dann geben Sie den gewünschten Namen für die Variable und ihren Wert in den Textfeldern Name und Wert an.
- Falls Sie einen Wert für eine Variable ändern möchten, ersetzen Sie den aktuellen Wert im Textfeld Wert durch den gewünschten neuen Wert.
- Möchten Sie eine oder mehrere Umgebungsvariablen entfernen, bewegen Sie den Cursor links neben das Textfeld Wert der Variablen, die Sie entfernen möchten. Daraufhin wird das Papierkorbsymbol angezeigt. Klicken Sie darauf.
Klicken Sie auf Weiter, um mit dem nächsten Abschnitt fortzufahren.
Wählen Sie im Abschnitt Konfigurieren, wie dieser Dienst ausgelöst wird die Verbindung aus, die Sie zum Auslösen des Dienstes verwenden möchten.
Klicken Sie auf Erstellen, um das Image in Cloud Run for Anthos bereitzustellen. Warten Sie dann, bis die Bereitstellung abgeschlossen ist.
Befehlszeile
Sie können das Google Cloud CLI verwenden, um Umgebungsvariablen für neue Dienste festzulegen oder vorhandene Dienste zu aktualisieren:
Aktualisieren Sie bei vorhandenen Diensten die Umgebungsvariablen, indem Sie den Befehl
gcloud run services update
mit einem der folgenden Parameter ausführen:Beispiel:
gcloud run services update SERVICE --update-env-vars KEY1=VALUE1,KEY2=VALUE2
Ersetzen Sie:
- SERVICE durch den Namen des Dienstes.
- KEY1=VALUE1,KEY2=VALUE2 durch eine durch Kommas getrennte Liste von Name und Wertpaaren für jede Umgebungsvariable. Geben Sie für KEY den Namen der Umgebungsvariablen und für VALUE den Wert dieser Umgebungsvariable an. So legen Sie mehrere Parameter fest.
-
Um eine Umgebungsvariable anzugeben, die ein Komma (
,
) enthält, müssen Sie jedes KEY=VALUE-Wertepaar mit einem Trennzeichen maskieren. Verwenden Sie beipielsweise@
:--set-env-vars "^@^KEY1=value,with,commas@KEY2=anothervalue@KEY3..."
-
Wenn Sie mehrere Gruppen von Schlüssel/Wert-Paaren angeben möchten, können Sie mehrere Parameter angeben, um die Lesbarkeit zu verbessern. Beispiel:
[...] --set-env-vars "KEY=VALUE1" \ --set-env-vars "KEY=VALUE2" \ --set-env-vars "KEY=VALUE3"
Optionen für Befehlsparameter
Legen Sie für neue Dienste die Umgebungsvariablen fest, indem Sie den Befehl
gcloud run deploy
mit dem Parameter--set-env-vars
ausführen:gcloud run deploy SERVICE --image=IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2
Ersetzen Sie:
- IMAGE_URL durch einen Verweis auf das Container-Image, z. B.
gcr.io/myproject/my-image:latest
. - SERVICE durch den Namen des Dienstes.
- KEY1=VALUE1,KEY2=VALUE2 durch eine durch Kommas getrennte Liste von Name und Wertpaaren für jede Umgebungsvariable. Geben Sie für KEY den Namen der Umgebungsvariablen und für VALUE den Wert dieser Umgebungsvariable an. So legen Sie mehrere Parameter fest.
-
Um eine Umgebungsvariable anzugeben, die ein Komma (
,
) enthält, müssen Sie jedes KEY=VALUE-Wertepaar mit einem Trennzeichen maskieren. Verwenden Sie beipielsweise@
:--set-env-vars "^@^KEY1=value,with,commas@KEY2=anothervalue@KEY3..."
-
Wenn Sie mehrere Gruppen von Schlüssel/Wert-Paaren angeben möchten, können Sie mehrere Parameter angeben, um die Lesbarkeit zu verbessern. Beispiel:
[...] --set-env-vars "KEY=VALUE1" \ --set-env-vars "KEY=VALUE2" \ --set-env-vars "KEY=VALUE3"
Optionen für Befehlsparameter
- IMAGE_URL durch einen Verweis auf das Container-Image, z. B.
YAML
Sie können die Konfiguration eines vorhandenen Dienstes in eine YAML-Datei herunterladen – mit dem gcloud run services describe
-Befehl mithilfe des Flags --format=export
.
Sie können diese YAML-Datei dann ändern und diese Änderungen mit dem Befehl gcloud beta run services replace
bereitstellen.
Sie müssen sicherstellen, dass Sie nur die angegebenen Attribute ändern.
Laden Sie die Konfiguration des Dienstes in eine Datei mit dem Namen
service.yaml
im lokalen Arbeitsbereich herunter:gcloud run services describe SERVICE --format export > service.yaml
SERVICE durch den Namen Ihres Cloud Run for Anthos-Dienstes.
Aktualisieren Sie in Ihrer lokalen Datei die Attribute
name
undvalue
unter dem Attributenv
unterhalb voncontainers:
:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: spec: containers: - env: - name: KEY-1 value: VALUE-1 - name: KEY-N value: VALUE-N
Ersetzen Sie:
- SERVICE durch den Namen Ihres Cloud Run for Anthos-Dienstes.
- KEY-1, VALUE-1 durch die Umgebungsvariable und den Wert. Fügen Sie bei Bedarf weitere Variablen und Werte hinzu.
Ersetzen Sie den Dienst mit dem folgenden Befehl durch die neue Konfiguration:
gcloud beta run services replace service.yaml
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: Containervariablen vs. Dienstvariablen
Wenn Sie im Container eine Standardumgebungsvariable und außerdem eine Umgebungsvariable mit demselben Namen für den Cloud Run for Anthos-Dienst festlegen, hat der für den Dienst festgelegte Wert Vorrang.
Links zu Kubernetes-Diensten aktivieren
Damit Sie die Kubernetes-Dienst-Links verwenden können, müssen Sie die Unterstützung manuell aktivieren. Aufgrund der Leistungsprobleme in Namespaces mit Tausenden von Diensten und Überarbeitungen wurden Links zu Kubernetes-Diensten ab Januar 2021 standardmäßig deaktiviert.
Führen Sie zum Aktivieren von Links zu Kubernetes-Diensten den folgenden Befehl aus, um data.enable-service-links
in der ConfigMap knative-serving/config-defaults
auf true
festzulegen:
kubectl patch cm -n knative-serving config-defaults -p '{"data":{"enable-service-links":"true"}}