# Retirer un service

> Arrêtez un service dans un environnement en supprimant son instance, puis retirez-le de l'architecture si plus aucun environnement ne l'utilise.

Un service se retire en deux temps : d'abord ses instances, environnement par environnement, ce qui arrête ses conteneurs ; ensuite, si vous le souhaitez, sa définition dans l'architecture.

:::warning[Arrêt immédiat]
Supprimer une instance arrête tous les conteneurs du service dans l'environnement. Les autres services qui l'appellent reçoivent des erreurs dès la suppression.
:::

## Avant de commencer

- Retirez les routes qui pointent vers le service dans l'environnement : voir [Domaines et URLs](/v1.0/domaines-et-urls). Une instance qui reçoit encore une route ne peut pas être supprimée.
- Vérifiez qu'aucun autre service n'utilise ses variables calculées (adresse et port du service).

## Supprimer l'instance d'un environnement

1. Dans **Environnements**, ouvrez l'environnement, puis l'onglet **Services**.
2. Ouvrez le menu de la ligne du service et cliquez sur **Supprimer**.
3. Dans la fenêtre **Supprimer l'instance**, cliquez sur **Supprimer**.

Résultat : le message « Service supprimé » s'affiche. L'instance passe en **Suppression…**, la plateforme arrête ses conteneurs et supprime ses objets, puis la ligne disparaît. Les autres services de l'environnement sont redéployés pour mettre à jour leurs variables calculées.

## Retirer le service de l'architecture

Une définition de service ne peut être supprimée que lorsqu'il ne reste plus rien qui en dépend.

1. Supprimez l'instance du service dans **chaque** environnement.
2. Supprimez les builds du service : voir [Gérer le registre d'images](/v1.0/builds-et-deploiements/gerer-le-registre#supprimer-un-build).
3. Retirez les routes d'application et les expositions sur domaine racine qui le désignent, depuis **Architecture** > **URLs**.
4. Dans **Architecture** > **Services**, ouvrez le menu de la ligne du service et cliquez sur **Supprimer**, puis confirmez dans la fenêtre **Supprimer le service**.

Résultat : le message « Service supprimé » (« La définition "API" a été supprimée ») s'affiche et le service disparaît de la liste.

Le dépôt Git du service n'est pas supprimé. Pour le retirer aussi, voir [Connecter un dépôt Git](/v1.0/builds-et-deploiements/connecter-un-depot#supprimer-un-dépôt).

## Vérifier le résultat

- L'onglet **Services** de chaque environnement ne liste plus le service.
- L'onglet **Matrice** de la page **Environnements** n'a plus de ligne pour ce service.

## Dépannage

- « Impossible de supprimer le service » à la suppression d'une instance : une route y est encore rattachée.
- « Impossible de supprimer la définition de service » : il reste une instance (même en cours de suppression), un build, une route ou une exposition sur domaine racine. Attendez la fin des suppressions en cours, puis retirez ce qui reste.

## Voir aussi

- [Cycle de vie des ressources](/v1.0/applications/cycle-de-vie)
- [Supprimer un environnement](/v1.0/applications/supprimer-un-environnement)
