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

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é](/v1.0/domaines-et-urls/ajouter-un-domaine-personnalise)).
- Vous savez à quoi sert aujourd'hui la racine du domaine. La plateforme écrit un enregistrement `A` (ou `AAAA`) à 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

1. Dans le menu, sous le nom de votre application, cliquez sur **Architecture**, puis sur **URLs**.
2. Cliquez sur **Exposer sur le domaine racine**. Le bouton n'apparaît que s'il existe un domaine personnalisé sans domaine racine.
3. Dans **Domaine**, choisissez le domaine.
4. Dans **Service**, choisissez le service vers lequel le trafic de la racine est envoyé.
5. Dans **Chemin**, gardez `/`, et dans **Type de chemin**, gardez `PathPrefix`, sauf besoin particulier.
6. 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

1. Ouvrez l'environnement, puis l'onglet **URLs & IAM**.
2. 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.fr` sans préfixe, `staging.exemple.fr` avec le préfixe `staging`.
3. Cliquez sur **Instancier**.
4. 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

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

```text
HTTP/2 200
```

## Voir aussi

- [Rediriger `www` vers le domaine racine](/v1.0/redirections/rediriger-un-domaine-vers-l-app)
- [DNS et certificats TLS](/v1.0/domaines-et-urls/certificats-et-dns)
- [Résoudre les problèmes de domaines et d'URLs](/v1.0/domaines-et-urls/depannage)
