# Définir le préfixe d'environnement

> Insérer un segment comme staging dans tous les noms d'hôte d'un environnement, pour que dev, staging et prod ne se disputent pas les mêmes URLs.

Le préfixe d'environnement s'insère dans le nom d'hôte de chaque URL de l'environnement : avec le préfixe `staging`, l'URL `app` sur `exemple.fr` est servie sous `app.staging.exemple.fr`. Il évite de déclarer des URLs différentes par environnement.

## Avant de commencer

- Choisissez des préfixes courts et stables : `dev`, `staging`, `recette`. Chaque changement recrée les enregistrements DNS et les certificats de toutes les routes de l'environnement.
- **Un seul environnement de l'app peut ne pas avoir de préfixe**, en général la prod. Deux environnements ne peuvent pas non plus partager le même préfixe.

## Définir le préfixe

1. Ouvrez l'environnement, puis l'onglet **URLs & IAM**.
2. Dans l'encart **Préfixe URL d'environnement**, cliquez sur **Éditer**. La valeur actuelle s'affiche, ou **Aucun (URLs publiées à la racine)**.
3. Dans **Préfixe**, saisissez la valeur : une lettre minuscule en premier, puis minuscules, chiffres et tirets, 20 caractères au plus. Laissez le champ vide pour retirer le préfixe.
4. Cliquez sur **Enregistrer**.

Résultat : le message **Préfixe URL mis à jour** s'affiche, suivi de **Synchronisation IAM en cours…**. Les routes, le domaine racine et les redirections de l'environnement sont remis en ligne sous leurs nouveaux noms ; l'ancien nom continue de répondre jusqu'à ce que le nouveau soit prêt.

Vous pouvez aussi modifier le préfixe depuis l'onglet **Résumé** de l'environnement, carte **Informations**, bouton **Éditer**.

:::important
Les variables `ROUTE_*` de vos services et les valeurs libres qui les utilisent contiennent le nom d'hôte. Après un changement de préfixe, redémarrez les services qui s'en servent (bouton **Redémarrer** de la page du service) pour qu'ils reçoivent les nouvelles adresses.
:::

## Vérifier le résultat

- Dans **Architecture > URLs**, **Aperçu FQDN par environnement** affiche les nouveaux noms.
- Dans l'onglet **URLs & IAM**, les routes repassent à `PROVISIONED` sous le nouveau nom d'hôte.
- La section **Hôtes IAM** liste les nouveaux noms. Si un message vous invite à relancer la synchronisation, cliquez sur **Resynchroniser IAM**.

Sur l'onglet **Résumé** d'un environnement dev ou staging sans préfixe, l'encart **Préfixe d'URL manquant** vous le signale.

## Dépannage

- **Format invalide** ou **Préfixe trop long** : corrigez la valeur selon les règles de l'étape 3.
- Message `urlPrefix "…" is already used by another environment of this app` : un autre environnement utilise ce préfixe.
- Message `urlPrefix is already NULL for another environment of this app…` : un autre environnement n'a déjà pas de préfixe ; donnez-en un à l'un des deux.

## Voir aussi

- [URLs, routes et noms d'hôte](/v1.0/domaines-et-urls/urls-et-routes)
- [Gérer les hôtes IAM](/v1.0/domaines-et-urls/gerer-les-hotes-iam)
- [Prise en compte des changements de configuration](/v1.0/variables-et-secrets/prise-en-compte-des-changements)
