Инструменты пользователя

Инструменты сайта


service:podman

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://man.archlinux.org/man/containers-registries.conf.5

Сеть

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).

Understanding rootless Podman's user namespace modes

Нет дополнительного 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-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/

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

service/podman.txt · Последнее изменение: — viacheslav

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki