# Mettre une route en ligne

> Instancier une route de l'architecture dans un environnement, suivre la création du DNS et du certificat, resynchroniser ou retirer la route.

Une route déclarée dans l'architecture n'est publiée dans un environnement que lorsque vous l'y instanciez. La plateforme crée alors le DNS, le certificat et le rattachement à la gateway, puis enregistre le nom d'hôte comme hôte IAM.

## Avant de commencer

- La route existe dans l'architecture (voir [Créer une URL et ses routes](/v1.0/domaines-et-urls/creer-une-url-et-ses-routes)).
- Le service ciblé est déployé dans l'environnement.
- Sur un domaine personnalisé, les identifiants DNS sont **Credentials actifs**, et aucun enregistrement existant n'occupe déjà le nom d'hôte chez votre fournisseur.
- Le préfixe de l'environnement est celui que vous voulez garder (voir [Définir le préfixe d'environnement](/v1.0/domaines-et-urls/definir-le-prefixe-d-environnement)). Le changer plus tard recrée DNS et certificats.

## Instancier la route

::::steps
### Ouvrir l'onglet URLs & IAM

Dans le menu, sous le nom de votre application, cliquez sur **Environnements**, ouvrez l'environnement, puis l'onglet **URLs & IAM**.

### Repérer la route à publier

La section **Routes d'architecture manquantes dans l'environnement** liste les routes déclarées mais pas encore en ligne, avec leur nom d'hôte calculé pour cet environnement (**HOSTNAME**, **PATH**, **TYPE**, **SERVICE**).

### Instancier

Sur la ligne de la route, cliquez sur **Instancier**.

Résultat : le message **Route instanciée avec succès** s'affiche. La route rejoint la section **Instances de routes dans l'environnement**, groupée sous son nom d'hôte, avec le statut `PENDING`.
::::

L'instanciation lance aussi la synchronisation des hôtes IAM. Si elle n'aboutit pas, la route est quand même créée et la console affiche **URL créée** avec un message qui vous invite à relancer **Resynchroniser IAM** (voir [Gérer les hôtes IAM](/v1.0/domaines-et-urls/gerer-les-hotes-iam)).

## Suivre la mise en ligne

Dans **Instances de routes dans l'environnement**, la colonne **STATUS** passe de `PENDING` à `PROVISIONING`, puis à `PROVISIONED`. Les colonnes **DERNIÈRE SYNC** et **DERNIÈRE APPLICATION** indiquent la dernière prise en charge et la dernière application réussie.

La durée de `PROVISIONING` dépend surtout de la propagation DNS chez votre fournisseur : le certificat n'est délivré qu'une fois le nom résolu vers la gateway. Cliquez sur **Actualiser** pour rafraîchir la page.

## Resynchroniser une route

Quand une route modifiée dans l'architecture n'est pas encore appliquée dans l'environnement, le bandeau **Drift URLs détecté** apparaît en haut de l'onglet et le tableau **Routes en dérive — configuration désynchronisée** compare l'état appliqué (**Actuel (appliqué)**) à l'état voulu (**Nouveau (désiré)**).

- Pour une route : dans ce tableau, cliquez sur le bouton de la colonne **Action** (**Synchroniser la route**).
- Pour toutes : dans le bandeau, cliquez sur **Tout synchroniser (routes)**.

Résultat : le message **Route synchronisée**, ou le nombre de routes synchronisées, s'affiche. La plateforme applique l'état voulu en quelques secondes. Sans action de votre part, elle le fait de toute façon dans les 5 minutes.

## Retirer une route d'un environnement

Retirer une route n'affecte pas sa déclaration dans l'architecture.

1. Dans **Instances de routes dans l'environnement**, cliquez sur **Supprimer route** sur la ligne de la route. Pour retirer toutes les routes d'un même nom d'hôte, cliquez sur **Supprimer URL (toutes les routes)** dans l'en-tête du groupe.
2. Confirmez dans le dialogue.

Résultat : le message **Suppression lancée** s'affiche et la route passe à `DESTROYING`. La plateforme retire sa règle, puis, s'il ne sert plus à aucune route, le certificat et l'enregistrement DNS du nom d'hôte.

## Vérifier le résultat

1. La route est à `PROVISIONED` dans **Instances de routes dans l'environnement**.
2. Depuis votre poste, la commande suivante renvoie une réponse de votre service, en HTTPS, sans erreur de certificat :

```bash
curl -I https://app.staging.exemple.fr/
```

```text
HTTP/2 200
```

3. La même adresse en `http://` renvoie une redirection `301` vers `https://`.

## Dépannage

- La route reste en `PROVISIONING` : voir [Le certificat reste en attente](/v1.0/domaines-et-urls/depannage#le-certificat-reste-en-attente).
- La route passe à `FAILED` : voir [La route passe en FAILED](/v1.0/domaines-et-urls/depannage#la-route-passe-en-failed).
- **Impossible d'instancier cette route.** : voir [le dépannage](/v1.0/domaines-et-urls/depannage#impossible-dinstancier-cette-route).

## Voir aussi

- [DNS et certificats TLS](/v1.0/domaines-et-urls/certificats-et-dns)
- [Gérer les hôtes IAM](/v1.0/domaines-et-urls/gerer-les-hotes-iam)
- [Liste de contrôle avant la production](/v1.0/domaines-et-urls/liste-de-controle)
