igor_nikiforov.docker
Ansible 角色:Docker
该角色安装和配置 Docker,以及 Python 的 Compose 和 Docker SDK。
要求
该角色在以下 Ansible 版本下开发和测试:
名称 | 版本 |
---|---|
ansible | >= 2.9.13 |
ansible-base | >= 2.10.1 |
ansible-core | >= 2.11.2 |
其他 Ansible 版本未经过测试,但可能会正常工作。
安装
使用 ansible-galaxy install igor_nikiforov.docker
安装最新的稳定版本。
你也可以通过需求文件安装,使用 ansible-galaxy install -r requirements.yml
:
# requirements.yml
---
roles:
- name: igor_nikiforov.docker
version: v1.1.0
支持的操作系统
名称 | 版本 |
---|---|
Debian | buster |
Ubuntu | focal, groovy |
CentOS | 7.4+, 8 |
RedHat | 7.4+, 8 |
其他操作系统发行版未经过测试,但可能会正常工作。如有问题,请提交 PR!
变量
名称 | 描述 | 默认值 |
---|---|---|
docker_supported_architectures | 支持的 Docker 架构列表 | ["x86_64", "arm64", "armhf", "s390x"] |
docker_install | 如果为真,将安装 Docker | true |
docker_version | Docker 版本 | latest |
docker_bash_completion_install | 如果为真,将安装 Docker bash 完成 | true |
docker_daemon_config | Docker 守护进程配置 | {} |
docker_service_enabled | Docker 服务是否应该在启动时启动 | true |
docker_service_state | Docker 服务状态 | started |
docker_users | 要添加到 Docker 组的用户列表 | [] |
docker_sdk_for_python_install | 如果为真,将安装 Python 的 Docker SDK | false |
docker_sdk_for_python_version | Python 的 Docker SDK 版本 | latest |
docker_compose_install | 如果为真,将安装 Docker Compose | false |
docker_compose_version | Docker Compose 版本 | latest |
docker_compose_bash_completion_install | 如果为真,将安装 Docker Compose bash 完成 | true |
用法
该角色支持通过 docker_daemon_config
变量传递的所有 Docker 守护进程配置参数。您可以在 Docker 官方文档 中找到 JSON 配置格式的示例。要在角色中使用,您应将配置从 JSON 格式转换为 YAML 格式,例如使用 此在线工具。
示例
# playbook.yml
---
- hosts: all
become: True
gather_facts: False
pre_tasks:
- wait_for_connection: { timeout: 300 }
- setup:
vars:
docker_sdk_for_python_install: True
docker_compose_install: True
docker_daemon_config:
default-address-pools:
- { base: 172.16.0.0/16, size: 26 }
log-driver: "json-file"
log-opts:
max-size: "10m"
max-file: "3"
tasks:
- name: 安装 Docker
import_role:
name: docker
许可证
MIT