Quadlet и Podlet в Podman

#

Контейнеры без Kubernetes и Docker Compose

#

Если вам понравилась настоящая статья, то можете поддержать автора став спонсором на бусти (ссылка в разделе контакты).

Когда я только переезжал с Docker Compose на Podman, у меня в голове была небольшая путаница с двумя очень похожими по звучанию терминами - Quadlet и Podlet. Звучат почти одинаково, оба связаны с контейнерами, оба всплывают в одном контексте - и первое время я, чего греха таить, путал их местами. Разница на деле принципиальная: Quadlet - это встроенный в Podman формат описания контейнеров через systemd, а Podlet - отдельная утилита, которая помогает эти описания генерировать, а не писать руками с нуля. В этой статье разберу оба инструмента подробно, покажу примеры конфигураций и сравню такой подход с привычным Docker Compose.

Если вы ещё не читали общий обзор самого Podman, лучше начать с него - там подробнее про daemonless-архитектуру, rootless-режим и общую логику проекта: Podman: современная альтернатива Docker.

1. Quadlet

#

Что такое Quadlet

#

Quadlet - это встроенный в Podman механизм, позволяющий описывать контейнеры, поды, сети, volume’ы и образы декларативно, обычными systemd unit-файлами специального формата. При старте системы systemd сам транслирует такие файлы в полноценные .service-юниты и запускает их через Podman - ничего генерировать вручную не требуется, достаточно daemon-reload.

Quadlet появился как развитие идеи podman generate systemd, только вместо императивного “сгенерируй юнит из уже запущенного контейнера” здесь всё наоборот - вы декларативно описываете желаемое состояние, а systemd приводит систему к этому состоянию сам, в том числе после перезагрузки хоста.

Типы Quadlet-файлов

#

Где размещаются Quadlet-файлы

#

• /etc/containers/systemd/ - системные (root) юниты;
• ~/.config/containers/systemd/ - пользовательские, rootless-юниты.

Пример .container-файла

#

[Container]
Image=docker.io/library/nginx:latest
ContainerName=nginx
PublishPort=8080:80
Volume=nginx-data:/usr/share/nginx/html:Z

[Service]
Restart=always

[Install]
WantedBy=multi-user.target

Пример .pod-файла

#

Если нужно объединить несколько контейнеров в один под с общей сетью, для этого есть отдельный тип юнита .pod:

# web-pod.pod
[Pod]
PublishPort=8080:80

А сами контейнеры затем подключаются к этому поду через ссылку на .pod-файл:

# web-app.container
[Container]
Image=myapp:latest
Pod=web-pod.pod

[Service]
Restart=always

# web-cache.container
[Container]
Image=docker.io/library/redis:latest
Pod=web-pod.pod

[Service]
Restart=always

Все контейнеры, привязанные к одному поду, разделяют общий сетевой namespace и видят друг друга через localhost - точно так же, как если бы под создавался вручную командой podman pod create.

Управление Quadlet-юнитами

#

systemctl daemon-reload
systemctl enable --now nginx.container
systemctl status nginx.container
journalctl -u nginx.container -f

С этого момента контейнер - полноценный systemd-сервис: автозапуск при загрузке через [Install], управление зависимостями через After=/Requires=, единый журнал через journalctl, штатный Restart= вместо самодельных скриптов-обвязок.

Преимущества Quadlet

#

• нативная интеграция с systemd - никаких обходных путей и самодельных обвязок;
• автозапуск и восстановление после сбоя штатными средствами systemd;
• управление зависимостями между сервисами (например, “запускать после того, как поднялась сеть”);
• единое централизованное логирование через journalctl;
• полная поддержка rootless-режима.

Ограничения Quadlet

#

• требует systemd - на системах без него (некоторые embedded-дистрибутивы, часть Alpine-окружений) не работает;
• рассчитан на один хост - никакой кластеризации;
• не заменяет Kubernetes, если вам действительно нужны autoscaling, service discovery на несколько узлов и HA.

2. Podlet

#

Что такое Podlet

#

Podlet - это отдельная утилита на Rust, которая не входит в состав самого Podman, но плотно с ним используется. Задача Podlet простая и полезная: избавить вас от необходимости писать Quadlet-секции руками, если под рукой уже есть рабочая команда podman run/docker run или файл docker-compose.yml.

Важно: Podlet не создаёт контейнеры и не является рантаймом - он только генерирует текст готового Quadlet-файла, который затем нужно сохранить в нужную директорию и подхватить через systemctl daemon-reload.

Генерация из команды

#

Самый простой сценарий - взять существующую команду запуска и просто заменить podman run/docker run на podlet podman run:

podlet podman run -d -p 8080:80 -v nginx-data:/usr/share/nginx/html:Z --name nginx nginx:latest

На выходе - готовый .container-файл со всеми нужными секциями [Container], [Service], [Install], который остаётся сохранить в ~/.config/containers/systemd/ или /etc/containers/systemd/.

Генерация из docker-compose.yml

#

Это, пожалуй, самый практически полезный режим при миграции с Docker Compose:

podlet compose docker-compose.yml

Podlet разберёт файл и, в зависимости от структуры проекта, либо создаст по отдельному .container-файлу на каждый сервис, либо сгруппирует связанные сервисы в один .pod вместе с сопутствующими .container-файлами - так, чтобы результат максимально соответствовал исходной архитектуре compose-проекта.

Генерация из уже работающего объекта

#

Если контейнер, под, сеть или volume уже созданы вручную и работают, Podlet может “снять” с них Quadlet-конфигурацию:

podlet generate container nginx

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

Зачем нужен Podlet на практике

#

• резко упрощает миграцию с Docker и Docker Compose - не нужно вручную разбираться в синтаксисе всех секций Quadlet;
• снижает число ошибок при ручном написании unit-файлов (забытый [Install], неверная секция Volume= и подобное);
• ускоряет сам процесс перехода - для типового проекта результат Podlet чаще всего нужно только слегка донастроить, а не писать с нуля.

3. Quadlet и Podlet вместе

#

Проще всего запомнить разницу так: Quadlet - это формат, который выполняется, а Podlet - это инструмент, который его пишет за вас. Они не конкурируют и не заменяют друг друга - это разные слои одного и того же процесса.

Docker Compose / podman run
        │
        ▼
     Podlet   ← генерирует Quadlet-файлы
        │
        ▼
    Quadlet   ← декларативный формат
        │
        ▼
     systemd  ← превращает Quadlet в .service и запускает
        │
        ▼
     Podman   ← реально запускает контейнеры/поды

На практике типичный рабочий процесс выглядит так: берёте существующий docker-compose.yml, прогоняете его через podlet compose, получаете набор .container/.pod-файлов, кладёте их в ~/.config/containers/systemd/, делаете daemon-reload - и с этого момента всё живёт как обычные systemd-сервисы.

4. Сравнение с Docker Compose

#

Отдельно стоит понимать: Quadlet - это не прямая замена Docker Compose один в один, а скорее иной подход к тому же результату - вместо одного YAML-файла, который парсит отдельный инструмент (docker compose/podman-compose), вы получаете набор systemd-юнитов, которые распознаёт сама операционная система. Для тех, кто и так привык управлять сервисами через systemctl, это выглядит естественнее, чем держать в системе параллельный слой оркестрации compose-файлов.

5. Практические сценарии

#

Homelab. Nextcloud, медиасерверы (Jellyfin, Plex), reverse proxy (Traefik, Caddy, nginx), мониторинг (Prometheus, Grafana) - типичный набор self-hosted сервисов, которые прекрасно живут как Quadlet-юниты и переживают перезагрузку хоста без дополнительных скриптов.

VPS / выделенный сервер. Веб-приложения, приватные API, раннеры CI/CD - там, где нужен один надёжный хост без затрат на поддержку кластера.

Edge / IoT. Минимальное потребление ресурсов, rootless-режим по умолчанию и простое сопровождение особенно ценны на слабом железе.

6. Когда Quadlet - не то, что нужно

#

Если вам требуется:

• горизонтальное автомасштабирование под нагрузкой;

• HA-кластер из нескольких физических узлов;

• multi-region deployment с распределением нагрузки между дата-центрами,

• значит, вы уже выросли из задач одного хоста, и здесь нужен полноценный Kubernetes. Quadlet отлично закрывает потребности single-node инфраструктуры, но сознательно не пытается конкурировать с оркестрацией на уровне кластера.

7. Итог

#

• Quadlet - декларативный формат, который превращает контейнеры, поды, сети и volume’ы Podman в обычные systemd-сервисы.
• Podlet - инструмент, который генерирует Quadlet-файлы из podman run, docker-compose.yml или уже работающих объектов, экономя время на ручном написании синтаксиса.
• Вместе они дают безопасную, минималистичную single-node платформу без демона и без Kubernetes - для большинства self-hosted сценариев этого более чем достаточно.

Docker Compose - привычно, Podman - безопасно, Quadlet - декларативно и по-systemd’овски, Podlet - экономит время на переходе, Kubernetes - когда одного хоста уже мало. Выбор конкретного инструмента должен определяться реальной задачей, а не модой.

Полезные ссылки:

• Официальный сайт Podman
• Документация по Quadlet (man podman-systemd.unit)
• Репозиторий Podlet на GitHub