Exposer le domaine racine
Servir votre application sur exemple.fr, sans sous-domaine, en déclarant le domaine racine dans l'architecture puis en l'instanciant par environnement.
- Accès requis
- Droit « Infra Client » pour la déclaration ; « Gérer les URLs/routage » pour l'instanciation (et « Accès infrastructure en production » en prod)
- Durée
- 10 min
Le domaine racine (ou apex) est le domaine lui-même, exemple.fr, sans sous-domaine. Il ne s'expose que sur un domaine personnalisé. Comme pour une URL, vous le déclarez une fois dans l'architecture, puis vous l'instanciez dans chaque environnement.
Avant de commencer
- Le domaine est un domaine personnalisé de l'app, avec des identifiants DNS actifs (voir Ajouter un domaine personnalisé).
- Vous savez à quoi sert aujourd'hui la racine du domaine. La plateforme écrit un enregistrement
A(ouAAAA) à la racine de la zone : si un site y répond déjà, il ne sera plus joignable. - Aucune redirection depuis la racine n'est déclarée sur ce domaine : les deux ne peuvent pas coexister.
Déclarer le domaine racine
- Dans le menu, sous le nom de votre application, cliquez sur Architecture, puis sur URLs.
- Cliquez sur Exposer sur le domaine racine. Le bouton n'apparaît que s'il existe un domaine personnalisé sans domaine racine.
- Dans Domaine, choisissez le domaine.
- Dans Service, choisissez le service vers lequel le trafic de la racine est envoyé.
- Dans Chemin, gardez
/, et dans Type de chemin, gardezPathPrefix, sauf besoin particulier. - Cliquez sur Déclarer l'apex.
Résultat : le message Domaine racine déclaré s'affiche. La section Domaine racine (apex) de la page liste la déclaration. Rien n'est encore publié.
Instancier le domaine racine dans un environnement
- Ouvrez l'environnement, puis l'onglet URLs & IAM.
- Dans la section Domaine racine (apex), repérez la ligne dans Apex déclarés à instancier dans cet environnement. La colonne FQDN DANS CET ENVIRONNEMENT indique le nom servi :
exemple.frsans préfixe,staging.exemple.fravec le préfixestaging. - Cliquez sur Instancier.
- Lisez l'avertissement Attention : exposition du domaine racine, puis cliquez sur Je confirme, exposer le domaine racine.
Résultat : le message Apex instancié s'affiche. La ligne passe dans le tableau des instances (FQDN, STATUS, DERNIÈRE SYNC) et suit le cycle PENDING, PROVISIONING, PROVISIONED. En cas d'échec, le message d'erreur s'affiche sous le statut FAILED.
Modifier ou retirer le domaine racine
- Changer le service ou le chemin : dans Architecture > URLs, section Domaine racine (apex), cliquez sur Modifier, changez les champs, puis enregistrez. Le message Apex mis à jour confirme ; les environnements où l'apex est en ligne sont resynchronisés automatiquement.
- Retirer d'un environnement : dans l'onglet URLs & IAM, cliquez sur Supprimer sur la ligne de l'instance, puis confirmez. Le message Suppression de l'apex lancée s'affiche.
- Supprimer la déclaration : retirez d'abord l'apex de tous les environnements et supprimez les redirections qui le ciblent, puis cliquez sur Supprimer dans Architecture > URLs et confirmez.
Vérifier le résultat
curl -I https://exemple.fr/HTTP/2 200