Как перезапускать контейнер автоматически

Справочник · Docker · 1 минута чтения

Bash

docker run -d --name web --restart unless-stopped -p 8080:80 nginx:alpine

С --restart unless-stopped контейнер поднимется сам после сбоя программы, после перезапуска Docker и после перезагрузки сервера. Не поднимется он только в одном случае — если вы остановили его сами командой docker stop.

Какие бывают политики

Политика	Когда перезапускает
`no`	никогда (по умолчанию)
`on-failure`	только если программа завершилась с ошибкой (код выхода не 0)
`on-failure:5`	то же, но не больше 5 попыток подряд
`always`	всегда; остановленный вручную — после перезапуска Docker или сервера
`unless-stopped`	всегда, кроме контейнеров, остановленных вручную

Для сервисов обычно берут unless-stopped. always подходит, если контейнер должен работать даже после того, как его кто-то остановил, — при следующей перезагрузке он вернётся. on-failure — для задач, которые должны завершиться: при успехе их не нужно запускать снова.

Поменять у готового контейнера

Пересоздавать контейнер не нужно:

Bash

docker update --restart unless-stopped web

Для всех работающих контейнеров сразу:

Bash

docker update --restart unless-stopped $(docker ps -q)

Проверить, какая политика стоит:

Bash

docker inspect --format '{{.HostConfig.RestartPolicy.Name}}' web

В Docker Compose

YAML

services:
  web:
    image: nginx:alpine
    restart: unless-stopped

После правки файла — docker compose up -d.

Чтобы работало после перезагрузки

Контейнеры поднимает служба Docker, поэтому она сама должна запускаться при включении компьютера. На Ubuntu и Debian это включено сразу после установки. Проверить и включить:

Bash

systemctl is-enabled docker
sudo systemctl enable docker

Первая команда должна ответить enabled. В Docker Desktop контейнеры поднимаются, когда запущен сам Docker Desktop, — в его настройках можно включить запуск при входе в систему.

Подводные камни

Политика начинает действовать после успешного старта. Docker считает старт успешным, если контейнер проработал хотя бы 10 секунд. Это защищает от бесконечного цикла перезапусков сразу после создания.
Контейнер, который падает снова и снова, Docker перезапускает с растущей паузой между попытками. В docker ps он будет в состоянии Restarting. Причину ищите в docker logs, а не в политике перезапуска.
docker stop и always. Остановленный вручную контейнер с always не поднимется сразу, но поднимется при следующем перезапуске Docker или сервера. Если это неожиданно — используйте unless-stopped.
Не используйте systemd и --restart вместе для одного контейнера: два «надсмотрщика» мешают друг другу. Документация Docker советует политики перезапуска, а не внешние менеджеры процессов.