# Configurer un environnement

> Définissez le préfixe d'URL d'un environnement et changez la branche, le tag ou le commit qu'il suit.

Deux réglages d'un environnement se modifient après sa création, depuis l'onglet **Résumé** : le préfixe inséré dans ses URLs publiques et la référence Git qu'il suit.

## Avant de commencer

- L'environnement existe : voir [Créer un environnement](/v1.0/applications/creer-un-environnement).
- Les boutons **Éditer** de la carte **Informations** n'apparaissent que si vous avez le droit de modifier l'environnement.

## Définir le préfixe d'URL

Le [préfixe d'URL](/v1.0/glossaire#préfixe-durl) distingue les URLs publiques de deux environnements. Avec le préfixe `staging`, la route `api` d'un domaine `votre-domaine.fr` devient `api.staging.votre-domaine.fr` ; sans préfixe, elle reste `api.votre-domaine.fr`.

1. Dans **Environnements**, ouvrez l'environnement, puis l'onglet **Résumé**.
2. Dans la carte **Informations**, à côté de **Préfixe URL**, cliquez sur **Éditer**.
3. Dans **Préfixe**, saisissez le préfixe : une lettre minuscule en premier, puis lettres minuscules, chiffres et tirets, 20 caractères au plus. Laissez le champ vide pour publier à la racine.
4. Cliquez sur **Enregistrer**.

Résultat : le message « Préfixe URL mis à jour » s'affiche, puis le bandeau « Synchronisation IAM en cours — les HostRoutes et les redirectUris Keycloak seront mis à jour sous peu. ». La plateforme recalcule les URLs publiques de tous les services de l'environnement et met à jour les adresses de redirection de la connexion.

:::warning[Changer le préfixe change les URLs]
Les anciennes adresses cessent de répondre dès que les nouvelles routes sont appliquées. Prévenez les utilisateurs de l'environnement et mettez à jour les liens externes avant de modifier le préfixe d'un environnement en service.
:::

Si le bandeau reste affiché, cliquez sur **Resynchroniser IAM** pour relancer la mise à jour des adresses de connexion.

Les variables `ROUTE_*` de vos services contiennent le nom d'hôte : redémarrez les services qui s'en servent pour qu'ils reçoivent les nouvelles adresses. Voir [Prise en compte des changements](/v1.0/variables-et-secrets/prise-en-compte-des-changements).

Règles à connaître :

- deux environnements d'une même application ne peuvent pas avoir le même préfixe ;
- un seul environnement de l'application peut être sans préfixe, en général la production ;
- un environnement de type `dev` ou `staging` sans préfixe affiche l'avertissement « Préfixe d'URL manquant » dans son encart de préparation.

## Changer la référence Git suivie

La référence Git est la branche, le tag ou le commit que l'environnement suit. Elle sert au [build automatique et au déploiement automatique](/v1.0/builds-et-deploiements/automatiser-builds-et-deploiements).

1. Dans l'onglet **Résumé**, dans la carte **Informations**, à côté de **Git Ref**, cliquez sur **Éditer**.
2. Dans la fenêtre **Configuration Git**, saisissez la référence dans **Branche / tag / commit**, par exemple `main` ou `v2.3.0`.
3. Dans **Type**, choisissez **Branche**, **Tag** ou **Commit**.
4. Optionnel : cochez **Auto-deploy on new build** ou **Build automatique**. Ces deux cases ne sont disponibles qu'avec le type **Branche**.
5. Cliquez sur **Enregistrer**.

Résultat : le message « Configuration Git mise à jour » s'affiche. La carte **Informations** montre la nouvelle référence, son type, et les badges **Build auto** et **Auto-deploy** s'ils sont activés.

:::note
Changer la référence Git ne redéploie rien. Les services continuent de tourner avec l'image en place jusqu'au prochain déploiement.
:::

## Vérifier le résultat

- La carte **Informations** affiche le nouveau préfixe (ou « Aucun (racine) ») et la nouvelle référence Git.
- Dans l'onglet **URLs & IAM**, les URLs publiques portent le nouveau préfixe une fois les routes appliquées.

## Voir aussi

- [Automatiser les builds et les déploiements](/v1.0/builds-et-deploiements/automatiser-builds-et-deploiements)
- [Domaines et URLs](/v1.0/domaines-et-urls)
- [Référence des champs d'un environnement](/v1.0/applications/reference#environnement)
