Umgebungsvariablen.
Eigene Variablen und die, die Rivervo für Sie setzt, Produktion und Vorschauen, das Ersetzen eines automatischen Werts und wann Änderungen wirksam werden.
Schlüssel, Passwörter und Einstellungen Ihrer Anwendung liegen im Tab Variablen. Sie werden verschlüsselt gespeichert und erreichen Ihre Anwendung als ganz normale Umgebungsvariablen.
Eigene Variablen hinzufügen
Variablen → Variable hinzufügen, geben Sie einen NAMEN und einen Wert ein und klicken Sie auf Speichern.
- Ein Name besteht aus lateinischen Buchstaben, Ziffern und
_und beginnt nicht mit einer Ziffer. Jeder Name muss eindeutig sein. - Tipp: Fügen Sie den Inhalt einer
.env-Datei in ein Namensfeld ein – dann werden alle Zeilen auf einmal übernommen.
Variablen stehen der Anwendung zur Laufzeit zur Verfügung – nicht beim Build. Änderungen erreichen die Anwendung mit dem nächsten Deployment. Nach dem Speichern bietet das Panel Jetzt deployen an: Damit wird die laufende Version mit den neuen Variablen erneut deployt, ohne neuen Build.
Produktion und Vorschauen
Jede Variable hat eine Umgebung:
| Umgebung | Wo sie gilt |
|---|---|
| Produktion und Vorschauen | in der Live-Anwendung und in jeder Branch-Vorschau (Standard) |
| Nur Produktion | nur in der Live-Anwendung – z. B. ein Live-Zahlungsschlüssel |
| Nur Vorschauen | nur in Branch-Vorschauen – z. B. ein Test-Zahlungsschlüssel |
Vorschauen erhalten nur die Variablen, die für sie gesetzt sind. Eine Vorschau hat außerdem einen eigenen Tab Variablen: Dort sehen Sie, was sie Aus der Anwendung erhält, und ein eigener Wert mit demselben Namen tritt nur für diese Vorschau an dessen Stelle.
Automatisch gesetzt
Die Liste Automatisch gesetzt zeigt, was Rivervo für Ihre Anwendung bereitstellt und aktuell hält. Diese Variablen müssen Sie nicht selbst anlegen:
| Variable | Wann |
|---|---|
PORT | immer – der Port, auf dem Ihre Anwendung lauscht |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | das Projekt hat eine PostgreSQL- oder MySQL-Datenbank |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | die Datenbank ist PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | das Projekt hat Valkey |
RIVERVO_<NAME>_URL | für jede Datenbank, jedes Valkey und jedes Lesereplikat des Projekts, nach seinem Dienstnamen |
RIVERVO_<NAME>_URL | für jeden anderen Webdienst der Anwendung – seine interne Adresse, z. B. RIVERVO_API_URL=http://api:8080 (siehe Kommunikation zwischen Diensten) |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | das Projekt hat Object Storage |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | eine Laravel-Anwendung (siehe Laravel) |
Die erste Datenbank eines Projekts erhält die üblichen Namen (DATABASE_URL, DB_*). Eine zweite fügt nur ihre eigene RIVERVO_<NAME>_URL hinzu, es wird also nichts von selbst umgestellt – siehe Datenbanken.
Einen automatischen Wert ersetzen
Eine eigene Variable mit demselben Namen tritt an die Stelle der automatischen; das Panel kennzeichnet sie mit Ihr Wert wird verwendet. So können Sie die Anwendung auf etwas anderes ausrichten, zum Beispiel DATABASE_URL auf eine andere Datenbank des Projekts.
Die einzige Ausnahme ist PORT: Diese Variable verwaltet immer Rivervo.
Dienste eines Projekts
Jeder Dienst eines Projekts – Worker, geplante Jobs, weitere Webdienste – erhält die Variablen des Projekts, einschließlich seiner Datenbank. Ein Dienst kann außerdem eigene Variablen haben, die Vorrang vor denen des Projekts haben. Ein Webdienst erhält immer seine eigene APP_URL. Jeder Code-Dienst erhält zudem die interne Adresse jedes anderen Webdienstes als RIVERVO_<NAME>_URL; nachdem Sie einen Webdienst hinzugefügt oder umbenannt haben, deployen Sie die anderen Dienste erneut, damit sie sie erhalten. Siehe Dienste eines Projekts.
Wer die Werte sieht
Die Werte sehen der Kontoinhaber und Personen mit der Rolle Entwickler oder Administrator in der Anwendung. Die Rolle Betrachter sieht sie nicht. Siehe Zugriff auf eine Anwendung.