Umgebungsvariablen, getrennt von Ihrem Code

Speichern Sie Tokens, Passwörter und Verbindungs-Strings in den Einstellungen jeder Anwendung. Werte bleiben auf dem Bildschirm maskiert, eine .env ist mit einem Einfügen übernommen, und ein Neustart übernimmt die Änderung ohne neuen Upload.

Jetzt startenAPI-Referenz
Bis zu 256 Variablen pro Anwendung, in jedem Plan. Auch über die CLI und die API.

So funktioniert es

Variablen gehören zur Anwendung, nicht zu den Dateien, die Sie hochladen. Ändern Sie eine, und der nächste Start verwendet sie.

  1. 1

    Hinzufügen oder einfügen

    Geben Sie einen Schlüssel und seinen Wert ein, fügen Sie KEY=Wert-Zeilen in ein Schlüsselfeld ein oder importieren Sie eine .env-Datei.

  2. 2

    Speichern

    Ein Speichern sendet die ganze Liste. Werte, die die Shell trennen oder erweitern würde, werden dabei in Anführungszeichen gesetzt.

  3. 3

    Neu starten

    Direkt nach dem Speichern bietet das Dashboard einen Neustart an. Die Anwendung startet mit den neuen Werten, ohne neuen Upload.

Secrets bleiben auf dem Bildschirm verborgen

Der Editor in den Einstellungen Ihrer Anwendung maskiert jeden Wert, bis Sie ihn anzeigen lassen, und hält zusammengehörige Schlüssel beieinander.

  • Maskierte Werte

    Werte erscheinen als Punkte. Zeigen Sie einen über das Auge an, kopieren Sie ihn, ohne ihn anzuzeigen, oder klicken Sie zum Bearbeiten darauf.

    • Jede Änderung wird einzeln bestätigt oder verworfen
    • Mit gedrückter Umschalttaste eine Zeile per Klick entfernen

  • Nach Präfix gruppiert

    Schlüssel mit gemeinsamem Präfix, etwa DB_HOST und DB_USER, stehen zusammen, alphabetisch sortiert.

    • Suche nach Schlüssel ab mehr als 15 Variablen
    • Ein Hinweis erscheint, wenn nur noch wenige Plätze frei sind

  • Square-Cloud-Standard

    HOST, PORT und SQUARECLOUD_APP_ID gehören zu jeder Anwendung, schreibgeschützt und mit einem Hinweis, wofür sie da sind.

    • HOST 0.0.0.0 und PORT 80 für HTTP
    • Die eigene ID der Anwendung für Ihren Code
  • Bis zu 256 Variablen pro Anwendung
  • Schlüssel bis 1.024 Zeichen, Werte bis 4.096
  • In einem Workspace öffnen nur Admins den Editor
  • In jedem Plan enthalten

Bringen Sie Ihre vorhandene .env mit

Importieren Sie eine .env-Datei und prüfen Sie sie, bevor sich etwas ändert: neue Schlüssel, Schlüssel, die ersetzt würden, und Zeilen, die nicht übernommen werden können, jeweils mit Zeilennummer und Grund.

  • Ganze Zeilen einfügen

    Fügen Sie mehrere KEY=Wert-Zeilen in ein Schlüsselfeld ein, und jede wird zu einer Zeile. Ein vorhandener Schlüssel übernimmt den eingefügten Wert.

    • Kommentare und das Präfix export werden berücksichtigt
    • Einfügen in eine ausgefüllte Zeile behält diese Variable

  • Schon beim Deploy festlegen

    Das Deploy-Formular nimmt ebenfalls Variablen an und bietet, wenn Ihr Projekt eine .env.example enthält, deren Schlüssel zum Ausfüllen an.

    • Liest auch .env.sample, .env.template und .env.dist
    • Überlässt HOST und PORT Square Cloud

  • Exportieren oder kopieren

    Laden Sie alle Variablen als KEY=VALUE-Textdatei herunter oder kopieren Sie alle auf einmal, um sie in eine andere Anwendung zu übernehmen.

    • Werte kommen in Anführungszeichen, ladebereit
    • Zeilen ohne Schlüssel bleiben außen vor

Werte erreichen Ihren Code so, wie Sie sie eingegeben haben

Ihre Anwendung lädt ihre Variablen über eine Shell, in der ein Leerzeichen, ein $ oder ein ; einen Wert abschneiden oder verändern kann. Der Editor setzt solche Werte für Sie in Anführungszeichen.

  • Anführungszeichen, wo nötig

    Ein Wert mit Leerzeichen oder Zeichen wie $, &, ;, | oder ) kommt in einfache Anführungszeichen, wenn Sie ihn bestätigen, importieren oder speichern.

  • Riskante Anführungszeichen abgelehnt

    Doppelte Anführungszeichen um einen Wert mit $ ließen die Shell ihn erweitern, daher bittet der Editor Sie, sie zu entfernen oder einfache zu verwenden.

  • Gültige Schlüssel

    Leerzeichen in einem Schlüssel werden zu Unterstrichen, und ein Schlüssel darf nicht doppelt vorkommen. Beim Import muss ein Schlüssel mit einem Buchstaben oder _ beginnen.

Über das Terminal und die API

Dieselben Variablen erreichen Sie über die CLI, die GitHub Action, die VS Code-Erweiterung und die REST-API.

Square Cloud CLI
squarecloud app env set DB_HOST=10.0.0.4 "GREETING=hi there"squarecloud app env set --from-file .envsquarecloud app env list

Seit Version 3.1.1 setzt die CLI Werte mit Leerzeichen oder Symbolen für Sie in Anführungszeichen. Alles, was die CLI kann.

REST-API
curl -X POST "https://api.squarecloud.app/v2/apps/$APP_ID/envs" \  -H "Authorization: $SQUARECLOUD_API_KEY" \  -H "Content-Type: application/json" \  -d '{"envs": {"NODE_ENV": "production", "LOG_LEVEL": "info"}}'curl -X POST "https://api.squarecloud.app/v2/apps/$APP_ID/restart" \  -H "Authorization: $SQUARECLOUD_API_KEY"

Senden Sie Werte so, wie die Shell sie lesen soll, in einfachen Anführungszeichen, wenn sie Leerzeichen oder Symbole enthalten. Ein Neustart übernimmt sie.

  • GET
    /v2/apps/{appId}/envs

    Listet die Umgebungsvariablen der Anwendung auf.

  • POST
    /v2/apps/{appId}/envs

    Fügt Variablen hinzu oder ändert vorhandene. Die übrigen bleiben unverändert.

  • PUT
    /v2/apps/{appId}/envs

    Ersetzt alle Variablen durch die gesendeten.

  • DELETE
    /v2/apps/{appId}/envs

    Entfernt die angegebenen Variablen.

  • API-Schlüssel lassen sich auf envs:read oder envs:write und auf eine einzelne Anwendung beschränken.
API-Referenz

Fragen zu Umgebungsvariablen

Was sind Umgebungsvariablen bei Square Cloud?

Schlüssel-Wert-Paare, die in den Einstellungen Ihrer Anwendung gespeichert und beim Start geladen werden. Sie halten Tokens, Passwörter und Verbindungs-Strings aus Ihrem Code und aus den hochgeladenen Dateien heraus. Jede Anwendung hat ihre eigene Liste mit bis zu 256 Variablen.

Muss ich nach dem Ändern einer Variable neu deployen?

Nein. Speichern Sie die Änderung und starten Sie die Anwendung neu: Sie startet mit den neuen Werten, ohne neuen Upload. Bis zum Neustart behält der laufende Prozess die Werte, mit denen er gestartet ist.

Welche Variablen stellt Square Cloud bereit?

HOST (0.0.0.0), PORT (80) und SQUARECLOUD_APP_ID, die eigene ID der Anwendung. Sie stehen schreibgeschützt oben im Editor. Eine Webanwendung, die auf diesem Host und Port lauscht, ist über HTTP erreichbar.

Wie speichere ich einen Wert mit Leerzeichen, Anführungszeichen oder $?

Geben Sie ihn so ein, wie er ist. Dashboard und CLI setzen solche Werte in einfache Anführungszeichen, damit die Shell sie unverändert lädt. Über die API senden Sie sie bereits in einfachen Anführungszeichen. Vermeiden Sie doppelte Anführungszeichen um einen Wert mit $: Die Shell würde ihn erweitern.

Kann ich eine .env-Datei im Projekt behalten?

Ja, aber importieren Sie sie besser im Dashboard: Die dort gesetzten Variablen haben Vorrang vor den Werten in dieser Datei. Um die Datei aus Ihren Uploads herauszuhalten, tragen Sie sie in squarecloud.ignore ein, das die CLI und die VS Code-Erweiterung lesen.

Wer kann die Werte sehen?

In Ihrem Konto nur Sie. In einem Workspace öffnen nur Mitglieder mit Admin-Berechtigung den Editor. Ein API-Schlüssel braucht den Scope envs:read oder vollen Zugriff, um sie zu lesen.

Wie viele Variablen kann eine Anwendung haben?

Bis zu 256, mit Schlüsseln bis 1.024 Zeichen und Werten bis 4.096. Der Editor warnt Sie, wenn nur noch wenige Plätze frei sind, und speichert nicht über das Limit hinaus.

Haben statische Websites Umgebungsvariablen?

Nein. Eine statische Website wird als Dateien ausgeliefert, ohne Prozess, der sie lesen könnte, daher haben ihre Einstellungen keinen Variablen-Tab. Sie sind für Anwendungen mit Runtime gedacht, etwa Node.js, Python, Java, Go oder Rust.

Ein Plan für jede Phase Ihres Projekts

Starten Sie klein und skalieren Sie bei Bedarf – ohne Vertragsbindung.

Alle Pläne vergleichen

4,9 von 5 · 402 Bewertungen auf Google + TrustpilotTrustpilot

Gehostet in einem Partner-Rechenzentrum mit den Zertifizierungen
Tier 3ISO 27001SOC 2 Type IIAlways-On-DDoS-Schutz
Entdecken Sie unsere Infrastruktur

Bereit, Ihr Projekt zu skalieren?

Schließen Sie sich den mehr als 500.000 Entwicklern an, die Square Cloud für das Hosting ihrer Projekte genutzt haben.

Jetzt mit Square Cloud startenPläne und Preise ansehen
  • Vorhersehbare Preise
  • Keine Überraschungen bei der Abrechnung
  • Deploy in Sekunden
  • Hohe Verfügbarkeit
  • Stabil skalieren
  • Automatischer Neustart
  • SSL und Sicherheit inklusive
  • Isolierte Container