Créer un environnement
Ajoutez à votre application un environnement de développement, de recette ou de production, avec sa référence Git.
- Accès requis
- Droit « Créer un environnement » ; « Accès infrastructure en production » en plus pour un environnement Production
- Durée
- 5 min
Un environnement est l'espace isolé dans lequel vos services tournent. Créez-en un par étape de votre cycle de livraison, et autant que nécessaire pour un même type : un par équipe, un par client pilote.
Avant de commencer
- Votre application a été créée par Wakastart et apparaît dans le menu latéral de la console.
- Vous avez accès à l'infrastructure de l'application : les entrées Architecture, Builds et Environnements sont visibles sous son nom. C'est le cas avec le profil Infra.
- Choisissez un nom court unique dans l'application : 12 caractères au plus, minuscules, chiffres et tirets.
Un seul environnement sans préfixe d'URL
Un nouvel environnement est créé sans préfixe d'URL, et une application ne peut avoir qu'un environnement sans préfixe. Avant de créer un deuxième environnement, donnez un préfixe à celui qui n'en a pas. Le plus simple : créez vos environnements de développement et de recette d'abord, donnez-leur chacun un préfixe, et créez la production en dernier.
Créer l'environnement
Ouvrir la liste des environnements
Dans le menu latéral, sous le nom de votre application, cliquez sur Environnements, puis sur Nouvel environnement.
Renseigner l'identité
Dans la carte Informations de base :
- Dans Nom de l'instance, saisissez un nom lisible, par exemple
dev-team-a. - Dans Type d'environnement, choisissez Development, Staging ou Production. Ce choix est définitif.
- Dans Nom court, saisissez l'identifiant court, par exemple
teama.
Le slug de l'environnement est calculé automatiquement : teama-dev.
Choisir la référence Git
Dans la carte Configuration Git, saisissez dans Référence Git la branche ou le tag que cet environnement doit suivre, par exemple develop. La valeur proposée est main.
Créer
Cliquez sur Créer l'environnement.
Résultat : le message « Environnement créé » s'affiche et la console revient à la liste. La carte du nouvel environnement indique Actif et son espace d'exécution (Namespace: wakapp-…-teama-dev).
La plateforme prépare ensuite l'espace d'exécution et le coffre de secrets de l'environnement, en quelques secondes à quelques minutes. Rien n'y tourne encore : les services, les bases et les buckets s'ajoutent ensuite, un par un.
Créer plusieurs environnements du même type
Répétez la procédure avec un autre nom court et le même type. Pour éviter que leurs URLs publiques se chevauchent, donnez à chacun un préfixe d'URL différent dès sa création, depuis son Résumé.
| Nom de l'instance | Type | Nom court | Slug | Préfixe d'URL |
|---|---|---|---|---|
dev-team-a | Development | teama | teama-dev | teama |
dev-team-b | Development | teamb | teamb-dev | teamb |
prod | Production | prod | prod-prod | aucun |
Vérifier le résultat
- Dans Environnements, cliquez sur la carte du nouvel environnement.
- Dans l'onglet Résumé, vérifiez la carte Informations : la référence Git et son type (
BRANCH), le préfixe d'URL. - Consultez l'encart Ce qu'il reste à configurer : il liste ce qui manque pour que l'environnement soit opérationnel.
Dépannage
- « Impossible de créer l'environnement » : le nom court est déjà utilisé dans l'application, ou un autre environnement est déjà sans préfixe d'URL. Voir Résoudre les problèmes d'environnement.
- « Action non autorisée » : il vous manque le droit de créer un environnement, ou le droit d'accès à la production.