# 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.

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'environnement | Idem |
| **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.

## Valeurs fournies par la plateforme

`<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_NAME` | Identifiant court de l'app | `monapp` |
| `WAKASTART_ENV_SLUG` | Slug de l'environnement (`<nom court>-<type>`) | `stg-staging` |
| `WAKASTART_NAMESPACE` | Espace de noms de l'environnement dans le cluster | `wakapp-ab12cd-stg-staging` |
| `SVC_<SERVICE>_URL` | URL interne du service déployé | `http://svc-ab12cd-stg-staging-api.wakapp-ab12cd-stg-staging.svc.cluster.local:3000` |
| `SVC_<SERVICE>_HOST` | Nom d'hôte interne du service | `svc-ab12cd-stg-staging-api.wakapp-ab12cd-stg-staging.svc.cluster.local` |
| `SVC_<SERVICE>_PORT` | Port déclaré dans la définition du service | `3000` |
| `ROUTE_<SERVICE>_URL` | URL 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/api` |
| `ROUTE_<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>_URL` | URL de connexion complète | Oui |
| `<BASE>_HOST` | Hôte | Non |
| `<BASE>_PORT` | Port | Non |
| `<BASE>_DATABASE` | Nom de la base | Non |
| `<BASE>_USERNAME` | Utilisateur | Non |
| `<BASE>_PASSWORD` | Mot de passe | Oui |
| `<BASE>_SSL_MODE` | Mode SSL | Non |

### Champs d'un bucket (**stockage**)

| Clé | Contenu | Sensible |
|---|---|---|
| `<BUCKET>_S3_URL` | URL S3 du bucket | Oui |
| `<BUCKET>_ENDPOINT` | Endpoint S3 | Non |
| `<BUCKET>_REGION` | Région | Non |
| `<BUCKET>_BUCKET` | Nom du bucket | Non |
| `<BUCKET>_ACCESS_KEY_ID` | Clé d'accès | Non |
| `<BUCKET>_SECRET_ACCESS_KEY` | Clé 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 |
