community.general.docker_image – Управление образами Docker.

• Обзор
• Требования
• Параметры
• Примечания
• Примеры
• Возвращаемые значения

Обзор

• Создайте, загрузите или получите образ, сделав его доступным для создания контейнеров. Также поддерживает маркирование образа в репозитории и архивирование образа в файл .tar.
• Начиная с Ansible 2.8, рекомендуется явно указать источник образа (source может быть build, load, pull или local). Это станет обязательным начиная с community.general 2.0.0.

Требования

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

• API Docker >= 1.20
• Docker SDK для Python: Обратите внимание, что модуль Python docker-py был заменен на docker (подробности см. в здесь). Для Python 2.6 необходимо использовать docker-py. В противном случае рекомендуется установить модуль Python docker. Обратите внимание, что оба модуля не должны быть установлены одновременно. Также обратите внимание, что при установке и удалении одного из модулей, другой может перестать работать, и потребуется его переустановка.
• Docker SDK для Python >= 1.8.0 (используйте docker-py для Python 2.6)

Параметры

Примечания

Примеры

- name: Pull an image
  community.general.docker_image:
    name: pacur/centos-7
    source: pull

- name: Tag and push to docker hub
  community.general.docker_image:
    name: pacur/centos-7:56
    repository: dcoppenhagan/myimage:7.56
    push: yes
    source: local

- name: Tag and push to local registry
  community.general.docker_image:
    # Image will be centos:7
    name: centos
    # Will be pushed to localhost:5000/centos:7
    repository: localhost:5000/centos
    tag: 7
    push: yes
    source: local

- name: Add tag latest to image
  community.general.docker_image:
    name: myimage:7.1.2
    repository: myimage:latest
    # As 'latest' usually already is present, we need to enable overwriting of existing tags:
    force_tag: yes
    source: local

- name: Remove image
  community.general.docker_image:
    state: absent
    name: registry.ansible.com/chouseknecht/sinatra
    tag: v1

- name: Build an image and push it to a private repo
  community.general.docker_image:
    build:
      path: ./sinatra
    name: registry.ansible.com/chouseknecht/sinatra
    tag: v1
    push: yes
    source: build

- name: Archive image
  community.general.docker_image:
    name: registry.ansible.com/chouseknecht/sinatra
    tag: v1
    archive_path: my_sinatra.tar
    source: local

- name: Load image from archive and push to a private registry
  community.general.docker_image:
    name: localhost:5000/myimages/sinatra
    tag: v1
    push: yes
    load_path: my_sinatra.tar
    source: load

- name: Build image and with build args
  community.general.docker_image:
    name: myimage
    build:
      path: /path/to/build/dir
      args:
        log_volume: /var/log/myapp
        listen_port: 8080
    source: build

- name: Build image using cache source
  community.general.docker_image:
    name: myimage:latest
    build:
      path: /path/to/build/dir
      # Use as cache source for building myimage
      cache_from:
        - nginx:latest
        - alpine:3.8
    source: build

Значения возврата

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

Авторы

• Павел Антонов (@softzilla)
• Крис Хаусенект (@chouseknecht)
• Сорин Сбарнеа (@ssbarnea)