Définir le préfixe d'environnement
Insérer un segment comme staging dans tous les noms d'hôte d'un environnement, pour que dev, staging et prod ne se disputent pas les mêmes URLs.
- Required access
- Droit « Modifier un environnement », et « Accès infrastructure en production » pour un environnement prod
- Duration
- 5 min
This page has not been translated yet and is shown in French.
Le préfixe d'environnement s'insère dans le nom d'hôte de chaque URL de l'environnement : avec le préfixe staging, l'URL app sur exemple.fr est servie sous app.staging.exemple.fr. Il évite de déclarer des URLs différentes par environnement.
Avant de commencer
- Choisissez des préfixes courts et stables :
dev,staging,recette. Chaque changement recrée les enregistrements DNS et les certificats de toutes les routes de l'environnement. - Un seul environnement de l'app peut ne pas avoir de préfixe, en général la prod. Deux environnements ne peuvent pas non plus partager le même préfixe.
Définir le préfixe
- Ouvrez l'environnement, puis l'onglet URLs & IAM.
- Dans l'encart Préfixe URL d'environnement, cliquez sur Éditer. La valeur actuelle s'affiche, ou Aucun (URLs publiées à la racine).
- Dans Préfixe, saisissez la valeur : une lettre minuscule en premier, puis minuscules, chiffres et tirets, 20 caractères au plus. Laissez le champ vide pour retirer le préfixe.
- Cliquez sur Enregistrer.
Résultat : le message Préfixe URL mis à jour s'affiche, suivi de Synchronisation IAM en cours…. Les routes, le domaine racine et les redirections de l'environnement sont remis en ligne sous leurs nouveaux noms ; l'ancien nom continue de répondre jusqu'à ce que le nouveau soit prêt.
Vous pouvez aussi modifier le préfixe depuis l'onglet Résumé de l'environnement, carte Informations, bouton Éditer.
Important
Les variables ROUTE_* de vos services et les valeurs libres qui les utilisent contiennent le nom d'hôte. Après un changement de préfixe, redémarrez les services qui s'en servent (bouton Redémarrer de la page du service) pour qu'ils reçoivent les nouvelles adresses.
Vérifier le résultat
- Dans Architecture > URLs, Aperçu FQDN par environnement affiche les nouveaux noms.
- Dans l'onglet URLs & IAM, les routes repassent à
PROVISIONEDsous le nouveau nom d'hôte. - La section Hôtes IAM liste les nouveaux noms. Si un message vous invite à relancer la synchronisation, cliquez sur Resynchroniser IAM.
Sur l'onglet Résumé d'un environnement dev ou staging sans préfixe, l'encart Préfixe d'URL manquant vous le signale.
Dépannage
- Format invalide ou Préfixe trop long : corrigez la valeur selon les règles de l'étape 3.
- Message
urlPrefix "…" is already used by another environment of this app: un autre environnement utilise ce préfixe. - Message
urlPrefix is already NULL for another environment of this app…: un autre environnement n'a déjà pas de préfixe ; donnez-en un à l'un des deux.