Aller au contenu

Modifier un service

Changez le dépôt, l'image, le port, les ressources par défaut ou les sondes d'un service, et sachez quelles instances seront redéployées.

GuideDéveloppeur
Accès requis
Accès à l'infrastructure de l'application (profil Infra)
Durée
5 min
Voir en Markdown

La fiche d'un service regroupe tout ce qui est commun à ses instances. La modifier change la valeur par défaut pour tous les environnements ; pour un seul environnement, dimensionnez l'instance à la place.

Avant de commencer

Repérez l'effet de votre modification :

Carte modifiéeEffet sur les instances
Code source (dépôt, répertoire racine, Dockerfile, contexte, chemins ignorés)Aucun redéploiement ; le prochain build en tient compte
Image ContainerAucun redéploiement ; le prochain build et le prochain déploiement utilisent le nouveau chemin
Réseau par défaut (exposition, protocole, port)Toutes les instances sont redéployées
Ressources par défautLes instances qui ne surchargent pas la ressource modifiée sont redéployées
Health ProbesLes instances du service sont redéployées

Changer le port

Le port doit correspondre à celui sur lequel votre conteneur écoute. Un port erroné rend les sondes de santé en échec et le service injoignable. Si vous changez le port d'écoute dans votre code, déployez la nouvelle image et modifiez le port dans la même fenêtre de maintenance.

Modifier la fiche

  1. Dans Architecture > Services, cliquez sur le service, puis sur Modifier.
  2. Dans l'onglet Général, modifiez les champs voulus :
    • Code source : Repository, Répertoire racine, Dockerfile, Contexte de build ;
    • Image Container : Registry, Projet, Nom de l'image ;
    • Réseau par défaut : Port ;
    • Ressources par défaut : CPU Request, CPU Limit, Memory Request, Memory Limit ;
    • Health Probes : interrupteurs Liveness Probe, Readiness Probe, Startup Probe.
  3. Cliquez sur Enregistrer.

Résultat : le message « Service mis à jour » s'affiche et la fiche revient en lecture. Les redéploiements apparaissent dans l'onglet Deployments de chaque environnement concerné, avec la raison « Valeur par défaut d'architecture appliquée » ou « Configuration réseau modifiée ».

Ignorer des chemins pour le build automatique

Dans un monorepo, un changement de documentation ne doit pas reconstruire tous les services. La liste Ignorer ces chemins pour le build automatique exclut des fichiers du déclenchement automatique.

  1. Dans la fiche du service, cliquez sur Modifier.
  2. Dans la carte Code source, saisissez un motif sous Ignorer ces chemins pour le build automatique, par exemple docs/**, puis cliquez sur Ajouter. Répétez pour chaque motif.
  3. Cliquez sur Enregistrer.

Les motifs sont relatifs au répertoire racine du service et suivent la syntaxe glob : *.md, docs/**, .github/**, CHANGELOG.md. Un push qui ne touche que des chemins ignorés ne déclenche pas de build ; voir Automatiser les builds et les déploiements.

Vérifier le résultat

  1. Rouvrez la fiche du service : l'onglet Général affiche les nouvelles valeurs.
  2. Dans chaque environnement, onglet Deployments, les déploiements déclenchés passent de En attente à Réussi.

Dépannage

« Impossible de mettre à jour le service » : un champ a un format refusé, le plus souvent une ressource sans unité ou au-delà du plafond. Voir Résoudre les problèmes de services.

Voir aussi