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.
- Required access
- Droit « Gérer les URLs/routage », et « Accès infrastructure en production » pour un environnement prod
- Duration
- 5 min, plus le temps de propagation DNS
This page has not been translated yet and is shown in French.
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).
- 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). Le changer plus tard recrée DNS et certificats.
Instancier la route
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).
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.
- 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.
- 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
- La route est à
PROVISIONEDdans Instances de routes dans l'environnement. - Depuis votre poste, la commande suivante renvoie une réponse de votre service, en HTTPS, sans erreur de certificat :
curl -I https://app.staging.exemple.fr/HTTP/2 200- La même adresse en
http://renvoie une redirection301vershttps://.
Dépannage
- La route reste en
PROVISIONING: voir Le certificat reste en attente. - La route passe à
FAILED: voir La route passe en FAILED. - Impossible d'instancier cette route. : voir le dépannage.