Les variables d’environnement sont des valeurs de configuration que votre application lit dans l’environnement du conteneur à l’exécution. Sur Stack Harbor PaaS, deux familles comptent :
- Variables par défaut — posées par la plateforme sur chaque conteneur d’un stack donné. Certaines sont des variables internes en lecture seule ; d’autres sont des leviers éditables qui changent le comportement du conteneur (plafonds mémoire, redirection de port, GC Java, choix de gestionnaire de paquets, etc.).
- Variables personnalisées — valeurs que vous ajoutez vous-même pour que l’application les lise. Le tableau de bord expose un panneau de variables par conteneur, et il existe des chemins équivalents via les fichiers de config shell ou, pour Java, via
variables.conf.
Les deux fonctionnent de la même manière à l’exécution — votre code lit $VAR_NAME et reçoit la valeur. La différence est qui a posé la valeur : la plateforme, ou vous.
Ce que couvre cette section
- Variables d’environnement par défaut — la liste complète des variables posées par la plateforme, groupées par stack. Inclut ce que fait chaque variable, si elle est éditable, et la valeur par défaut.
- Variables d’environnement personnalisées — trois façons d’ajouter vos propres variables : le panneau du tableau de bord, les fichiers de config shell, et (pour Java)
variables.confvia le gestionnaire de fichiers de configuration.
Quand éditer quoi
- Utilisez le panneau de variables du tableau de bord pour la configuration applicative que la plateforme doit préserver entre redémarrages et reconstructions du conteneur. C’est la surface canonique.
- Utilisez les fichiers de config shell (
~/.bashrc) seulement quand la variable doit exister pour les sessions shell interactives et que vous ne voulez pas la rendre visible dans le tableau de bord. La plateforme sourcera~/.bashrcdepuis~/.bash_profileautomatiquement. - Utilisez
variables.confpour les serveurs d’application Java quand la valeur doit atteindre la JVM comme un flag-D— c’est là que vivent les options Java.