{{tag>sysadmin netadmin docker docker-compose}}

====== Définir la politique de redémarrage des conteneurs ======

docker-compose permet de spécifier la politique de redémarrage du conteneur / service via l'option de configuration **restart**. Les valeurs suivante sont possibles:

  * **no**: Le conteneur ne sera pas redémarré automatiquement.
  * **on-failure[:max-retries]**: redémarre le conteneur s'il se termine avec un code de retour différent de 0 mais limite le nombre de tentatives de redémarrage par le daemon Docker à la valeur **max-entries**.
  * **always**: le daemon Docker redémarre toujours le conteneur lorsqu'il s'arrête.
  * **unless-stopped**: redémarre toujours le conteneur sauf s'il est arbitrairement arrêté.


===== Exemples =====

==== Pas de redémarrage du service ====

Dans cet exemple on désactive le redémarrage automatique du service aService
<code yaml>
services:
  aService:
    restart: no
</code>


===== Limiter les redémarrages en cas d'erreur =====

Ici on limite à trois échecs consécutifs le redémarrage du service "aService". Une fois cette limite atteinte, le daemon Docker stoppe toute tentative de démarrage automatique du conteneur.
 
<file YAML>
version: "3.3"
. . .

services:
  aService:
    image: path/image:version
    restart: on-failure:3
    . . .
</file>


===== Modification de la politique de démarrage =====

Ce paramètre peut être modifié à la volée via la commande [[sysadmin/docker/modifier_configuration_du_container#modifier_la_politique_de_redemarrage_du_conteneur|docker container update]].

Vérifier la configuration effective du conteneur avec **docker container inspect**.

===== Références =====

  * https://www.baeldung.com/ops/docker-compose-restart-policies