Umgebungsvariablen und Secrets verwalten

In diesem Thema erfahren Sie, wie Sie Umgebungsvariablen und Secrets in Ihrem Cloud Foundry Space verwalten. Umgebungsvariablen sind der Weg, über den Sie und die Plattform mit Ihrer Anwendung kommunizieren. Sowohl Cloud Foundry als auch Sie selbst können Umgebungsvariablen setzen, die von der Anwendung im Staging-Prozess gelesen und innerhalb der Anwendung verwendet werden.

Möchten Sie STACKIT Cloud Foundry nur einmal ausprobieren, ohne bereits eine cloud-fähige Anwendung vorbereitet zu haben?

Dann können Sie einfach eine der Beispielanwendungen der Cloud Foundry Open Source Community für Demo-Zwecke verwenden. Diese finden Sie im GitHub Repository.

Umgebungsvariablen mit der CF CLI auslesen

Sobald Sie mit der CF CLI in Ihrem Space angemeldet sind, können Sie die Umgebungsvariablen Ihrer Anwendung mit folgendem Befehl einfach auslesen:

cf env

Dieser Befehl gibt alle Umgebungsvariablen aus, die zu den folgenden drei Typen gehören:

• VCAP_APPLICATION - eine Liste systemseitig gesetzter Umgebungsvariablen rund um Ihre Anwendung.
• VCAP_SERVICES - eine Liste systemseitig gesetzter Umgebungsvariablen rund um Ihre gebundenen Datendienste.
• Benutzerdefinierte Variablen, gesetzt von Nutzern mit mindestens der Rolle SpaceDeveloper.

Zusätzlich kann es plattformspezifische Umgebungsvariablen geben, die von den STACKIT Cloud Foundry Plattformbetreibern in sogenannten Environment Variable Groups gesetzt werden. Mehr über Systemvariablen erfahren Sie in der offiziellen Cloud Foundry Dokumentation.

In VCAP_SERVICES sind die Verbindungsdaten zu Ihren Datendiensten enthalten, sobald diese an Ihren Space gebunden sind.

Umgebungsvariablen mit der CF CLI setzen und entfernen

Sobald Sie mit der CF CLI in Ihrem Space angemeldet sind, können Sie Umgebungsvariablen Ihrer Anwendung mit folgendem Befehl setzen:

cf set-env <APP_NAME> <ENV_VAR_NAME> <ENV_VAR_VALUE>

Sie müssen Variablennamen mit alphanumerischen Zeichen und Unterstrichen bilden. Nicht konforme Variablennamen können zu unvorhersehbarem Verhalten führen.

Nachdem Sie neue Umgebungsvariablen gesetzt haben, müssen Sie Ihre Anwendung neu stagen, damit sie diese einliest. Das geht einfach mit:

cf restage <APP_NAME>

Sie können Umgebungsvariablen mit dem folgenden Befehl wieder entfernen:

cf unset-env <APP_NAME> <ENV_VAR_NAME> <ENV_VAR_VALUE>

Danach müssen Sie Ihre Anwendung erneut neu stagen.

Umgebungsvariablen über die Manifest-Datei setzen

Sie können Umgebungsvariablen auch über die Manifest-Datei setzen, wenn Sie Ihre Anwendung in Cloud Foundry pushen.

Fügen Sie diese dazu einem env-Block in der manifest.yml hinzu, wie im folgenden Beispiel:

---
  ...
  env:
  RAILS_ENV: production
  RACK_ENV: production

Sie müssen Variablennamen mit alphanumerischen Zeichen und Unterstrichen bilden. Nicht konforme Variablennamen können zu unvorhersehbarem Verhalten führen.

Secrets

Cloud Foundry speichert die Konfiguration einer App in einer verschlüsselten Datenbanktabelle. Diese Konfigurationsdaten umfassen benutzerdefinierte Umgebungsvariablen und Service-Zugangsdaten für alle an die App gebundenen Services.

Alle Apps laufen in einem sicheren Container. Weitere Informationen finden Sie in der Cloud Foundry Dokumentation zur Container Security.

Ihre Umgebungsvariablen sind also geschützt. Genau aus diesem Grund speichert Cloud Foundry auch die Verbindungsdaten zu Ihren gebundenen Datendiensten in diesen Umgebungsvariablen.

Beachten Sie dennoch, dass alle Umgebungsvariablen von allen Personen mit mindestens der Rolle SpaceDeveloper in Ihrer Org und Ihrem Space gelesen werden können. Für wirklich kritische Secrets kann es sinnvoll sein, einen Secret Store wie HashiCorp Vault als User-Provided Service zu nutzen.