podman_image – Выгрузка изображений для использования в podman

Новое в версии 2.8.

Описание
Параметры
Примеры
Возвращаемые значения
Статус

Описание

Создание, выгрузка или отправка изображений с помощью Podman.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auth_file -			Путь к файлу, содержащему учетные данные для аутентификации на удаленном репозитории псевдонимы: authfile
build -			Аргументы, управляющие созданием изображения. псевдонимы: build_args, buildargs
	annotation строка		Словарь пар ключ=значение для добавления в изображение. Работает только с OCI-изображениями. Игнорируется для контейнеров Docker.
	cache булево	Варианты: нет да ←	Использовать кэшированные слои при создании изображения?
	force_rm булево	Варианты: нет ← да	Всегда удалять промежуточные контейнеры после сборки, даже если сборка неуспешна.
	format -	Варианты: docker oci ←	Формат созданного изображения.
	rm булево	Варианты: нет да ←	Удалять промежуточные контейнеры после успешной сборки
ca_cert_dir путь			Путь к каталогу, содержащему сертификаты и ключи TLS
executable строка		Значение по умолчанию: "podman"	Путь к исполняемому файлу `podman`, если он не находится в `$PATH` на машине, на которой выполняется `podman`
force -			Принудительно выполнить отправку или загрузку изображения. При сборке — принудительно выполнить сборку, даже если изображение уже существует.
name - / обязательно			Имя изображения для загрузки, отправки или удаления. Может содержать тег в формате `image:tag`.
password строка			Пароль для аутентификации на удаленных репозиториях.
path -			Путь к каталогу, содержащему файл сборки.
pull -		Значение по умолчанию: "да"	Загрузить изображение?
push -		Значение по умолчанию: "нет"	Отправить изображение?
push_args -			Аргументы, управляющие отправкой изображений.
	compress булево	Варианты: нет да	Сжимать слои tarball-изображения при отправке в каталог с помощью транспорта 'dir'.
	dest -		Путь или URL, куда будет отправлено изображение.
	format -	Варианты: oci v2s1 v2s2	Тип манифеста для использования при отправке изображения с помощью транспорта 'dir' (по умолчанию используется тип манифеста источника).
	remove_signatures булево	Варианты: нет да	Удалить все существующие подписи в изображении
	sign_by -		Путь к файлу ключа, который будет использоваться для подписи изображения.
	transport -	Варианты: dir docker-archive docker-daemon oci-archive ostree	Использовать транспорт для отправки изображения. Если транспорт не указан, попытается отправить на удалённый репозиторий.
state -		Варианты: present ← absent build	Изображение должно быть доступным, отсутствовать или создаваться.
tag -		Значение по умолчанию: "latest"	Тег изображения для загрузки, отправки или удаления.
username строка			Имя пользователя для аутентификации на удалённых репозиториях.
validate_certs -		Значение по умолчанию: "да"	Требовать HTTPS и проверять сертификаты при загрузке или отправке. Также используется во время сборки, если требуется загрузка или отправка. псевдонимы: tlsverify, tls_verify

Примеры

- name: Pull an image
  podman_image:
    name: quay.io/bitnami/wildfly

- name: Remove an image
  podman_image:
    name: quay.io/bitnami/wildfly
    state: absent

- name: Pull a specific version of an image
  podman_image:
    name: redis
    tag: 4

- name: Build a basic OCI image
  podman_image:
    name: nginx
    path: /path/to/build/dir

- name: Build a basic OCI image with advanced parameters
  podman_image:
    name: nginx
    path: /path/to/build/dir
    build:
      cache: no
      force_rm: yes
      format: oci
      annotation:
        app: nginx
        function: proxy
        info: Load balancer for my cool app

- name: Build a Docker formatted image
  podman_image:
    name: nginx
    path: /path/to/build/dir
    build:
      format: docker

- name: Build and push an image using existing credentials
  podman_image:
    name: nginx
    path: /path/to/build/dir
    push: yes
    push_args:
      dest: quay.io/acme

- name: Build and push an image using an auth file
  podman_image:
    name: nginx
    push: yes
    auth_file: /etc/containers/auth.json
    push_args:
      dest: quay.io/acme

- name: Build and push an image using username and password
  podman_image:
    name: nginx
    push: yes
    username: bugs
    password: "{{ vault_registry_password }}"
    push_args:
      dest: quay.io/acme

- name: Build and push an image to multiple registries
  podman_image:
    name: "{{ item }}"
    path: /path/to/build/dir
    push: yes
    auth_file: /etc/containers/auth.json
    loop:
    - quay.io/acme/nginx
    - docker.io/acme/nginx

- name: Build and push an image to multiple registries with separate parameters
  podman_image:
    name: "{{ item.name }}"
    tag: "{{ item.tag }}"
    path: /path/to/build/dir
    push: yes
    auth_file: /etc/containers/auth.json
    push_args:
      dest: "{{ item.dest }}"
    loop:
    - name: nginx
      tag: 4
      dest: docker.io/acme

    - name: nginx
      tag: 3
      dest: docker.io/acme

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
image словарь	успех	Результаты проверки изображения для изображения, которое было извлечено, загружено или построено. Пример: [{'Annotations': {}, 'Архитектура': 'amd64', 'Автор': '', 'Комментарий': 'от Bitnami с любовью', 'Конфигурация контейнера': {'Команды': ['/run.sh'], 'Точка входа': ['/app-entrypoint.sh'], 'Переменные среды': ['PATH=/opt/bitnami/java/bin:/opt/bitnami/wildfly/bin:/opt/bitnami/nami/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin', 'IMAGE_OS=debian-9', 'NAMI_VERSION=1.0.0-1', 'GPG_KEY_SERVERS_LIST=ha.pool.sks-keyservers.net', 'TINI_VERSION=v0.13.2', 'TINI_GPG_KEY=595E85A6B1B4779EA4DAAEC70B588DFF0527A9B7', 'GOSU_VERSION=1.10', 'GOSU_GPG_KEY=B42F6819007F00F88E364FD4036A9C25BF357DD4', 'BITNAMI_IMAGE_VERSION=16.0.0-debian-9-r27', 'BITNAMI_PKG_CHMOD=-R g+rwX', 'BITNAMI_PKG_EXTRA_DIRS=/home/wildfly', 'HOME=/home/wildfly', 'BITNAMI_APP_NAME=wildfly', 'NAMI_PREFIX=/.nami', 'WILDFLY_HOME=/home/wildfly', 'WILDFLY_JAVA_HOME=', 'WILDFLY_JAVA_OPTS=', 'WILDFLY_MANAGEMENT_HTTP_PORT_NUMBER=9990', 'WILDFLY_PASSWORD=bitnami', 'WILDFLY_PUBLIC_CONSOLE=true', 'WILDFLY_SERVER_AJP_PORT_NUMBER=8009', 'WILDFLY_SERVER_HTTP_PORT_NUMBER=8080', 'WILDFLY_SERVER_INTERFACE=0.0.0.0', 'WILDFLY_USERNAME=user', 'WILDFLY_WILDFLY_HOME=/home/wildfly', 'WILDFLY_WILDFLY_OPTS=-Dwildfly.as.deployment.ondemand=false'], 'Экспонированные порты': {'8080/tcp': {}, '9990/tcp': {}}, 'Метки': {'maintainer': 'Bitnami <containers@bitnami.com>'}, 'Пользователь': '1001'}, 'Создано': '2019-04-10T05:48:03.553887623Z', 'Хэш': 'sha256:5a8ab28e314c2222de3feaf6dac94a0436a37fc08979d2722c99d2bef2619a9b', 'Драйвер графа': {'Данные': {'Директория ниже': '/var/lib/containers/storage/overlay/142c1beadf1bb09fbd929465ec98c9dca3256638220450efb4214727d0d0680e/diff:/var/lib/containers/s', 'Объединенная директория': '/var/lib/containers/storage/overlay/9aa10191f5bddb59e28508e721fdeb43505e5b395845fa99723ed787878dbfea/merged', 'Директория выше': '/var/lib/containers/storage/overlay/9aa10191f5bddb59e28508e721fdeb43505e5b395845fa99723ed787878dbfea/diff', 'Рабочая директория': '/var/lib/containers/storage/overlay/9aa10191f5bddb59e28508e721fdeb43505e5b395845fa99723ed787878dbfea/work'}, 'Имя': 'overlay'}, 'История': [{'комментарий': 'от Bitnami с любовью', 'создано': '2019-04-09T22:27:40.659377677Z'}, {'создано': '2019-04-09T22:38:53.86336555Z', 'создано_пользователем': '/bin/sh -c #(nop) LABEL maintainer=Bitnami <containers@bitnami.com>', 'пустой_слой': True}, {'создано': '2019-04-09T22:38:54.022778765Z', 'создано_пользователем': '/bin/sh -c #(nop) ENV IMAGE_OS=debian-9', 'пустой_слой': True}], 'Идентификатор': 'ace34da54e4af2145e1ad277005adb235a214e4dfe1114c2db9ab460b840f785', 'Метки': {'maintainer': 'Bitnami <containers@bitnami.com>'}, 'Тип манифеста': 'application/vnd.docker.distribution.manifest.v1+prettyjws', 'Операционная система': 'linux', 'Родитель': '', 'Хэши репозитория': ['quay.io/bitnami/wildfly@sha256:5a8ab28e314c2222de3feaf6dac94a0436a37fc08979d2722c99d2bef2619a9b'], 'Теги репозитория': ['quay.io/bitnami/wildfly:latest'], 'Корневая файловая система': {'Слои': ['', '', '', '', '', '', '', '', '', '', '', ''], 'Тип': 'слои'}, 'Размер': 466180019, 'Пользователь': '1001', 'Версия': '18.09.3', 'Виртуальный размер': 466180019}]

Статус

Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
Данный модуль поддерживается сообществом Ansible. [community]

Авторы

Sam Doran (@samdoran)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/podman_image_module.html