# Créer une URL et ses routes

> Déclarer dans l'architecture un sous-domaine sur un domaine, puis envoyer chacun de ses chemins vers un service de l'application.

Une URL et ses routes se déclarent une seule fois, au niveau de l'architecture. Elles s'appliquent ensuite à tous les environnements où vous les instanciez. Cette page couvre la déclaration ; la mise en ligne fait l'objet du guide suivant.

## Avant de commencer

- Le domaine à utiliser existe : un domaine plateforme, ou un domaine personnalisé déjà ajouté (voir [Ajouter un domaine personnalisé](/v1.0/domaines-et-urls/ajouter-un-domaine-personnalise)).
- Les services vers lesquels router sont déclarés dans l'architecture, avec leur **Port** dans **Réseau par défaut**. Voir [Services](/v1.0/services).

## Créer l'URL

::::steps
### Ouvrir les URLs publiques

Dans le menu, sous le nom de votre application, cliquez sur **Architecture**, puis sur **URLs**.

### Déclarer le sous-domaine

Cliquez sur **Nouvelle URL**, puis :

1. Dans **Sous-domaine**, saisissez le libellé, par exemple `app`. Seuls les minuscules, les chiffres et les tirets sont acceptés, 63 caractères au plus ; le libellé commence par une lettre et ne se termine pas par un tiret.
2. Dans **Domaine**, choisissez un domaine du groupe **Domaines plateforme** ou **Domaines personnalisés**.
3. Cliquez sur **Créer**.

Résultat : le message **URL créée** s'affiche et une carte apparaît pour l'URL, avec la mention **Aucune route configurée**.
::::

## Ajouter une route

1. Sur la carte de l'URL, cliquez sur **Ajouter une route**.
2. Dans **URL de rattachement**, vérifiez l'URL proposée.
3. Dans **Chemin**, saisissez le chemin, par exemple `/` ou `/api`. Il commence par `/` et ne se termine pas par `/`, sauf pour la racine.
4. Dans **Type de chemin**, gardez `PathPrefix`, ou choisissez `Exact` ou `RegularExpression`.
5. Dans **Service**, choisissez le service qui reçoit le trafic.
6. Laissez **Port (optionnel)** vide : le trafic est envoyé au port déclaré dans la définition du service.
7. Optionnel : cochez **URL front officielle de l'app** si la route cible le service front principal.
8. Cliquez sur **Créer**.

Résultat : le message **Route créée** s'affiche. La route apparaît dans le tableau de la carte (**Path**, **Service**, **Type**, **Statut**, **Officielle**).

Répétez l'opération pour chaque chemin. Une même URL ne peut porter qu'une route par chemin.

:::important
L'ajout ou la modification d'une route recalcule les variables `ROUTE_*` que la plateforme met à disposition de vos services. Un service qui les utilise ne reçoit la nouvelle valeur qu'à son prochain redémarrage. Voir [Prise en compte des changements](/v1.0/variables-et-secrets/prise-en-compte-des-changements).
:::

## Modifier une route

1. Dans le tableau des routes, cliquez sur l'icône crayon de la ligne (**Modifier la route**).
2. Changez le **Chemin**, le **Type de chemin**, le **Service** ou la case **URL front officielle de l'app**, en laissant **Port (optionnel)** vide.
3. Cliquez sur **Enregistrer**.

Résultat : le message **Route mise à jour** s'affiche. Les environnements où la route est en ligne sont resynchronisés.

## Désigner l'URL front officielle

Dans le tableau des routes, cliquez sur l'étoile de la colonne **Officielle** (**Désigner comme URL front officielle**) de la route choisie.

Résultat : l'étoile passe sur cette route et quitte l'ancienne. Seule une route ciblant un service de rôle FRONT peut être désignée.

## Rattacher une URL sans domaine

Une URL importée avec l'architecture d'une autre app peut arriver sans domaine : sa carte porte le statut **Détachée**.

1. Sur la carte, cliquez sur **Rattacher**.
2. Dans le dialogue **Rattacher à un domaine**, choisissez le domaine, puis cliquez sur **Rattacher**.

Résultat : le message **URL rattachée** s'affiche. Les routes de l'URL déjà instanciées sont remises en ligne avec le nouveau nom d'hôte.

## Supprimer une route ou une URL

Une URL ne peut être supprimée qu'une fois toutes ses routes supprimées, et si aucune redirection ne la cible.

1. Retirez d'abord la route de chaque environnement où elle est en ligne (voir [Mettre une route en ligne](/v1.0/domaines-et-urls/mettre-une-route-en-ligne#retirer-une-route-dun-environnement)).
2. Dans le tableau des routes, cliquez sur l'icône corbeille de la ligne (**Supprimer la route**), puis confirmez.
3. Quand l'URL n'a plus de route, cliquez sur **Supprimer** sur sa carte, puis confirmez.

Résultat : les messages **Route supprimée** puis **URL supprimée** s'affichent.

## Vérifier le résultat

Sur la carte de l'URL, dépliez **Aperçu FQDN par environnement** : chaque environnement affiche le nom d'hôte complet sous lequel l'URL sera servie, préfixe compris.

## Voir aussi

- [URLs, routes et noms d'hôte](/v1.0/domaines-et-urls/urls-et-routes)
- [Mettre une route en ligne](/v1.0/domaines-et-urls/mettre-une-route-en-ligne)
- [Rediriger un domaine vers l'app](/v1.0/redirections/rediriger-un-domaine-vers-l-app)
