# Référence des applications et environnements

> Champs, contraintes, statuts, écrans et droits de l'architecture d'une application et de ses environnements dans la console.

L'hébergement se pilote depuis la console Wakastart ; il n'existe pas d'API publique d'hébergement. Cette page décrit les objets tels que la console les présente. Pour le concept, voir [Architecture et environnements](/v1.0/applications/architecture-et-environnements).

## Application

Créée par Wakastart. Vous ne la modifiez pas depuis l'hébergement.

| Champ | Contraintes |
|---|---|
| Nom | 1 à 100 caractères |
| Nom court (`shortname`) | 1 à 12 caractères, `a-z`, `0-9`, `-`, unique sur la plateforme |
| Identifiant (`wid`) | 6 caractères, attribué par Wakastart ; il préfixe les espaces d'exécution et les dépôts gérés |

Ressources de socle créées avec l'application : un projet dans le registre d'images et un coffre de secrets. Voir [Réparer l'infrastructure](/v1.0/applications/reparer-l-infrastructure).

## Environnement

| Champ (libellé console) | Contraintes | Modifiable |
|---|---|---|
| **Nom de l'instance** | 1 à 63 caractères, unique dans l'application | non, depuis la console |
| **Type d'environnement** | `dev` (Development), `staging` (Staging), `prod` (Production) | non |
| **Nom court** | 1 à 12 caractères, `a-z`, `0-9`, `-`, unique dans l'application | non, depuis la console |
| Slug | calculé `<nom court>-<type>` ; 1 à 63 caractères, unique dans l'application | non |
| Namespace | calculé `wakapp-<wid>-<slug>` en minuscules, 63 caractères au plus | non |
| **Référence Git** / **Branche / tag / commit** | 1 à 255 caractères ; défaut à la création : `main` | oui |
| **Type** de référence | `BRANCH` (défaut), `TAG`, `COMMIT` | oui |
| **Build automatique** | exige le type `BRANCH` ; défaut : désactivé | oui |
| **Auto-deploy on new build** | exige le type `BRANCH` ; défaut : désactivé | oui |
| **Préfixe** (préfixe d'URL) | `^[a-z][a-z0-9-]{0,19}$` ou vide ; unique dans l'application ; un seul environnement sans préfixe par application | oui |

### États d'un environnement

| Libellé | Signification |
|---|---|
| **Actif** | L'environnement existe ; sa préparation se termine en arrière-plan dans les minutes qui suivent la création |
| En cours de suppression | La suppression est demandée ; l'espace d'exécution et le coffre de secrets sont en cours d'effacement, puis la carte disparaît de la liste |

### Onglets d'un environnement

| Onglet | Contenu |
|---|---|
| **Résumé** | Carte **Informations** (référence Git, préfixe URL, date de création), compteurs de services, bases et buckets, encart de préparation |
| **Services** | Instances de service de l'environnement ; voir [Services](/v1.0/services) |
| **Deployments** | Historique des déploiements ; voir [Consulter l'historique des déploiements](/v1.0/builds-et-deploiements/consulter-l-historique-des-deploiements) |
| **Configuration** | Variables et secrets ; voir [Variables et secrets](/v1.0/variables-et-secrets) |
| **Databases** | Instances de base de données ; voir [Bases de données](/v1.0/bases-de-donnees) |
| **Storage** | Buckets ; voir [Stockage objet](/v1.0/stockage) |
| **URLs & IAM** | URLs publiques et adresses de connexion ; voir [Domaines et URLs](/v1.0/domaines-et-urls) |
| **Monitoring** | Sondes de disponibilité ; voir [Supervision et logs](/v1.0/supervision) |
| **Keycloak** | Métadonnées de connexion de l'instance Keycloak du type de l'environnement |

### Liste des environnements

La page **Environnements** a trois onglets : **Environnements** (une carte par environnement), **Matrice** (l'état de chaque service dans chaque environnement ; un clic ouvre l'instance) et **Mapping IAM**.

## Page Architecture

| Élément | Rôle |
|---|---|
| Carte **Repositories** | Dépôts Git ; voir [Connecter un dépôt Git](/v1.0/builds-et-deploiements/connecter-un-depot) |
| Carte **Services** | Définitions de service ; voir [Créer un service](/v1.0/services/creer-un-service) |
| Carte **Dépendances** | Définitions de bases et de buckets |
| Carte **URLs** | Sous-domaines, routes, domaines personnalisés, redirections |
| Bouton **Exporter** | Export JSON ; voir [Format de l'architecture JSON](/v1.0/applications/format-architecture-json) |
| Bouton **Importer** | Import JSON, actif seulement si l'application est vierge |
| Bouton **Réparer l'infrastructure** | Recrée le projet du registre et le coffre de secrets s'ils manquent |

## Encart de préparation

| Catégorie | Compte comme tâche | Environnements concernés |
|---|---|---|
| Services, Variables, Bases de données, Stockage, URLs / routes, Domaine racine (apex), Redirections, Builds | oui | tous |
| Sauvegarde des bases de données, Sauvegarde du stockage | oui | production |
| Avertissement **Préfixe d'URL manquant** | non | `dev`, `staging` |
| Avertissements **Service à un seul réplica**, **Base de données dans le cluster** | non | production |

## Droits

Le menu **Architecture**, **Builds**, **Environnements** d'une application s'affiche avec le droit **Infra Client** (profils Développeur et Infra) ou à partir du niveau Administrateur d'applications. Les écrans d'hébergement demandent en outre le niveau Administrateur client (CustomerAdmin) au minimum. Les actions suivantes demandent en plus un droit précis, et le droit **Accès infrastructure en production** quand l'environnement visé est de type `prod`.

| Action | Droit |
|---|---|
| Créer un environnement | **Créer un environnement** |
| Modifier le préfixe d'URL ou la configuration Git | **Modifier un environnement** |
| Déployer un service dans un environnement | **Créer un service** |
| Déployer une image | **Déployer un environnement** |
| Modifier les ressources et les réplicas | **Scaler un service** |
| Redémarrer un service | **Redémarrer un service** |
| Lancer un build | **Déclencher un build** |
| Supprimer un build | **Supprimer un build** |
| Voir le stockage du registre | **Voir le stockage du registre** |
| Régler la purge automatique | **Gérer la purge automatique des builds** |

Le profil **Développeur** donne la lecture (environnements, services, builds, registre, déploiements, logs). Le profil **Infra** donne l'ensemble des droits de ce tableau, dont l'accès à la production.

## Limites

| Élément | Valeur |
|---|---|
| Nom court d'environnement | 12 caractères |
| Préfixe d'URL | 20 caractères |
| Environnements par type | pas de limite |
| Environnements sans préfixe par application | 1 |
| Délai de prise en charge d'une action explicite | 10 s au plus |
| Délai de prise en charge d'une nouvelle ressource | 30 s au plus |
| Rattrapage d'une modification non appliquée | toutes les 5 min |
| Durée maximale d'un import d'architecture | 60 s |
