Variables d'environnement.
Vos propres variables et celles que Rivervo définit pour vous, production ou aperçus, remplacement d'une valeur automatique et moment où les modifications prennent effet.
Les clés, mots de passe et réglages de votre application se trouvent dans l'onglet Variables. Ils sont stockés chiffrés et arrivent dans votre application sous forme de variables d'environnement ordinaires.
Ajouter vos propres variables
Variables → Ajouter une variable, saisissez un NOM et une valeur, puis Enregistrer.
- Un nom se compose de lettres latines, de chiffres et de
_, et ne commence pas par un chiffre. Chaque nom doit être unique. - Astuce : collez le contenu d'un fichier
.envdans un champ de nom — toutes les lignes sont ajoutées d'un coup.
Les variables arrivent dans l'application à l'exécution, pas à l'étape de build. Les modifications arrivent dans l'application au prochain déploiement. Après l'enregistrement, le panel propose Déployer maintenant, qui redéploie la version en cours avec les nouvelles variables, sans nouveau build.
Production et aperçus
Chaque variable a un Environnement :
| Environnement | Où elle va |
|---|---|
| Production et aperçus | l'application en ligne et chaque aperçu de branche (par défaut) |
| Production uniquement | l'application en ligne seulement — par exemple une clé de paiement réelle |
| Aperçus uniquement | les aperçus de branche seulement — par exemple une clé de paiement de test |
Les aperçus ne reçoivent que les variables définies pour eux. Un aperçu a aussi son propre onglet Variables : vous y voyez ce qu'il reçoit De l'application, et une valeur que vous y définissez avec le même nom prend leur place pour cet aperçu uniquement.
Définies automatiquement
La liste Définies automatiquement montre ce que Rivervo fournit à votre application et tient à jour. Vous n'avez pas à les ajouter vous-même :
| Variable | Quand |
|---|---|
PORT | toujours — le port sur lequel votre application écoute |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | le projet a une base de données PostgreSQL ou MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | la base de données est PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | le projet a Valkey |
RIVERVO_<NAME>_URL | pour chaque base de données, Valkey et réplica en lecture du projet, d'après le nom de son service |
RIVERVO_<NAME>_URL | pour chacun des autres services web de l'application — son adresse interne, par exemple RIVERVO_API_URL=http://api:8080 (voir Communication entre services) |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | le projet a un stockage objet |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | une application Laravel (voir Laravel) |
La première base de données d'un projet reçoit les noms habituels (DATABASE_URL, DB_*). Une deuxième n'ajoute que son propre RIVERVO_<NAME>_URL : rien ne bascule donc tout seul — voir Bases de données.
Remplacer une valeur automatique
Une variable que vous définissez avec le même nom prend la place de la variable automatique ; le panel l'indique par Votre valeur est utilisée. Servez-vous-en pour faire pointer l'application ailleurs, par exemple DATABASE_URL vers une autre base de données du projet.
PORT est la seule exception : il est toujours géré par Rivervo.
Services d'un projet
Chaque service d'un projet — workers, tâches planifiées, autres services web — reçoit les variables du projet, y compris sa base de données. Un service peut aussi avoir ses propres variables, qui l'emportent sur celles du projet. Un service web reçoit toujours son propre APP_URL. Chaque service de code reçoit aussi l'adresse interne de chacun des autres services web sous la forme RIVERVO_<NAME>_URL ; après avoir ajouté ou renommé un service web, redéployez les autres services pour qu'ils la reçoivent. Voir Services d'un projet.
Qui peut voir les valeurs
Les valeurs sont visibles par le propriétaire du compte et par les personnes ayant le rôle Développeur ou Administrateur dans l'application. Le rôle Lecteur ne les voit pas. Voir Accès à une application.