Aller au contenu

Créer un environnement

Ajoutez à votre application un environnement de développement, de recette ou de production, avec sa référence Git.

GuideDéveloppeur
Accès requis
Droit « Créer un environnement » ; « Accès infrastructure en production » en plus pour un environnement Production
Durée
5 min
Voir en Markdown

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 :

  1. Dans Nom de l'instance, saisissez un nom lisible, par exemple dev-team-a.
  2. Dans Type d'environnement, choisissez Development, Staging ou Production. Ce choix est définitif.
  3. 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'instanceTypeNom courtSlugPréfixe d'URL
dev-team-aDevelopmentteamateama-devteama
dev-team-bDevelopmentteambteamb-devteamb
prodProductionprodprod-prodaucun

Vérifier le résultat

  1. Dans Environnements, cliquez sur la carte du nouvel environnement.
  2. Dans l'onglet Résumé, vérifiez la carte Informations : la référence Git et son type (BRANCH), le préfixe d'URL.
  3. 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.

Voir aussi