containers.podman.podman_pod – Управление под-контейнерами Podman
Примечание
Этот плагин является частью коллекции containers.podman (версия 1.4.1).
Для его установки используйте: ansible-galaxy collection install containers.podman.
Для использования в playbook, укажите: containers.podman.podman_pod.
Новое в версии 1.0.0: плагина containers.podman
Обзор
- Управление под-контейнерами podman.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- podman
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| add_host список / элементы=строка | Добавить хост в файл /etc/hosts, который будет использоваться всеми контейнерами в под-контейнере. | |
| cgroup_parent строка | Путь к cgroup, в котором будет создан cgroup для под-контейнера. Если путь не абсолютный, он рассматривается как относительный к пути cgroup процесса init. Cgroup будут созданы, если они не существуют. | |
| debug булево |
| Возвратить дополнительную информацию, которая может быть полезна для расследования. |
| dns список / элементы=строка | Установить пользовательские DNS-серверы в файле /etc/resolv.conf, которые будут использоваться всеми контейнерами в под-контейнере. Разрешено специальное значение «none», которое отключает создание /etc/resolv.conf для под-контейнера. | |
| dns_opt список / элементы=строка | Установить пользовательские DNS-опции в файле /etc/resolv.conf, которые будут использоваться всеми контейнерами в под-контейнере. | |
| dns_search список / элементы=строка | Установить пользовательские DNS-домены поиска в файле /etc/resolv.conf, которые будут использоваться всеми контейнерами в под-контейнере. | |
| executable строка | По умолчанию: "podman" | Путь к исполняемому файлу podman, если он не находится в $PATH на машине, на которой выполняется podman |
| hostname строка | Установить имя хоста для под-контейнера | |
| infra булево |
| Создать контейнер infra и ассоциировать его с под-контейнером. Контейнер infra - это лёгкий контейнер, используемый для координации общего пространства имён ядра под-контейнера. Значение по умолчанию - истина. |
| infra_command строка | Команда, которая будет выполнена для запуска контейнера infra. Значение по умолчанию - "/pause". | |
| infra_conmon_pidfile строка | Записать PID процесса conmon контейнера infra в файл. Поскольку conmon выполняется в отдельном процессе от Podman, это необходимо при использовании systemd для управления контейнерами и под-контейнерами Podman. | |
| infra_image строка | Изображение, которое будет создано для контейнера infra. Значение по умолчанию - "k8s.gcr.io/pause:3.1". | |
| ip строка | Установить статический IP для общей сети под-контейнера. | |
| label словарь | Добавить метаданные в под-контейнер, передать словарь ключей и значений меток. | |
| label_file строка | Прочитать файл меток, разделенных по строкам. | |
| mac_address строка | Установить статический MAC-адрес для общей сети под-контейнера. | |
| name строка / обязательно | Назначить имя под-контейнеру. | |
| network строка | Установить режим сети для под-контейнера. Поддерживаемые значения: bridge (по умолчанию), host (не создавать пространство имён сети, все контейнеры в под-контейнере будут использовать сеть хоста) или список значений через запятую имён CNI-сетей, в которых должен быть подключён под-контейнер. | |
| no_hosts булево |
| Отключить создание /etc/hosts для под-контейнера. |
| pod_id_file строка | Записать идентификатор под-контейнера в файл. | |
| publish список / элементы=строка | Опубликовать порт или диапазон портов из под-контейнера на хост. псевдонимы: ports | |
| recreate булево |
| Используйте с состояниями present и started, чтобы принудительно пересоздать существующий под-контейнер. |
| share строка | Список пространств имён ядра через запятую, которые необходимо использовать совместно. Если указано none или "", то пространства имён не будут использоваться совместно. Доступные пространства имён: ipc, net, pid, user, uts. | |
| state строка |
| Эта переменная устанавливается для состояния |
Примеры
# What modules does for example
- podman_pod:
name: pod1
state: started
ports:
- 4444:5555
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| pod словарь | всегда | Результаты проверки под-контейнера для заданного под-контейнера. Пример: {'Config': {'cgroupParent': '/libpod_parent', 'created': '2020-06-14T15:16:12.230818767+03:00', 'hostname': 'newpod', 'id': 'a5a5c6cdf8c72272fc5c33f787e8d7501e2fa0c1e92b2b602860defdafeeec58', 'infraConfig': {'infraPortBindings': None, 'makeInfraContainer': True}, 'labels': {}, 'lockID': 515, 'name': 'newpod', 'sharesCgroup': True, 'sharesIpc': True, 'sharesNet': True, 'sharesUts': True}, 'Containers': [{'id': 'dc70a947c7ae15198ec38b3c817587584085dee3919cbeb9969e3ab77ba10fd2', 'state': 'configured'}], 'State': {'cgroupPath': '/libpod_parent/a5a5c6cdf8c72272fc5c33f787e8d7501e2fa0c1e92b2b602860defdafeeec58', 'infraContainerID': 'dc70a947c7ae15198ec38b3c817587584085dee3919cbeb9969e3ab77ba10fd2', 'status': 'Создан'}} |
Авторы
- Sagi Shnaidman (@sshnaidm)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/containers/podman/podman_pod_module.html
