Ротация журналов контейнера Docker в Linux

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

В этой статье мы расскажем, как настроить ротацию лог-файлов контейнеров Docker в ОС Linux.

Содержание:

1. Настройка ротации лог-файла конкретного контейнера
2. Выполнение ротации журналов в Docker Compose
3. Глобальная настройка ротации журналов Docker
4. Выводы

Настройка ротации лог-файла конкретного контейнера

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

docker run --name <container-name> --log-driver=<value> --log-opt max-size=<value> --log-opt max-file=<value> <image-name>

Где:

• docker run — команда, которая используется для создания и запуска нового контейнера на основе указанного образа;
• --name <container-name> — необязательная опция, которая позволяет задать контейнеру название (если не использовать этот параметр, Docker автоматически сгенерирует случайное название);
• --log-driver=<value> — опция, в качестве значения которой нужно указать драйвер логирования для контейнера (например, json-file);
• --log-opt max-size=<value> — параметр, для которого следует указать максимальный размер лог-файла (если размер журнала достигнет заданного значения, Docker выполнит ротацию);
• --log-opt max-file=<value> — опция, позволяющая определить максимальное количество файлов журнала, которые нужно сохранять (при превышении указанного числа самый старый файл будет удален автоматически);
• <image-name> — название образа, на основе которого будет запущен контейнер.

Читайте также: Как очистить содержимое лог-файла контейнера Docker в Linux.

Для примера запустим контейнер с названием mystifying_joliot на основе образа hello-world. И настроим процесс ротации лог-файлов следующим образом:

• драйвер логирования — json-file;
• максимальный размер лог-файла — 10 Мб;
• хранить до 3 журналов.

docker run --name mystifying_joliot --log-driver=json-file --log-opt max-size=10m --log-opt max-file=3 hello-world

Выполнение ротации журналов в Docker Compose

Docker Compose — это инструмент для описания и управления многоконтейнерными приложениями на Docker. Он позволяет настраивать все сервисы, сети и хранилища данных программы в одном файле docker-compose.yml. Этот документ является «чертежом» для запуска приложения.

Читайте также: Как удалить образы, контейнеры и тома Docker.

Если Вы используете Docker Compose, то настроить ротацию журналов для всех контейнеров одного приложения можно в файле docker-compose.yml. Для этого откройте данный текстовый документ в любом текстовом редакторе и вставьте в него следующий код:

services:
app:
image: <image-name>
logging:
driver: "<value>"
options:
max-size: "<value>"
max-file: "<value>"

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

Сохраните внесенные изменения и закройте файл docker-compose.yml. Затем выполните в терминале следующую команду, чтобы применить настройки ротации журналов:

docker-compose up

Читайте также: Как управлять приложениями внутри контейнера Docker.

Глобальная настройка ротации журналов Docker

У Вас есть возможность установить единый процесс ротации журналов для всех контейнеров Docker в операционной системе. Для этого нужно записать в файл настроек /etc/docker/daemon.json код:

{
"log-driver": "<value>",
"log-opts": {
"max-size": "<value>",
"max-file": "<value>"
}
}

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

sudo systemctl restart docker

Выводы

Мы показали, как настроить ротацию лог-файлов контейнеров Docker в операционной системе Linux. Надеемся, что этот материал был полезным для Вас!

Спасибо за время, уделенное прочтению статьи!

Если возникли вопросы — задавайте их в комментариях.

Подписывайтесь на обновления нашего блога и оставайтесь в курсе новостей мира инфокоммуникаций!

Чтобы знать больше и выделяться знаниями среди толпы IT-шников, записывайтесь на курсы Cisco, курсы по кибербезопасности, полный курс по кибербезопасности, курсы DevNet / DevOps (программируемые системы) от Академии Cisco, курсы Linux от Linux Professional Institute на платформе SEDICOMM University (Университет СЭДИКОММ).