Подключение community.docker.docker — выполнение задач в контейнерах Docker
Примечание
Этот плагин подключения входит в коллекцию community.docker (версия 5.2.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 integer | Определяет, как долго можно ожидать доступа к выводу контейнера для чтения после начала выполнения. По умолчанию: Конфигурация:
|
docker_extra_args string | Дополнительные аргументы, передаваемые командной строке Docker. По умолчанию: Конфигурация:
|
extra_env dictionary добавлено в community.docker 3.12.0 | Дополнительные переменные окружения, устанавливаемые при выполнении команд в контейнере Docker. Из-за ограничений менеджера конфигурации ansible-core в настоящее время этот параметр можно задать только с помощью переменных Ansible. Конфигурация:
|
privileged boolean добавлено в community.docker 3.12.0 | Следует ли выполнять команды с расширенными привилегиями. Примечание: это может позволить команде выйти за пределы контейнера. Используйте с осторожностью! Варианты:
Конфигурация:
|
remote_addr string | Имя контейнера, к которому требуется получить доступ. По умолчанию: Конфигурация:
|
remote_user string | Пользователь, от имени которого будут выполняться команды внутри контейнера. Если версия Docker слишком старая и не поддерживает эту возможность (< 1.7), будет использоваться пользователь, заданный самим Docker. Конфигурация:
|
working_dir string добавлено в community.docker 3.12.0 | Каталог внутри контейнера, в котором будут выполняться команды. Требуется Docker CLI версии 18.06 или новее. Конфигурация:
|
Примечание
Записи конфигурации, перечисленные выше для каждого типа записей (переменная Ansible, переменная окружения и т. д.), упорядочены от низкого к высокому приоритету. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше. Типы записей также упорядочены по возрастанию приоритета. Например, запись в ansible.cfg (расположенная выше в списке) переопределяется переменной Ansible (расположенной ниже в списке).
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/docker/docker_connection.html