containers.podman.podman_pod – Управление поддоманными под
Примечание
Этот плагин является частью коллекции containers.podman (версия 1.4.1).
Для его установки используйте: ansible-galaxy collection install containers.podman.
Для использования в playbook укажите: containers.podman.podman_pod.
Новое в версии 1.0.0: из containers.podman
Описание
- Управление поддоманными под.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- podman
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| add_host список / элементы=строка | Добавить хост в файл /etc/hosts, который будет общим для всех контейнеров в под. | |
| cgroup_parent строка | Путь к cgroup, в котором будет создан cgroup для под. Если путь не абсолютный, он рассматривается как относительный к пути cgroup процесса init. Cgroups будут созданы, если они еще не существуют. | |
| 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 — это лёгкий контейнер, используемый для координации общего пространства имен ядра под. По умолчанию значение — true. |
| 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 список / элементы=строка | Опубликовать порт или диапазон портов из под на хост. псевдонимы: порты | |
| 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', 'создан': '2020-06-14T15:16:12.230818767+03:00', 'имя_хоста': 'newpod', 'id': 'a5a5c6cdf8c72272fc5c33f787e8d7501e2fa0c1e92b2b602860defdafeeec58', 'infraConfig': {'infraPortBindings': None, 'создатьInfraContainer': True}, 'метки': {}, 'lockID': 515, 'имя': 'newpod', 'разделяетCgroup': True, 'разделяетIpc': True, 'разделяетNet': True, 'разделяетUts': True}, 'Контейнеры': [{'id': 'dc70a947c7ae15198ec38b3c817587584085dee3919cbeb9969e3ab77ba10fd2', 'состояние': 'настроен'}], 'Состояние': {'cgroupPath': '/libpod_parent/a5a5c6cdf8c72272fc5c33f787e8d7501e2fa0c1e92b2b602860defdafeeec58', 'idКонтейнераInfra': 'dc70a947c7ae15198ec38b3c817587584085dee3919cbeb9969e3ab77ba10fd2', 'статус': 'Создан'}} |
Авторы
- Sagi Shnaidman (@sshnaidm)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/containers/podman/podman_pod_module.html
