Commencer

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.

3 MIN DE LECTURE

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 .env dans 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 :

EnvironnementOù elle va
Production et aperçusl'application en ligne et chaque aperçu de branche (par défaut)
Production uniquementl'application en ligne seulement — par exemple une clé de paiement réelle
Aperçus uniquementles 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 :

VariableQuand
PORTtoujours — le port sur lequel votre application écoute
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORDle projet a une base de données PostgreSQL ou MySQL
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORDla base de données est PostgreSQL
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENTle projet a Valkey
RIVERVO_<NAME>_URLpour chaque base de données, Valkey et réplica en lecture du projet, d'après le nom de son service
RIVERVO_<NAME>_URLpour 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_SECRETle projet a un stockage objet
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STOREune 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.

Toujours bloqué ?

Écrivez-nous dans le chat — l'AI répond immédiatement et un ingénieur intervient si besoin, à toute heure.

Contacter l'assistance