Skip to content

Configurer un environnement

Définissez le préfixe d'URL d'un environnement et changez la branche, le tag ou le commit qu'il suit.

GuideDeveloper
Required access
Droit « Modifier un environnement » ; « Accès infrastructure en production » en plus pour un environnement Production
Duration
5 min

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

Deux réglages d'un environnement se modifient après sa création, depuis l'onglet Résumé : le préfixe inséré dans ses URLs publiques et la référence Git qu'il suit.

Avant de commencer

  • L'environnement existe : voir Créer un environnement.
  • Les boutons Éditer de la carte Informations n'apparaissent que si vous avez le droit de modifier l'environnement.

Définir le préfixe d'URL

Le préfixe d'URL distingue les URLs publiques de deux environnements. Avec le préfixe staging, la route api d'un domaine votre-domaine.fr devient api.staging.votre-domaine.fr ; sans préfixe, elle reste api.votre-domaine.fr.

  1. Dans Environnements, ouvrez l'environnement, puis l'onglet Résumé.
  2. Dans la carte Informations, à côté de Préfixe URL, cliquez sur Éditer.
  3. Dans Préfixe, saisissez le préfixe : une lettre minuscule en premier, puis lettres minuscules, chiffres et tirets, 20 caractères au plus. Laissez le champ vide pour publier à la racine.
  4. Cliquez sur Enregistrer.

Résultat : le message « Préfixe URL mis à jour » s'affiche, puis le bandeau « Synchronisation IAM en cours — les HostRoutes et les redirectUris Keycloak seront mis à jour sous peu. ». La plateforme recalcule les URLs publiques de tous les services de l'environnement et met à jour les adresses de redirection de la connexion.

Changer le préfixe change les URLs

Les anciennes adresses cessent de répondre dès que les nouvelles routes sont appliquées. Prévenez les utilisateurs de l'environnement et mettez à jour les liens externes avant de modifier le préfixe d'un environnement en service.

Si le bandeau reste affiché, cliquez sur Resynchroniser IAM pour relancer la mise à jour des adresses de connexion.

Les variables ROUTE_* de vos services contiennent le nom d'hôte : redémarrez les services qui s'en servent pour qu'ils reçoivent les nouvelles adresses. Voir Prise en compte des changements.

Règles à connaître :

  • deux environnements d'une même application ne peuvent pas avoir le même préfixe ;
  • un seul environnement de l'application peut être sans préfixe, en général la production ;
  • un environnement de type dev ou staging sans préfixe affiche l'avertissement « Préfixe d'URL manquant » dans son encart de préparation.

Changer la référence Git suivie

La référence Git est la branche, le tag ou le commit que l'environnement suit. Elle sert au build automatique et au déploiement automatique.

  1. Dans l'onglet Résumé, dans la carte Informations, à côté de Git Ref, cliquez sur Éditer.
  2. Dans la fenêtre Configuration Git, saisissez la référence dans Branche / tag / commit, par exemple main ou v2.3.0.
  3. Dans Type, choisissez Branche, Tag ou Commit.
  4. Optionnel : cochez Auto-deploy on new build ou Build automatique. Ces deux cases ne sont disponibles qu'avec le type Branche.
  5. Cliquez sur Enregistrer.

Résultat : le message « Configuration Git mise à jour » s'affiche. La carte Informations montre la nouvelle référence, son type, et les badges Build auto et Auto-deploy s'ils sont activés.

Note

Changer la référence Git ne redéploie rien. Les services continuent de tourner avec l'image en place jusqu'au prochain déploiement.

Vérifier le résultat

  • La carte Informations affiche le nouveau préfixe (ou « Aucun (racine) ») et la nouvelle référence Git.
  • Dans l'onglet URLs & IAM, les URLs publiques portent le nouveau préfixe une fois les routes appliquées.

Voir aussi