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

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](/v1.0/services/dimensionner-un-service) à 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 |

:::warning[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](/v1.0/builds-et-deploiements/automatiser-builds-et-deploiements).

## 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](/v1.0/services/depannage#impossible-de-mettre-à-jour-le-service).

## Voir aussi

- [Définitions et instances de service](/v1.0/services/definitions-et-instances)
- [Dimensionner un service](/v1.0/services/dimensionner-un-service)
- [Variables et secrets](/v1.0/variables-et-secrets) : onglet **Variables consommées** de la fiche
