Umgebungsvariablen sind nützlich, um deine Anwendung mit Informationen von außerhalb der Anwendung zu versorgen. Sie werden normalerweise verwendet, um Dinge wie Datenbankverbindungsdetails und API-Schlüssel festzulegen.

Umgebungsvariablen für deine Anwendung.
Umgebungsvariablen für deine Anwendung.

Hinzufügen von Umgebungsvariablen

Umgebungsvariablen können im Schritt Anwendungsdetails beim Hinzufügen einer Anwendung oder auf der Seite Einstellungen deiner Anwendung nach der Bereitstellung hinzugefügt werden.

Sonderzeichen in Umgebungsvariablen

Umgebungsvariablen werden wörtlich übernommen, mit Ausnahme von Kommata und Anführungszeichen. Kommata werden als Trennzeichen interpretiert, und nicht abgeschnittene Anführungszeichen werden entweder nicht beachtet oder führen dazu, dass der Rollout-Prozess fehlschlägt.

  • Ein Beispiel: "my_example_variable" wird angewendet als: my_example_variable.
  • Wenn doppelte Anführungszeichen innerhalb einer Zeichenkette stehen (z. B. my_exampl "e_text), schlägt der Rollout-Vorgang fehl.
  • Um doppelte Anführungszeichen um eine Variable herum beizubehalten, musst du sie mit einem Backslash (\) abschließen. Zum Beispiel: \"my_example_var\" wird angewendet als: "my_example_var".
  • Doppelte Anführungszeichen innerhalb von Strings können ebenfalls mit Escaping behandelt werden, damit der Rollout-Prozess abgeschlossen werden kann. Zum Beispiel: my_examp\"le_var wird angewendet als: my_examp "le_var.

In den Anwendungsdetails

Um beim Hinzufügen deiner Anwendung Umgebungsvariablen hinzuzufügen, erweitere den Abschnitt Umgebungsvariablen, gib die Schlüssel-Wert-Paare ein und wähle aus, ob die Variablen während der Laufzeit und/oder des Build-Prozesses verfügbar sein sollen.

Füge Details zur Anwendung hinzu.
Füge Details zur Anwendung hinzu.

Nach der Bereitstellung

Um nach der Bereitstellung Umgebungsvariablen hinzuzufügen, gehe auf die Seite Einstellungen deiner Anwendung, scrolle zum Abschnitt Umgebungsvariablen und klicke auf Umgebungsvariable hinzufügen. Füge die Schlüssel-Wert-Paare im Modal/Pop-up-Fenster Umgebungsvariable hinzufügen hinzu und wähle aus, ob die Variablen während der Laufzeit und/oder des Build-Prozesses verfügbar sein sollen.

Füge ein Schlüssel-Wert-Paar für eine Umgebungsvariable hinzu.
Füge ein Schlüssel-Wert-Paar für eine Umgebungsvariable hinzu.

Verwendung von Umgebungsvariablen

Wie du Umgebungsvariablen verwendest, hängt von deiner Anwendung ab. In Node kannst du zum Beispiel mit process.env.API_KEY auf eine Variable namens API_KEY zugreifen. In PHP würdest du getenv('API_KEY') verwenden.

Von Kinsta gesetzte Umgebungsvariablen

Kinsta stellt immer PORT als den vom Webserver verwendeten Port ein. Wenn du möchtest, dass deine Anwendung mit dem Webserver interagiert, musst du diese Umgebungsvariable verwenden. In Node würdest du zum Beispiel so einen Server starten:

app.listen(process.env.PORT, () => {
console.log("Weather server is up and running")
})

Von Kinsta nicht gesetzte Umgebungsvariablen

Standardmäßig ist die Umgebungsvariable NODE_ENV für Node.js-Anwendungen nicht auf Produktion gesetzt; du musst diese Umgebungsvariable manuell hinzufügen.

Beispiele für die Umgebungsvariablensprache

Wie du Umgebungsvariablen verwendest, hängt von deiner Anwendung ab. Die folgende Tabelle zeigt, wie eine Umgebungsvariable namens API_KEY in verschiedenen Sprachen aufgerufen werden kann:

Sprache Code
Ruby ENV["API_KEY"]
Node.js process.env.API_KEY;
Python os.environ.get('API_KEY')
Java System.getenv("API_KEY");
Scala System.getenv("API_KEY");
PHP getenv('API_KEY');
Go os.Getenv("API_KEY")