Как корректно остановить длительно работающий контейнер Docker

Введение

Контейнеры Docker широко используются для запуска различных приложений и служб, но управление жизненным циклом длительно работающих контейнеров может быть сложной задачей. В этом руководстве вы узнаете, как корректно остановить длительно работающий контейнер Docker, обеспечить плавный переход и избежать возможных потерь данных или проблем с приложением.

Понимание жизненного цикла контейнера Docker

Контейнеры Docker имеют четко определенный жизненный цикл, который разработчики должны понимать, чтобы эффективно управлять своими приложениями. В этом разделе будет дан обзор жизненного цикла контейнера Docker, включая различные состояния, через которые может пройти контейнер, и ключевые концепции, лежащие в основе этого цикла.

Состояния контейнера Docker

Контейнеры Docker могут находиться в нескольких различных состояниях в течение своего существования:

Создан (Created): Контейнер создан, но не запущен.
Запущен (Running): Контейнер в настоящее время выполняет свой основной процесс.
Приостановлен (Paused): Основной процесс контейнера приостановлен, но контейнер все еще запущен.
Остановлен (Stopped): Основной процесс контейнера остановлен.
Перезапускается (Restarting): Контейнер в настоящее время перезапускается.
Завершен (Exited): Контейнер остановлен, и его основной процесс завершил работу.

Важно понимать эти состояния, так как они определяют действия, которые вы можете выполнять с контейнером, и ожидаемое поведение.

graph LR
    Created --> Running
    Running --> Paused
    Paused --> Running
    Running --> Stopped
    Stopped --> Running
    Stopped --> Exited

События жизненного цикла контейнера Docker

В дополнение к состояниям контейнера, в течение жизненного цикла контейнера Docker происходят несколько ключевых событий:

Создание (Create): Создается новый контейнер.
Запуск (Start): Запускается основной процесс контейнера.
Остановка (Stop): Останавливается основной процесс контейнера.
Перезапуск (Restart): Контейнер перезапускается вручную или автоматически.
Приостановка/Возобновление (Pause/Unpause): Основной процесс контейнера приостанавливается или возобновляется.
Принудительное завершение (Kill): Основной процесс контейнера принудительно завершается.
Удаление (Delete): Контейнер удаляется из системы.

Понимание этих событий жизненного цикла является важным для управления и автоматизации поведения контейнеров Docker.

Управление жизненным циклом контейнера с помощью Docker CLI

Интерфейс командной строки Docker (Docker CLI) предоставляет несколько команд для взаимодействия с жизненным циклом контейнера:

docker create: Создать новый контейнер.
docker start: Запустить остановленный контейнер.
docker stop: Остановить запущенный контейнер.
docker restart: Перезапустить контейнер.
docker pause: Приостановить запущенный контейнер.
docker unpause: Возобновить работу приостановленного контейнера.
docker kill: Принудительно остановить запущенный контейнер.
docker rm: Удалить контейнер.

Эти команды позволяют вам управлять жизненным циклом контейнеров Docker программно и автоматизировать различные задачи, связанные с управлением контейнерами.

Корректное остановка длительно работающих контейнеров

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

Понимание сигнала SIGTERM

Основной механизм для корректной остановки контейнера Docker - отправка сигнала SIGTERM основному процессу контейнера. Этот сигнал сообщает процессу, что он должен начать процедуру завершения работы и выполнить все необходимые операции по очистке.

По умолчанию, когда вы выполняете команду docker stop, Docker отправляет сигнал SIGTERM основному процессу контейнера и ожидает в течение периода времени по умолчанию (обычно 10 секунд), пока процесс завершит работу. Если процесс не завершает работу в течение этого периода, Docker отправляет сигнал SIGKILL, который принудительно завершает процесс.

Настройка поведения при остановке

Для настройки поведения при остановке длительно работающего контейнера Docker можно использовать следующие параметры:

--stop-signal: Указать альтернативный сигнал, который будет отправлен основному процессу контейнера при выполнении команды docker stop. Например, --stop-signal=SIGINT отправит сигнал SIGINT вместо сигнала SIGTERM по умолчанию.
--stop-timeout: Указать количество секунд, в течение которых нужно ждать, пока основной процесс контейнера завершит работу, прежде чем отправить сигнал SIGKILL. Например, --stop-timeout=30 даст процессу 30 секунд на завершение работы перед принудительным завершением.

Вот пример того, как использовать эти параметры при запуске длительно работающего контейнера:

docker run -d --name my-app --stop-signal=SIGINT --stop-timeout=60 my-app:latest

Эта команда запустит длительно работающий контейнер с именем my-app, и когда будет выполнена команда docker stop, она отправит сигнал SIGINT основному процессу контейнера и будет ждать до 60 секунд, пока процесс завершит работу, прежде чем отправить сигнал SIGKILL.

Реализация корректной остановки в вашем приложении

Для того, чтобы ваши длительно работающие контейнеры Docker останавливались корректно, важно спроектировать ваше приложение так, чтобы оно обрабатывало сигнал SIGTERM (или альтернативный сигнал) и выполняло все необходимые операции по очистке перед выходом. Это может включать такие задачи, как:

Сохранение данных из памяти в постоянное хранилище
Закрытие сетевых соединений или соединений с базой данных
Сброс журналов или другого вывода
Выполнение любых других задач по очистке, специфичных для приложения

Реализуя обработку этого сигнала в вашем приложении, вы можете обеспечить остановку контейнеров в контролируемом и предсказуемом режиме, минимизируя риск потерь данных или других проблем.

Стратегии для корректной остановки

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

Обработка сигналов в вашем приложении

Одна из наиболее важных стратегий для корректной остановки - это реализация обработки сигналов в вашем приложении. Это включает написание кода, который слушает сигнал SIGTERM (или альтернативный сигнал) и выполняет необходимые операции по очистке перед выходом из приложения.

Вот пример того, как можно реализовать обработку сигналов в приложении на Node.js:

process.on("SIGTERM", () => {
  console.log("Received SIGTERM signal, starting graceful shutdown...");
  // Perform cleanup tasks, such as:
  // - Saving in-memory data to persistent storage
  // - Closing network connections or database connections
  // - Flushing logs or other output
  // - Performing any other application-specific cleanup tasks
  console.log("Graceful shutdown complete, exiting process.");
  process.exit(0);
});

Реализуя такую обработку сигналов, ваше приложение может обеспечить контролируемую остановку, минимизируя риск потерь данных или других проблем.

Использование проверок здоровья и проб жизни

Другая стратегия для корректной остановки - это использование встроенных функций проверки здоровья и проб жизни Docker. Эти функции позволяют определить проверки, которые Docker может использовать для определения здоровья и готовности вашего контейнера.

Во время процесса остановки вы можете использовать эти пробы, чтобы сообщить Docker, что ваш контейнер находится в процессе завершения работы, и дать Dockerу возможность подождать завершения остановки перед удалением контейнера.

Вот пример того, как можно настроить проверку здоровья и пробу жизни в вашем контейнере Docker:

## Dockerfile
FROM node:14-alpine
COPY. /app
WORKDIR /app
CMD ["node", "server.js"]
HEALTHCHECK --interval=5s --timeout=3s \
  CMD curl -f http://localhost:3000/healthz || exit 1
LABEL com.labex.shutdown.signal=SIGINT
LABEL com.labex.shutdown.timeout=60

В этом примере инструкция HEALTHCHECK определяет проверку здоровья, которая проверяет конечную точку /healthz на веб - сервере контейнера. Инструкции LABEL определяют сигнал, который будет использоваться для корректной остановки (SIGINT), и период времени ожидания (60 секунд).

Во время процесса остановки ваше приложение может обновить конечную точку проверки здоровья, чтобы сигнализировать, что остановка в процессе, и дать Dockerу возможность подождать завершения остановки перед удалением контейнера.

Использование оркестрационных фреймворков

Если вы запускаете свои контейнеры Docker в оркестрационном фреймворке, таком как Kubernetes или Docker Swarm, вы можете использовать встроенные функции этих фреймворков для помощи в корректной остановке.

Например, в Kubernetes вы можете использовать хук preStop для выполнения команды или скрипта, который выполняет операции по очистке перед остановкой контейнера. Вы также можете использовать поле terminationGracePeriodSeconds, чтобы указать количество времени, которое контейнеру должно быть дано для корректной остановки.

Вот пример того, как можно настроить развертывание в Kubernetes с использованием хука preStop и периода корректной остановки:

## kubernetes-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
        - name: my-app
          image: my-app:latest
          ports:
            - containerPort: 3000
          lifecycle:
            preStop:
              exec:
                command: ["/app/shutdown.sh"]
          terminationGracePeriodSeconds: 60

В этом примере хук preStop запускает скрипт (/app/shutdown.sh), который выполняет все необходимые операции по очистке перед остановкой контейнера. Поле terminationGracePeriodSeconds дает контейнеру 60 секунд для корректной остановки перед принудительным завершением.

Используя эти функции оркестрационных фреймворков, вы можете дополнительно повысить надежность и предсказуемость процесса остановки контейнеров.

Заключение

В этом руководстве вы узнали о важности понимания жизненного цикла контейнера Docker и стратегиях для корректной остановки длительно работающих контейнеров. Следуя описанным рекомендациям, вы можете обеспечить плавный и надежный процесс остановки, минимизируя риск потерь данных или сбоев в работе приложений. Освоение искусства корректной остановки контейнеров - это важный навык для любого разработчика или администратора Docker.