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.
- Required access
- Accès à l'infrastructure de l'application (profil Infra)
- Duration
- 5 min
This page has not been translated yet and is shown in French.
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ée | Effet 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 Container | Aucun 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éfaut | Les instances qui ne surchargent pas la ressource modifiée sont redéployées |
| Health Probes | Les 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
- Dans Architecture > Services, cliquez sur le service, puis sur Modifier.
- 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.
- 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.
- Dans la fiche du service, cliquez sur Modifier.
- 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. - 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
- Rouvrez la fiche du service : l'onglet Général affiche les nouvelles valeurs.
- 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
- Définitions et instances de service
- Dimensionner un service
- Variables et secrets : onglet Variables consommées de la fiche