Spec-Zone.ru › Ansible

Подключение community.docker.docker – Запуск задач в контейнерах Docker

Примечание

Этот плагин подключения входит в коллекцию community.docker (версия 3.13.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.docker.

Чтобы использовать её в книге задач, укажите: community.docker.docker.

  • Обзор
  • Параметры

Обзор

  • Выполнение команд или копирование/получение файлов в существующий контейнер Docker.
  • Использует Docker CLI для выполнения команд в контейнере. Если вы предпочитаете напрямую подключиться к демону Docker, используйте плагин подключения community.docker.docker_api.

Параметры

Параметр

Комментарии

container_timeout

целое число

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

По умолчанию: 10

Настройка:

  • Записи INI:

    [defaults]
    timeout = 10
    
    [docker_connection]
    timeout = 10
    

    добавлен в community.docker 2.2.0

  • Переменная среды: ANSIBLE_TIMEOUT
  • Переменная среды: ANSIBLE_DOCKER_TIMEOUT

    добавлен в community.docker 2.2.0

  • Переменная: ansible_docker_timeout

    добавлен в community.docker 2.2.0

  • Аргумент командной строки: –timeout

docker_extra_args

строка

Дополнительные аргументы для передачи в командную строку docker.

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

Настройка:

  • Запись INI:

    [docker_connection]
    extra_cli_args = ""
    
  • Переменная: ansible_docker_extra_args

extra_env

словарь

добавлен в community.docker 3.12.0

Предоставляет дополнительные переменные среды для установки при выполнении команд в контейнере Docker.

В настоящее время этот параметр может быть предоставлен только как переменная Ansible из-за ограничений менеджера конфигураций ansible-core.

Настройка:

  • Переменная: ansible_docker_extra_env

privileged

логическое

добавлен в community.docker 3.12.0

Указывает, должны ли команды выполняться с расширенными привилегиями.

Примечание, что это может позволить команде потенциально выйти за пределы контейнера. Используйте с осторожностью!

Выбор:

  • false ← (по умолчанию)
  • true

Настройка:

  • Запись INI:

    [docker_connection]
    privileged = false
    
  • Переменная среды: ANSIBLE_DOCKER_PRIVILEGED
  • Переменная: ansible_docker_privileged

remote_addr

строка

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

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

Настройка:

  • Переменная: inventory_hostname
  • Переменная: ansible_host
  • Переменная: ansible_docker_host

remote_user

строка

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

Если Docker слишком старый для этого (< 1.7), будет использован установленный в Docker.

Настройка:

  • Запись INI:

    [defaults]
    remote_user = VALUE
    
  • Переменная среды: ANSIBLE_REMOTE_USER
  • Переменная: ansible_user
  • Переменная: ansible_docker_user
  • Ключевое слово: remote_user
  • Аргумент командной строки: –user

working_dir

строка

добавлен в community.docker 3.12.0

Директория внутри контейнера для запуска команд.

Требуется версия Docker CLI 18.06 или более поздняя.

Настройка:

  • Запись INI:

    [docker_connection]
    working_dir = VALUE
    
  • Переменная среды: ANSIBLE_DOCKER_WORKING_DIR
  • Переменная: ansible_docker_working_dir

Авторы

  • Lorin Hochestein
  • Leendert Brouwer

Подсказка

Записи конфигурации для каждого типа имеют порядок приоритета снизу вверх. Например, переменная, которая расположена ниже в списке, переопределит переменную, расположенную выше.

Ссылки на коллекцию

  • Отслеживание ошибок
  • Репозиторий (Исходный код)
  • Задайте вопрос (Docker)
  • Задайте вопрос (Docker Compose)
  • Задайте вопрос (Docker Swarm)
  • Отправить отчет об ошибке
  • Запросить функцию
  • Связь

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/docker/docker_connection.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API