# Créer un environnement

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

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.

:::important[Un seul environnement sans préfixe d'URL]
Un nouvel environnement est créé sans [préfixe d'URL](/v1.0/applications/configurer-un-environnement), 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

::::steps
### 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'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

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](/v1.0/applications/depannage#impossible-de-créer-lenvironnement).
- « Action non autorisée » : il vous manque le droit de créer un environnement, ou le droit d'accès à la production.

## Voir aussi

- [Configurer un environnement](/v1.0/applications/configurer-un-environnement)
- [Déployer un service](/v1.0/services/deployer-un-service)
- [Architecture et environnements](/v1.0/applications/architecture-et-environnements)
