Skip to content

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.

GuideDeveloper
Required access
Administrateur client avec le droit « Infra Client » (profil Infra)
Duration
5 min

This page has not been translated yet and is shown in French.

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é).
  • Les services vers lesquels router sont déclarés dans l'architecture, avec leur Port dans Réseau par défaut. Voir Services.

Créer l'URL

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.

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).
  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