# Déployer une image

> Mettez en service, dans un environnement, une image construite par un build, et suivez le remplacement des conteneurs.

Déployer une image remplace la version qui tourne sur un service déployé. Les conteneurs sont remplacés progressivement : la nouvelle version reçoit du trafic dès qu'elle est prête, puis l'ancienne s'arrête.

## Avant de commencer

- Le service est déjà déployé dans l'environnement. Sinon, voir [Déployer un service](/v1.0/services/deployer-un-service).
- Le build de l'image a réussi : voir [Suivre un build](/v1.0/builds-et-deploiements/suivre-un-build).
- Pour la production, nous recommandons de déployer une image déjà validée dans un environnement de recette, identifiée par son tag.

## Déployer l'image

1. Dans **Environnements**, ouvrez l'environnement, puis l'onglet **Services**, puis le service.
2. En haut de la page, cliquez sur **Déployer**. Vous pouvez aussi cliquer sur **Déployer une image** dans la carte **Déploiement actuel**.
3. Dans la fenêtre **Déployer une image**, choisissez l'image dans **Image Tag**. Chaque image affiche son tag et sa branche ; les plus récentes sont en tête.
4. Cliquez sur **Déployer**.

Résultat : le message « Enregistré » s'affiche. L'instance repasse par **En attente** et **Provisionnement…**, puis **Provisionné** quand les nouveaux conteneurs sont prêts, en général en moins d'une minute après la prise en charge.

Si l'image choisie tourne déjà sur le service, rien n'est redéployé. Pour relancer les mêmes conteneurs, utilisez **Redémarrer** : voir [Redémarrer un service](/v1.0/services/redemarrer-un-service).

## Suivre le déploiement

1. Ouvrez l'onglet **Déploiements** de la page du service.
2. La première ligne, de raison « Image mise à jour », passe de **En attente** à **En cours**, puis **Réussi**.
3. Cliquez sur la ligne pour voir l'**Image courante** et l'**Image précédente**.

Si vous déployez une autre image avant la fin du premier déploiement, celui-ci est marqué **Remplacé** : seule la dernière image demandée est déployée.

## Vérifier le résultat

- La carte **Déploiement actuel** de l'onglet **Vue générale** affiche le nouveau tag.
- L'état de santé du service est **Sain**.
- L'onglet **Logs** montre le démarrage de la nouvelle version.

## Dépannage

- La liste **Image Tag** affiche « Aucun build disponible » : aucun build du service n'a réussi. Lancez-en un.
- Le message « Erreur » s'affiche : l'instance est en cours de suppression, ou l'image correspond à un build supprimé. Rechargez la page et choisissez une autre image.
- Le déploiement reste **En cours** : les nouveaux conteneurs ne démarrent pas. Voir [Résoudre les problèmes de services](/v1.0/services/depannage#le-service-reste-en-provisionnement).

## Voir aussi

- [Revenir à une version précédente](/v1.0/builds-et-deploiements/revenir-a-une-version-precedente)
- [Automatiser les builds et les déploiements](/v1.0/builds-et-deploiements/automatiser-builds-et-deploiements)
- [Consulter l'historique des déploiements](/v1.0/builds-et-deploiements/consulter-l-historique-des-deploiements)
