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.
This page has not been translated yet and is shown in French.
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.
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.
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 |
| Deployments | Historique des déploiements ; voir Consulter l'historique des déploiements |
| Configuration | Variables et secrets ; voir Variables et secrets |
| Databases | Instances de base de données ; voir Bases de données |
| Storage | Buckets ; voir Stockage objet |
| URLs & IAM | URLs publiques et adresses de connexion ; voir Domaines et URLs |
| Monitoring | Sondes de disponibilité ; voir Supervision et logs |
| 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 |
| Carte Services | Définitions de service ; voir Créer 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 |
| 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 |