Podman: различия между версиями

Материал из ALT Linux Wiki
(Упрощение инструкции и визуальные улучшения)
(→‎Rootless режим: overlay fs (fuse) section added)
Строка 17: Строка 17:
#:<syntaxhighlight lang="console"># setcap cap_setuid+ep /usr/bin/newuidmap
#:<syntaxhighlight lang="console"># setcap cap_setuid+ep /usr/bin/newuidmap
# setcap cap_setgid+ep /usr/bin/newgidmap</syntaxhighlight>
# setcap cap_setgid+ep /usr/bin/newgidmap</syntaxhighlight>
Если при попытке работы с podman под непривилегированным пользователем выдаётся ошибка "Error: kernel does not support overlay fs: 'overlay' is not supported ...", то нужно настроить fuse:
# Под пользователем root:
#:<syntaxhighlight lang="console"># apt-get install fuse-overlayfs
# control fusermount fuseonly
# usermod -aG fuse <your_unprivileged_user_here></syntaxhighlight>
# Под непривилегированным пользователем, для проверки:
#:<syntaxhighlight lang="console">$ fusermount -V
fusermount version: 2.9.9
$ fusermount3 -V
fusermount3 version: 3.16.2</syntaxhighlight>


Этих действий достаточно для запуска podman непривилегированными пользователями.
Этих действий достаточно для запуска podman непривилегированными пользователями.

Версия от 19:43, 10 января 2025

Инструкция по установке

Установка

Установить podman можно следующей командой:

# apt-get install podman

Rootless режим

Для использования podman непривилегированными пользователями, необходимо произвести ряд дополнительных действий по настройке прав:

  1. Проверить наличие разрешения на создание пользовательских пространств имён:
    # sysctl kernel.unprivileged_userns_clone
    
  2. Если отсутствует, то разрешаем (устанавливаем пакет с необходимой конфигурацией)
    # apt-get install sysctl-conf-userns
    
  3. Предоставить права на запуск исполняемых файлов /usr/bin/newuidmap и /usr/bin/newgidmap пользователям, не являющимся владельцами файла и не принадлежащим к группе владельца файла:
    # control newgidmap public
    # control newuidmap public
    
  4. Поскольку эти исполняемые файлы обращаются к системным вызовам setuid() и setgid(), чтобы лишний раз не выдавать SUID бит, задайте этим файлам соответствующие file capabilities:
    # setcap cap_setuid+ep /usr/bin/newuidmap
    # setcap cap_setgid+ep /usr/bin/newgidmap
    

Если при попытке работы с podman под непривилегированным пользователем выдаётся ошибка "Error: kernel does not support overlay fs: 'overlay' is not supported ...", то нужно настроить fuse:

  1. Под пользователем root:
    # apt-get install fuse-overlayfs
    # control fusermount fuseonly
    # usermod -aG fuse <your_unprivileged_user_here>
    
  2. Под непривилегированным пользователем, для проверки:
    $ fusermount -V
    fusermount version: 2.9.9
    $ fusermount3 -V
    fusermount3 version: 3.16.2
    

Этих действий достаточно для запуска podman непривилегированными пользователями.

Примечание:

Чтобы podman могли запускать непривилегированные пользователи, для каждого такого пользователя должна существовать запись конфигурации subuid и subgid. Новые пользователи, созданные после установки podman, имеют эти записи по умолчанию.

Для пользователей, у которых нет записей в /etc/subuid и /etc/subgid, можно создать запись с помощью команды usermod, например:

# usermod --add-subuids 100000-165535 --add-subgids 100000-165535 имя_пользователя

Данная команда выделяет заданный диапазон UID и GID пользователю, что позволит пользователю и группе с именем пользователя запускать контейнеры Podman.

В случае попытки добавить доменного пользователя, имя пользователя вносится в /etc/subuid и /etc/subgid вручную.

Указанный выше диапазон UID и GID уже может быть занят другим пользователем, т.к. это диапазон по умолчанию для первого пользователя. Просмотреть занятые диапазоны можно в файлах /etc/subuid и /etc/subgid, например:

# cat /etc/subuid 
user:100000:65536
user2:165536:65536

Многим образам требуется 65536 uid/gid для сопоставления. Рекомендуется выделять как минимум столько uid/gid для каждого пользователя.

Для применения изменений в subuid и subgid необходимо выполнить команду:

$ podman system migrate


Запуск образов

Podman предоставляет совместимый с Docker интерфейс CLI, а следовательно допустимо настроить при необходимости alias docker=podman:

# echo "alias docker=podman" >> ~/.bashrc

Загрузка образа из репозитория:

# podman pull registry.altlinux.org/alt/alt

Запуск контейнера из образа:

# podman run -it --name alt registry.altlinux.org/alt/alt

Ссылки

Документация
Настройка rootless в Podman
Репозиторий образов ALT