install_docker

Этот репозиторий является только зеркалом. Разработка и тестирование проводятся на частном сервере gitea.

Эта роль устанавливает и настраивает docker на дистрибутивах, основанных на debian.

Требования

Нет.

Переменные роли

Доступные переменные перечислены ниже вместе с значениями по умолчанию. Пример файла со значениями по умолчанию доступен в default/install_docker.yml.sample, если вам это нужно для настройки group_vars или host_vars.

install_docker_edition: ce # по умолчанию установлено на ce

Эта переменная задает редакцию docker для установки. Это может быть либо ce (сообщество), либо ee (корпоративная версия).

install_docker_auto_update: false # по умолчанию установлено на false

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

install_docker_start_service: true

Эта переменная определяет, нужно ли запускать сервис docker после его установки. Это можно отключить, если вы создаете «золотые» образы, чтобы ваш золотой образ не запускал сервис docker в ходе его сборки.

install_docker_compose: false # по умолчанию установлено на false

Эта переменная определяет, нужно ли устанавливать docker-compose на хост.

install_docker_compose_version: latest # по умолчанию установлено на latest

Эта переменная задает версию docker-compose для установки. Она поддерживает либо latest, либо номер версии (vX.Y.Z). Официально поддерживаются только версии >=v2.0.1, так как наименования для большинства пакетов изменились с этой версии.

install_docker_python_packages: false # по умолчанию установлено на false

Эта переменная определяет, нужно ли устанавливать python пакеты для управления docker с помощью ansible. Этот пакет необходим, если вы планируете выполнять операции с docker с помощью ansible, и его следует установить, если это ваша цель.

install_docker_python_packages_version: latest # по умолчанию установлено на latest

Эта переменная задает версию python пакета docker, который должен быть установлен. Смотрите документацию по ednz_cloud/manage_pip_packages.

install_docker_users: [] #по умолчанию установлено на []

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

install_docker_daemon_options: {} # по умолчанию установлено на {}

Эта переменная определяет параметры, которые нужно добавить в файл daemon.json (в /etc/docker/daemon.json). Для получения более подробной информации обратитесь к документации.

Зависимости

ednz_cloud.manage_pip_packages для установки python пакетов docker для использования модулей community.docker. ednz_cloud.manage_repositories для настройки apt репозитория docker. ednz_cloud.manage_apt_packages для установки docker.

Пример плейбука

Хорошо, если пользователи смогут увидеть пример использования вашей роли (например, с переменными, переданными в качестве параметров):

# вызов роли внутри плейбука с использованием значений по умолчанию или group_vars/host_vars
- hosts: servers
  roles:
    - ednz_cloud.install_docker