Docs Hébergement Variables et secrets Référence des variables et des secrets Référence des variables et des secrets Écrans, champs, formats, clés fournies par la plateforme, sources d'une variable et limites de la configuration des services.
Référence Développeur
Mis à jour le 23 octobre 2026
La configuration des services se gère depuis la console Wakastart. Il n'existe pas d'API publique pour ces opérations.
Écrans#
Écran Chemin dans la console Accès Variables consommées App > Architecture > Services > service Droit « Infra Client » Configuration (pool)App > Environnements > environnement > onglet Configuration « Gérer les variables » pour une variable, « Gérer les secrets » pour un secret ; plus « Accès infrastructure en production » en prod Configuration du service Environnement > Services > service > onglet Configuration du service Droit « Infra Client » Ce qu'il reste à configurer Environnement > onglet Résumé Droit « Infra Client »
Variable consommée#
Champ Format Défaut Notes Mode de consommation Variable d'environnement ou Fichier monté Variable d'environnement — Nom de variable ^[A-Z][A-Z0-9_]*$, 255 caractères au plus— Obligatoire en mode variable ; unique dans la définition Valeur par défaut Texte, sans modèle {{ … }} — Stockée en clair, commune à tous les environnements Chemin de montage Chemin absolu, ^/[a-zA-Z0-9._/-]+$, sans / final, 255 caractères au plus — Obligatoire en mode fichier ; nom de fichier compris Permissions 0400 , 0440 , 0444 , 0600 , 0644 0400 Mode fichier Description 500 caractères au plus — —
Entrée du pool#
Champ Variable Secret Nom ^[A-Z][A-Z0-9_]*$, 255 caractères au plus, unique dans l'environnementIdem Valeur Texte, obligatoire Texte ou fichier (900 Ko au plus, encodé en base64), obligatoire Description 500 caractères au plus Idem Stockage En clair Coffre de l'application, chiffré Valeur relisible Oui Non Modification Non Remplacer la valeur du secret
Filtre Source affichée Contenu Utilisateur utilisateur Vos variables en clair Secret secret Vos secrets Plateforme plateforme Variables communes à toute la plateforme, définies par Wakastart Auto auto Valeurs calculées pour l'environnement Base base Champs des bases de données de l'environnement Stockage stockage Champs des buckets de l'environnement Harbor harbor Identifiants du registre d'images, utilisés par la plateforme
Sources d'une variable dans la configuration du service#
Choix à l'écran Type de source Utiliser la valeur par défaut Valeur par défaut de la définition, sinon variable absente Saisir une valeur libre Valeur saisie, modèles {{ CLE }} résolus sur les entrées non sensibles Entrée utilisateur Variable en clair de l'environnement Entrée secret Secret de l'environnement Entrée plateforme Variable de la plateforme Entrée auto Valeur calculée Entrée base Champ d'une base de données Entrée stockage Champ d'un bucket
Un Fichier monté n'accepte qu'un secret déposé en fichier.
<SERVICE>, <BASE> et <BUCKET> désignent l'identifiant court de la définition, en majuscules, tirets remplacés par _.
Valeurs calculées (auto )#
Clé Valeur Exemple WAKASTART_APP_NAMEIdentifiant court de l'app monappWAKASTART_ENV_SLUGSlug de l'environnement (<nom court>-<type>) stg-stagingWAKASTART_NAMESPACEEspace de noms de l'environnement dans le cluster wakapp-ab12cd-stg-stagingSVC_<SERVICE>_URLURL interne du service déployé http://svc-ab12cd-stg-staging-api.wakapp-ab12cd-stg-staging.svc.cluster.local:3000SVC_<SERVICE>_HOSTNom d'hôte interne du service svc-ab12cd-stg-staging-api.wakapp-ab12cd-stg-staging.svc.cluster.localSVC_<SERVICE>_PORTPort déclaré dans la définition du service 3000ROUTE_<SERVICE>_URLURL publique de la première route vers le service : https://, nom d'hôte préfixe compris, puis chemin de la route (/ pour la racine) https://app.staging.exemple.fr/apiROUTE_<SERVICE>_URL_2, _3…URLs des routes suivantes vers le même service —
Les clés SVC_* existent pour chaque service déployé dans l'environnement. Les clés ROUTE_* existent pour chaque route déclarée dans l'architecture sur une URL qui a un domaine, qu'elle soit en ligne ou non.
Champs d'une base (base )#
Clé Contenu Sensible <BASE>_URLURL de connexion complète Oui <BASE>_HOSTHôte Non <BASE>_PORTPort Non <BASE>_DATABASENom de la base Non <BASE>_USERNAMEUtilisateur Non <BASE>_PASSWORDMot de passe Oui <BASE>_SSL_MODEMode SSL Non
Champs d'un bucket (stockage )#
Clé Contenu Sensible <BUCKET>_S3_URLURL S3 du bucket Oui <BUCKET>_ENDPOINTEndpoint S3 Non <BUCKET>_REGIONRégion Non <BUCKET>_BUCKETNom du bucket Non <BUCKET>_ACCESS_KEY_IDClé d'accès Non <BUCKET>_SECRET_ACCESS_KEYClé secrète Oui
Les entrées sensibles ne sont jamais affichées et ne peuvent pas être citées dans une valeur libre.
Limites#
Élément Valeur Taille d'un secret déposé en fichier 900 Ko Rafraîchissement de la copie d'un secret dans le cluster toutes les heures Prise en charge d'un changement de configuration demandes explicites toutes les 10 s Une source par variable consommée et par service — Nom d'une variable en clair supprimée reste réservé dans l'environnement