Variables d'environnement par défaut | Documentation Stack Harbor

Stack Harbor PaaS pré-remplit chaque conteneur avec un ensemble de variables d’environnement. Certaines sont des variables internes en lecture seule — elles exposent l’IP du nœud maître, le répertoire home, le nom du stack, etc. D’autres sont des leviers éditables que vous pouvez ajuster pour changer le comportement du conteneur sans écrire de code : plafonds mémoire, redirection de port, fréquence GC, choix du gestionnaire de paquets.

Cette page est la référence complète, groupée par domaine. Pour chaque variable :

La colonne Éditable marque + pour les variables que vous pouvez changer sans risque et - pour les variables que la plateforme gère.
Une marque + (avant création env) signifie que la valeur ne peut être posée qu’à la création de l’environnement, pas rétroactivement.
Les variables éditables nécessitent un redémarrage de conteneur pour prendre effet.

Les variables marquées - ne devraient pas être éditées. Le changement ne se propage pas à la plateforme ; les toucher risque de casser la logique interne.

Pour les instructions sur l’ajout de vos propres variables au-dessus de celles-ci, voir variables d’environnement personnalisées.

Commun à tous les stacks

Ces variables existent sur chaque stack infogéré par la plateforme.

Variable	Éditable	Description
`{SOFTWARE}_VERSION`	-	Version du stack, du moteur, du modèle ou du module.
`CLONE_ON_SCALE`	+	Les nouveaux nœuds lors du scale-out horizontal sont des clones du maître du palier (`true`) ou construits à neuf (`false`).
`DOCKER_EXPOSED_PORT`	-	Ports de la directive `EXPOSE` de l’image, ouverts par le pare-feu à la création.
`JELASTIC_EXPOSE`	+	État de la fonction d’auto-redirection, avec port manuel optionnel.
`MASTER_HOST`	-	Nom d’hôte court du nœud maître du palier.
`MASTER_ID`	-	Identifiant unique du nœud maître du palier.
`MASTER_IP`	-	IP interne du nœud maître du palier.
`ON_ENV_INSTALL`	+ (avant création env)	Script (ou lien vers un script) à exécuter après la création de l’environnement.
`OPEN_INBOUND_PORTS` (`JELASTIC_PORTS`)	+ (avant création env)	Ports personnalisés à ouvrir dans le pare-feu à la création du conteneur.
`PATH`	-	`PATH` shell par défaut.
`STACK_NAME`	-	Nom du stack courant.
`STACK_PATH`	-	Répertoire home du stack.
`STACK_USER`	-	Utilisateur par défaut du stack.

Java

Pour tous les stacks Java sauf indication contraire.

Stack	Variable	Éditable	Description
Tous Java	`FULL_GC_AGENT_DEBUG`	+	Mode débogage de l’agent GC Java — journalise les processus GC.
Tous Java	`FULL_GC_PERIOD`	+	Intervalle en secondes entre les appels GC complets. Défaut `900` (15 minutes).
Tous Java	`G1PERIODIC_GC_INTERVAL`	+ (openJDK 12/13 uniquement)	Fréquence de la collection périodique G1 en millisecondes. Défaut 15 minutes. `0` désactive.
Tous Java	`G1PERIODIC_GC_SYS_LOAD_THRESHOLD`	+ (openJDK 12/13 uniquement)	La collection périodique G1 ne s’exécute que si la charge moyenne sur 1 minute est sous cette valeur. Ignoré si `0`. Défaut `CPU_cores * GC_SYS_LOAD_THRESHOLD_RATE`.
Tous Java	`GC_SYS_LOAD_THRESHOLD_RATE`	+ (openJDK 12/13 uniquement)	Multiplicateur pour `G1PeriodicGCSystemLoadThreshold`. Défaut `0.3`.
Tous Java	`JAVA_ARGS`	+	Arguments personnalisés passés à la fonction main de l’application.
Tous Java	`JAVA_HOME`	-	Répertoire d’installation du JRE.
Tous Java	`JAVA_OPTS_CONFFILE`	-	Chemin vers `variables.conf`.
Tous Java	`VERT_SCALING`	+	Active (`true`) ou désactive (`false`) l’agent GC Java par défaut.
Tomcat, TomEE	`HOT_DEPLOY`	+	Hot deploy (sans redémarrage). `true/enabled/1` active, `false/disabled/0` désactive (défaut).
Tomcat, TomEE	`WEBROOT`	-	Répertoire de déploiement applicatif.
GlassFish, Payara	`ADMIN_USER`	-	Login de la console admin.
GlassFish, Payara	`DAS`	-	Indique si le palier a un nœud DAS (requis pour la grappe).
GlassFish, Payara	`GMS_LISTENER_PORT`	-	Port utilisé par le Group Management Service.
GlassFish, Payara	`HAZELCAST_CONFIG`	+	Chemin vers le fichier de configuration Hazelcast.
GlassFish, Payara	`HOME_DIR`	-	Répertoire home du conteneur.
GlassFish, Payara	`JELASTIC_PRIORITY_PORTS`	+	Port d’écoute HTTP GlassFish.
GlassFish, Payara	`PORT_4848_TCP_PORT`	-	Port de la console admin.
GlassFish, Payara	`PSWD_FILE`	-	Chemin vers le fichier mot de passe admin.
GlassFish, Payara	`WEBROOT`	-	Répertoire de déploiement applicatif.
WildFly	`ADMIN_USER`	-	Login de la console admin.
WildFly	`HOME_DIR`	-	Répertoire home du conteneur.
WildFly	`JBOSS_HOME`	-	Répertoire home WildFly.
WildFly	`JELASTIC_MEMORY_AUTOCONFIG`	+	Autoconfiguration mémoire pour WildFly.
WildFly	`LAUNCH_JBOSS_IN_BACKGROUND`	+	Démarre le serveur en mode arrière-plan.
WildFly	`STANDALONE_MODE_CONFIG`	+	Fichier de configuration pour WildFly standalone.
Spring Boot	`HOME_DIR`	-	Répertoire home du conteneur.
Java Engine	`HOME_DIR`	-	Répertoire home du conteneur.

PHP

Stack	Variable	Éditable	Description
Tous PHP	`PHP_MAX_EXECUTION_TIME`	+	PHP `max_execution_time` — délai de script en secondes. Défaut `300`.
Tous PHP	`PHP_MEMORY_LIMIT`	+	PHP `memory_limit` — plafond mémoire par script. Pourcentage ou MB. Défaut `25%`. `-1` pour illimité.
Tous PHP	`REDIS_ENABLED`	+	Obsolète — utilisez `CACHE_ENABLED`. Cache d’objets avec Redis. Redémarrage requis.
Tous PHP	`WEBROOT`	-	Répertoire de déploiement applicatif.
NGINX	`PHPFPM_MAX_CHILDREN`	+	Processus enfants PHP-FPM. Défaut = cœurs CPU, minimum 2.
NGINX	`PROXY_READ_TIMEOUT`	+	Délai de lecture du backend en secondes.
LiteSpeed Web Server, LLSMP	`JELASTIC_AUTOCONFIG`	+	Autoconfiguration basée sur la RAM et les cœurs CPU. Défaut `true`.
LiteSpeed Web Server, LLSMP	`ADMIN_USER`	-	Login de la console admin.
LiteSpeed Web Server, LLSMP	`LSWS_MAX_CHILDREN`	+	Limite max des processus enfants. Cachée par défaut — la plateforme la pose égale au nombre de cœurs CPU. Ajoutez et redémarrez pour redéfinir.
LiteSpeed Web Server, LLSMP	`SERVER_WEBROOT`	-	Répertoire de déploiement applicatif.
LiteSpeed Web Server, LLSMP	`WAF`	+	Pare-feu applicatif web avec le jeu Comodo par défaut pour LiteSpeed Web Server.
LiteSpeed Web Server, LLSMP	`WP_PROTECT`	+	Action de protection brute-force WordPress : `off/on/drop/deny/throttle/captcha`. Défaut `off`.
LiteSpeed Web Server, LLSMP	`WP_PROTECT_LIMIT`	+	Limite de protection brute-force WordPress. `0/1/2-1000`. Défaut `10`.
LLSMP, LEMP	`CACHE_ENABLED`	+	Serveur de cache Memcached intégré. Redémarrage requis.
LLSMP, LEMP	`CACHE_MEM_LIMIT`	+	RAM réservée à Memcached. Défaut `10%` de la RAM du conteneur.
LLSMP	`ADMINPANEL_ENABLED`	+	Panneau admin — `true` ou `1` active. Redémarrage requis.
LLSMP	`CP_MEM_LIMIT`	+	RAM réservée au serveur d’application. Défaut `50%` de la RAM du conteneur.
LLSMP	`DB_MEM_LIMIT`	+	RAM réservée au serveur MariaDB intégré. Défaut `40%` de la RAM du conteneur.
LEMP	`ADMINPANEL_ENABLED`	+	Panneau admin — `true` ou `1` active. Redémarrage requis.
LEMP	`CP_MEM_LIMIT`	+	RAM réservée au serveur d’application. Défaut `50%` de la RAM du conteneur.
LEMP	`DB_MEM_LIMIT`	+	RAM réservée au serveur MariaDB intégré. Défaut `40%` de la RAM du conteneur.

Ruby

Variable	Éditable	Description
`GEM_HOME`	+	Emplacements où trouver les gems. Doit inclure `GEM_PATH`.
`GEM_PATH`	-	Emplacement d’installation par défaut des gems.
`IRBRC`	-	Chemin vers le fichier de configuration IRB.
`MY_RUBY_HOME`	-	Chemin vers le répertoire du moteur Ruby.

Node.js

Variable	Éditable	Description
`APP_FILE`	+	Fichier d’application Node.js principal à lancer.
`AUTO_OLD_HEAP`	+	Autoconfiguration mémoire — fixe la taille max du old heap depuis la mémoire conteneur.
`HOME_DIR`	-	Répertoire home du conteneur.
`NODE_ENV`	-	Environnement applicatif : `development`, `staging`, `production`, `testing`, etc.
`NODE_OPTIONS`	+	Options runtime Node.js v8.
`NVM_DIR`	-	Chemin vers l’installation NVM.
`PACKAGE_MANAGER`	+	`npm` ou `yarn`.
`PACKAGE_MANAGER_OPTS`	+	Options additionnelles du gestionnaire de paquets.
`PROCESS_MANAGER`	+	`npm`, `pm2`, ou `forever`.
`PROCESS_MANAGER_FILE`	-	Chemin vers le fichier d’options de démarrage du process manager.
`REDIRECT_EXCLUDE_PORTS`	+	Ports exclus de l’algorithme d’auto-redirection. Exemple : `22,23,25,21,111,2049,8743,7979`.
`ROOT_DIR`	-	Répertoire de déploiement applicatif.
`UPDATE_PACKAGES_ON_RESTART`	+	Auto-installation des paquets après redémarrage `nodejs`. Toujours exécutée si `node_modules` manque.

Go

Variable	Éditable	Description
`GO_BUILD_OPTIONS`	+	Options et flags de build.
`GO_RUN`	+	Nom du binaire exécutable. Auto-détecté depuis le nom du projet si vide.
`GO_RUN_OPTIONS`	+	Options et flags d’exécution.
`GOPATH`	-	Dossier de déploiement de l’application Go.
`WEB_ROOT`	-	Chemin de l’application déployée.

.NET Core

Variable	Éditable	Description
`APP_NAME`	+	Pointe vers un dossier précis ou exécute un `.dll` précis.
`ASPNETCORE_URLS`	+	URL sur laquelle se lie le service .NET Core.
`RUN_OPTION`	+	Options additionnelles `dotnet run`.

Répartiteurs de charge

Stack	Variable	Éditable	Description
HAProxy	`TCP_BALANCING`	+	Proxy et répartition de trafic vers les backends TCP.
NGINX	`PROXY_READ_TIMEOUT`	+	Délai de lecture du backend en secondes.
NGINX	`UPSTREAM_KEEPALIVE`	+	Valeur de la directive `keepalive` pour l’upstream.
NGINX	`WORKER_PROCESSES`	+	Nombre de processus workers. `auto` laisse NGINX détecter ; `define` égale le nombre de cœurs CPU.
LiteSpeed ADC	`ADMIN_USER`	-	Login de la console admin.
LiteSpeed ADC	`DEFAULT_CLUSTER`	+	Type de répartition pour le proxy : `HTTP`, `AJP`, `FCGI`, `LSAPI`. Désactivez avec `0`, `disabled`, `false`.
LiteSpeed ADC	`JELASTIC_AUTOCONFIG`	+	Autoconfiguration. Défaut `true`.
LiteSpeed ADC	`WP_PROTECT`	+	Action de protection brute-force WordPress. Défaut `off`.
LiteSpeed ADC	`WP_PROTECT_LIMIT`	+	Limite de protection brute-force WordPress. Défaut `10`.

Bases de données

Stack	Variable	Éditable	Description
Toutes BD	`ADMINPANEL_ENABLED` (`PHPMYADMIN_ENABLED`)	+	Panneau admin — `true` ou `1` active. Redémarrage requis. Le nom entre parenthèses est obsolète ; encore fonctionnel sur MySQL et MariaDB.
MySQL, MariaDB, Percona	`JELASTIC_AUTOCONFIG`	+	Autoconfiguration. Défaut `true`.
MySQL, MariaDB, Percona	`MAX_OOM_REDUCE_CYCLES`	+	Cycles maximum de réduction d’`innodb_buffer_pool_size` après un redémarrage causé par OOM. Défaut `5`.
MySQL, MariaDB, Percona	`OOM_ADJUSTMENT`	+	Quantité (en `%`, `MB`, `GB`) de réduction d’`innodb_buffer_pool_size` après chaque redémarrage causé par OOM. Défaut `10%`.
MySQL, MariaDB, Percona	`OOM_DETECTION_DELTA`	+	Fenêtre en secondes pendant laquelle la plateforme lit les logs après chaque redémarrage pour décider si OOM est en cause. Défaut `2`.
Redis	`REDIS_COMMANDER`	+	Active ou désactive l’outil de gestion Redis Commander.
Redis	`REDIS_SENTINEL`	+	Active ou désactive l’outil HA et supervision Redis Sentinel.
Couchbase	`ADMIN_USER`	-	Login de la console admin.

Autres stacks

Stack	Variable	Éditable	Description
Maven	`JAVA_HOME`	-	Répertoire d’installation du JRE.
Maven	`JAVA_OPTS_CONFFILE`	-	Chemin vers `variables.conf`.
Maven	`MAVEN_DEPLOY_ARTIFACT`	+	Artefact à déployer. Peut être surchargé par projet.
Maven	`MAVEN_OPTS`	+	Paramètres JVM pour l’exécuteur Maven. Utilisé pour les options globales.
Maven	`MAVEN_RUN_ARGS`	+	Arguments personnalisés passés au build applicatif. Peut être surchargé par projet.
Maven	`VERT_SCALING`	+	Agent GC Java par défaut.
Shared Storage	`HOME_DIR`	-	Répertoire home du conteneur.