Содержание
Podman
Установка
# Установить sudo apt install podman # Прописать псевдоним docker, чтобы было привычно echo "alias docker=podman" >> ~/.bash_aliases
Настройка
Реестры образов
Приватный реестр - поиск в нём без указания полного адреса (unqualified-search-registries) и доступ по HTTP или кривому HTTPS (insecure=true)
- ~/.config/containers/registries.conf
unqualified-search-registries = ['k1:8082'] [[registry]] location="k1:8082" insecure=true
Сеть
https://github.com/containers/podman/blob/main/docs/tutorials/basic_networking.md
Стандартная сеть называется podman, там не включён DNS, поэтому контейнеры не могут обратиться друг к другу по имени. Решение - создать новую сеть и подключать контейнеры к ней. При создании новой сети DNS по умолчанию включается.
# Создать сеть mynet, если её не существует podman network exists mynet || podman network create mynet # Либо создать и не выдавать ошибку, если сеть уже есть podman network create --ignore mynet # DNS включён podman network inspect mynet |jq -r .[].dns_enabled true # В сети podman DNS выключен podman network inspect podman |jq -r .[].dns_enabled false
Systemd
Chapter 14. Porting containers to systemd using Podman
podman-systemd.unit - systemd units using Podman Quadlet
https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html
Quadlet — это генератор юнит-файлов systemd: вы описываете контейнер в .container или .pod-файле, а он создаёт полноценную systemd‑службу, которую удобно запускать как пользовательский юнит (systemd --user). Получается чисто, предсказуемо, без лишних демонов и с удобным журналированием через journald.
Podman Quadlet: rootless systemd на VDS — практическое руководство
Пример создания
FileBrowser Quantum под непривилегированным пользователем.
Создать файл .container, из которого будет генерироваться systemd-unit.
- ~/.config/containers/systemd/filebrowser.container
[Unit] Description=Filebrowser [Container] ContainerName=filebrowser Image=docker.io/gtstef/filebrowser:stable-slim Environment=FILEBROWSER_CONFIG=data/config.yaml Environment=TZ=Europe/Moscow PublishPort=8080:80 LogDriver=journald Volume=%h/volumes/filebrowser/data:/home/filebrowser/data Volume=%h/volumes/filebrowser/media:/media [Service] Restart=on-failure TimeoutStopSec=30 ExecStartPre=-mkdir -p %h/volumes/filebrowser/data %h/volumes/filebrowser/media [Install] WantedBy=default.target
Конфигурационный файл Filebrowser
- ~/volumes/filebrowser/data/config.yaml
server: database: "data/database.db" sources: - path: "/media" config: defaultEnabled: true # Give access to all users by default auth: adminUsername: admin adminPassword: admin
# Чтобы сгенерировался юнит-файл, надо перечитать конфигурацию systemctl --user daemon-reload # Можно запускать systemctl --user start filebrowser # Enable делать не надо (это и не сработает): systemctl --user enable filebrowser Failed to enable unit: Unit /run/user/1000/systemd/generator/filebrowser.service is transient or generated. # Контейнер сам будет запускаться при загрузке системы, # т. к. в секции [Install] файла filebrowser.container прописана строка WantedBy=default.target. # Нужно только включить возможность запуска пользовательских сервисов systemd без необходимости входа пользователя в систему. loginctl enable-linger $USER
Дебаг
Если файлы .service не генерируются, то посмотреть на ошибки можно командой
# Для непривилегированного пользователя /usr/lib/systemd/system-generators/podman-system-generator --user --dryrun
https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html#debugging-unit-files
Список сгенерированных файлов
ls -l $XDG_RUNTIME_DIR/systemd/generator
Автообновление
Чтобы включить возможность автообновления, нужно добавить в .container-файл строку AutoUpdate=registry (или запустить контейнер интерактивно с аргументом --label "io.containers.autoupdate=registry").
[Container] ContainerName=filebrowser Image=docker.io/gtstef/filebrowser:stable-slim AutoUpdate=registry
После этого обновить все подобные контейнеры можно командой
podman auto-update
Будут скачаны новые версии образов и контейнеры будут перезапущены.
Плюсы
Нет возни с правами на файлы
При создании файлов в контейнере права на файле принадлежат пользователю, несмотря на то, что внутри контейнера они создавались от рута.
# В контейнере смонтирован каталог /usr/share/nginx/html в ~/volumes/mynginx/html на хосте user@k2:~$ podman exec -it mynginx sh / # id uid=0(root) gid=0(root) / # cd /usr/share/nginx/html /usr/share/nginx/html # echo "<h1>Hello 1.0.1</h1>" > index.html /usr/share/nginx/html # exit user@k2:~$ id uid=1000(user) gid=1000(user) groups=1000(user),4(adm),24(cdrom),27(sudo),30(dip),46(plugdev),101(lxd) user@k2:~$ ls -l volumes/mynginx/html/ total 4 -rw-r--r-- 1 user user 21 Dec 20 05:13 index.html
На самом деле, если в контейнере работает другой пользователь, то надо делать привязку хостового пользователя к контейнерному, вот пример Wordpress + MariaDB:
MariaDB: привязка к UID 999 (mysql).
- ~/.config/containers/systemd/wordpress-db.container
[Unit] Description=Wordpress MariaDB [Container] ContainerName=wordpress-db Image=docker.io/mariadb:lts Network=mynet UserNS=keep-id:uid=999,gid=999 Environment=MYSQL_DATABASE=wordpress Environment=MYSQL_USER=wordpress Environment=MYSQL_ROOT_PASSWORD=wordpress555 Environment=MYSQL_PASSWORD=wordpress555 Volume=%h/volumes/wordpress/database:/var/lib/mysql [Service] Restart=on-failure TimeoutStartSec=60 ExecStartPre=-mkdir -p %h/volumes/wordpress/database [Install] WantedBy=default.target
Wordpress: здесь привязка к UID 33 (www-data). Также, указан параметр User=0:0: если не указать его, то контейнер не запустится, потому что основной процесс Apache работает от рута.
(13)Permission denied: AH00072: make_sock: could not bind to address 0.0.0.0:80
Dec 20 20:09:30 k2 wordpress[3080]: no listening sockets available, shutting down
- ~/.config/containers/systemd/wordpress.container
[Unit] Description=Wordpress After=wordpress-db.service Requires=wordpress-db.service [Container] ContainerName=wordpress Image=docker.io/wordpress User=0:0 UserNS=keep-id:uid=33,gid=33 Network=mynet PublishPort=8082:80 Environment=WORDPRESS_DB_HOST=wordpress-db:3306 Environment=WORDPRESS_DB_NAME=wordpress Environment=WORDPRESS_DB_USER=wordpress Environment=WORDPRESS_DB_PASSWORD=wordpress555 Volume=%h/volumes/wordpress/html:/var/www/html [Service] Restart=on-failure TimeoutStartSec=60 ExecStartPre=-mkdir -p %h/volumes/wordpress/html [Install] WantedBy=default.target
Сеть нужна со включённым DNS (т. е., не сеть по умолчанию), т. к. обращение к базе идёт по имени контейнера. Если засунуть контейнеры в под, то невозможно будет привязывать пользователей в каждом контейнере, потому что UserNS= на уровне контейнера будет игнорироваться в пользу пода (If --pod is set, --userns is ignored and the user namespace of the pod is used).
Нет дополнительного root-демона
Нет дополнительного демона, стандартно работающего от рута, как в Докере, соответственно, нет вытекающих из этого проблем с безопасностью.
Интеграция с systemd
Контейнеры могут работать как службы systemd. Также можно сделать зависимость одного контейнера от другого можно так же, как и у служб systemd.
Здесь при запуске контейнера filebrowser сначала запустится mynginx. Если mynginx остановить, остановится и filebrowser.
- ~/.config/containers/systemd/filebrowser.container
[Unit] Description=Filebrowser After=mynginx.service Requires=mynginx.service
Зависимость от доступности сети добавляется в сервис автоматически.
Решение проблем
short-name did not resolve to an alias and no unqualified-search registries are defined
podman run --rm -d -p 7080:80 --name nginx nginx:alpine Error: short-name "nginx:alpine" did not resolve to an alias and no unqualified-search registries are defined in "/etc/containers/registries.conf"
Решение:
mkdir -p ~/.config/containers echo 'unqualified-search-registries = ["docker.io"]' >> ~/.config/containers/registries.conf # Системный конфиг: /etc/containers/registries.conf
unsupported key 'Pod' in group 'Container'
В Podman 4.9, который ставится в Ubuntu 24.04 LTS, параметр 'Pod' не поддерживается.
quadlet-generator[7320]: converting "wordpress-db.container": unsupported key 'Pod' in group 'Container' in /home/user/.config/containers/systemd/wordpress-db.container converting "wordpress.container": unsupported key 'Pod' in group 'Container' in /home/user/.config/containers/systemd/wordpress.container
Надо ставить Podman версии 5.
https://github.com/containers/podman/discussions/25582#discussioncomment-12803424
Литература
Используем функционал Podman вместо docker-compose на примере Gitea
Managing Containers in Podman with Systemd Unit Files
podman-compose
# Установка apt install podman-compose
Можно запускать как podman compose (через пробел), в таком случае это будет вызов обёртки над docker-compose или podman-compose. Если стоят оба, то приоритет у docker-compose, это можно настроить.
Для образов нужно указывать репозиторий. Здесь сеть web будет создана автоматически и контейнер попадёт в неё, т. к. сеть default.
- docker-compose.yml
services: nginx: image: docker.io/nginx:alpine ports: - "${WEB_PORT:-8084}:80" restart: unless-stopped networks: default: name: web
Что такое podman-compose (Selectel)
Docker Compose без Docker: rootless Podman и systemd на VDS
podman-compose doesn't survive a reboot (Github)
Загрузка контейнеров из compose старте системы
Если просто запустить podman compose up -d, то контейнеры не запустятся после рестарта хоста. Чтобы включить автозагрузку:
# Создать шаблон ~/.config/systemd/user/podman-compose@.service [Unit] Description=%i rootless pod (podman-compose) [Service] Type=simple EnvironmentFile=%h/.config/containers/compose/projects/%i.env ExecStartPre=-/usr/bin/podman-compose --in-pod pod_%i up --no-start ExecStartPre=/usr/bin/podman pod start pod_%i ExecStart=/usr/bin/podman-compose wait ExecStop=/usr/bin/podman pod stop pod_%i ExecStopPost=/usr/bin/podman pod rm pod_%i [Install] WantedBy=default.target
https://www.it-hure.de/2024/02/podman-compose-and-systemd/
Плохо то, что все контейнеры будут в одном поде и пробросить права на волюмы поконтейнерно не получится. Лучше уж нарисовать квадлет-файлы для каждого контейнера и прописать зависимости.
