Модуль containers.podman.podman_quadlet_build — сборка образов для использования в Podman Quadlets

annotation

dictionary

Словарь пар «ключ=значение», добавляемых к образу. Работает только с образами OCI. Игнорируется для контейнеров Docker.

arch

string

Архитектура ЦП для образа контейнера

authfile

псевдонимы: auth_file

path

Путь к файлу с учётными данными для авторизации в удалённом реестре.

build_args

псевдонимы: buildargs

dictionary

Словарь пар «ключ=значение», добавляемых в качестве аргументов сборки.

ca_cert_dir

path

Путь к каталогу с используемыми сертификатами и ключами TLS.

cache

boolean

Использовать ли кэшированные слои при сборке образа

Варианты:

• false
• true

cmd_args

list / элементы=string

Дополнительные глобальные аргументы, передаваемые команде podman (например, --log-level=debug).

Они указываются после исполняемого файла и перед подкомандой.

dns

list / элементы=string

Задать пользовательские DNS-серверы в файле /etc/resolv.conf, который будет общим для всех контейнеров в поде. Допускается специальное значение «none», отключающее создание /etc/resolv.conf для пода.

dns_opt

псевдонимы: dns_option

list / элементы=string

Задать пользовательские параметры DNS в файле /etc/resolv.conf, который будет общим для всех контейнеров в поде.

dns_search

list / элементы=string

Задать пользовательские домены поиска DNS в файле /etc/resolv.conf, который будет общим для всех контейнеров в поде.

env

dictionary

Словарь пар «ключ=значение», добавляемых в качестве переменных среды.

executable

string

Путь к исполняемому файлу podman, если он отсутствует в $PATH на машине, где выполняется podman.

По умолчанию: "podman"

file

path

Путь к Containerfile, если он находится не в каталоге контекста сборки.

force_rm

boolean

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

Варианты:

• false
• true

group_add

псевдонимы: groups

list / элементы=string

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

ignore_file

псевдонимы: ignorefile

path

Путь к альтернативному файлу .containerignore, используемому при сборке образа.

labels

dictionary

Метки, назначаемые образу.

name

string / обязательный

Имя собираемого образа. Может содержать тег в формате image:tag.

network

псевдонимы: net, network_mode

list / элементы=string

Список имён сетей CNI, к которым должна подключаться сборка во время выполнения инструкций RUN.

password

string

Пароль для аутентификации в удалённых реестрах.

pull

string

Политика получения образа. Значение по умолчанию — «missing».

Варианты:

• "missing"
• "always"
• "never"
• "newer"

quadlet_dir

path

Путь к каталогу для записи файла quadlet. По умолчанию для пользователя root используется /etc/containers/systemd/, для пользователей без прав root — ~/.config/containers/systemd/.

quadlet_file_mode

any

Права доступа к файлу quadlet.

Значение quadlet_file_mode можно указать в виде восьмеричного числа или символьного режима (например, u+rwx или u=rw,g=r,o=r). Для восьмеричного формата необходимо либо добавить ведущий ноль, чтобы парсер YAML в Ansible распознал восьмеричное число (например, 0644 или 01777), либо заключить значение в кавычки (например, '644' или '1777'), чтобы Ansible получил строку и самостоятельно преобразовал её в число. Если передать Ansible число, не соблюдая ни одно из этих правил, оно будет воспринято как десятичное, что приведёт к неожиданным результатам.

Если quadlet_file_mode не задан и файл quadlet не существует, при установке режима для создаваемого файла будет использоваться маска по умолчанию '0640'.

Если quadlet_file_mode не задан и файл quadlet существует, будет использоваться режим существующего файла.

Указание quadlet_file_mode — лучший способ обеспечить создание файлов с правильными правами доступа.

quadlet_filename

string

Имя записываемого файла quadlet. По умолчанию используется имя образа без префиксов и тегов.

quadlet_options

list / элементы=string

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

retry

integer

Количество повторных попыток получения или отправки образов между реестром и локальным хранилищем в случае ошибки. Значение по умолчанию — 3.

retry_delay

псевдонимы: retrydelay

string

Продолжительность задержки между повторными попытками получения или отправки образов между реестром и локальным хранилищем в случае ошибки.

secret

list / элементы=string

Безопасная передача секретных данных, используемых на этапах сборки Containerfile. Обычно имеет вид secret[,opt=opt ...]. Можно указать несколько раз.

set_working_directory

псевдонимы: setworkingdirectory

string

Задать контекст (рабочий каталог) для podman build.

target

string

Указать целевой этап сборки.

username

string

Имя пользователя для аутентификации в удалённых реестрах.

validate_certs

псевдонимы: tlsverify, tls_verify

boolean

Требовать HTTPS и проверять сертификаты при получении или отправке образов. Также используется во время сборки, если требуется получение или отправка.

Варианты:

• false
• true

variant

string

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

volume

list / элементы=string

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

changed

boolean

Были ли внесены изменения

Возвращается: всегда