avinetworks.docker
avinetworks.docker
角色摘要
这个角色提供以下功能:
- 根据 Docker 记录的 Docker-Engine 安装程序安装 Docker。
- 它还会管理内核版本,确保安装了支持 Docker 的正确内核。
支持的操作系统:
- CentOS 7
- RedHat 7
- Fedora 24
- Fedora 23
- Fedora 26
- Fedora 27
- Fedora 29
- OracleLinux 7
- Ubuntu 14.04
- Ubuntu 16.04
要求
这个角色需要 Ansible 2.4 或更高版本。要求在元数据文件中列出。
如果您在使用此角色时依赖特权提升(例如 become: true
),您需要 Ansible 2.2.1 或更高版本,以便利用修复此问题: https://github.com/ansible/ansible/issues/17490
角色变量
有关变量的更多信息,可参阅 https://docs.docker.com/engine/reference/commandline/dockerd/
变量 | 必需 | 默认值 | 备注 |
---|---|---|---|
docker_edition |
否 | ce |
指定 Docker 的 ce 或 ee 版本。 |
docker_ee_url |
否 | 未定义 |
Docker Store 的 Docker EE URL |
docker_repo |
否 | docker |
定义 Ansible 如何管理存储库。选项为 "other" 和 "docker" |
docker_channel |
否 | stable |
要安装的 Docker 发布频道。 |
docker_ee_version |
否 | 17.03 |
EE 存储库的 Docker EE 版本 |
docker_storage_driver |
否 | 未定义 |
要使用的存储驱动程序 |
docker_block_device |
否 | 未定义 |
用于存储驱动程序的设备名称。 |
docker_mount_opts |
否 | 未定义 |
挂载文件系统时的挂载选项 |
docker_storage_opts |
否 | 未定义 |
存储驱动程序选项 |
docker_api_cors_header |
否 | 未定义 |
在远程 API 中设置 CORS 头 |
docker_authorization_plugins |
否 | 未定义 |
要加载的授权插件 |
docker_bip |
否 | 未定义 |
指定网络桥接 IP |
docker_bridge |
否 | 未定义 |
将容器附加到网络桥 |
docker_cgroup_parent |
否 | 未定义 |
为所有容器设置父 cgroup |
docker_cluster_store |
否 | 未定义 |
设置集群存储选项 |
docker_cluster_store_opts |
否 | 未定义 |
有关信息,请参见 dockerd 手册 |
docker_cluster_advertise |
否 | 未定义 |
要广告的地址或接口名称 |
docker_debug |
否 | 未定义 |
启用调试模式 |
docker_default_gateway |
否 | 未定义 |
容器默认网关 IPv4 地址 |
docker_default_gateway_v6 |
否 | 未定义 |
容器默认网关 IPv6 地址 |
docker_default_runtime |
否 | 未定义 |
容器的默认 OCI 运行时 |
docker_default_ulimits |
否 | 未定义 |
容器的默认 ulimits |
docker_disable_legacy_registry |
否 | 未定义 |
禁用与旧注册表的联系 |
docker_dns |
否 | 未定义 |
要使用的 DNS 服务器 |
docker_dns_opts |
否 | 未定义 |
要使用的 DNS 选项 |
docker_dns_search |
否 | 未定义 |
要使用的 DNS 搜索域 |
docker_exec_opts |
否 | 未定义 |
运行时执行选项 |
docker_exec_root |
否 | 未定义 |
执行状态文件的根目录 |
docker_fixed_cidr |
否 | 未定义 |
固定 IP 的 IPv4 子网 |
docker_fixed_cidr_v6 |
否 | 未定义 |
固定 IP 的 IPv6 子网 |
docker_graph |
否 | 未定义 |
Docker 运行时的根 |
docker_group |
否 | 未定义 |
Unix 套接字的组 |
docker_hosts |
否 | 未定义 |
要连接的守护进程套接字 |
docker_icc |
否 | 未定义 |
启用容器间通信 |
docker_insecure_registries |
否 | 未定义 |
启用不安全的注册表通信 |
docker_ip |
否 | 未定义 |
绑定容器端口时的默认 IP |
docker_iptables |
否 | 未定义 |
启用添加 iptables 规则 |
docker_ipv6 |
否 | 未定义 |
启用 IPv6 网络 |
docker_ip_forward |
否 | 未定义 |
启用 net.ipv4.ip_forward |
docker_ip_masq |
否 | 未定义 |
启用 IP 伪装 |
docker_labels |
否 | 未定义 |
设置键=值标签到守护进程 |
docker_live_restore |
否 | 未定义 |
在守护进程停机期间保持容器存活 |
docker_log_driver |
否 | 未定义 |
容器日志的默认驱动程序 |
docker_log_level |
否 | 未定义 |
设置日志级别 |
docker_log_opts |
否 | 未定义 |
容器的默认日志驱动程序选项 |
docker_max_concurrent_downloads |
否 | 未定义 |
设置每次拉取的最大并发下载数量 |
docker_max_concurrent_uploads |
否 | 未定义 |
设置每次推送的最大并发上传数量 |
docker_mtu |
否 | 未定义 |
设置容器网络的 MTU |
docker_oom_score_adjust |
否 | 未定义 |
为守护进程设置 oom_score_adj |
docker_pidfile |
否 | 未定义 |
用于守护进程 PID 文件的路径 |
docker_raw_logs |
否 | 未定义 |
无 ANSI 颜色的完整时间戳 |
docker_registry_mirrors |
否 | 未定义 |
首选 Docker 注册表镜像 |
docker_runtimes |
否 | 未定义 |
注册其他兼容 OCI 的运行时 |
docker_selinux_enabled |
否 | 未定义 |
启用 selinux 支持 |
docker_swarm_default_advertise_addr |
否 | 未定义 |
设置 swarm 广告地址的默认地址或接口 |
docker_tls |
否 | 未定义 |
使用 TLS;由 –tlsverify 隐含 |
docker_tlscacert |
否 | 未定义 |
信任仅由此 CA 签名的证书 |
docker_tlscert |
否 | 未定义 |
TLS 证书文件的路径 |
docker_tlskey |
否 | 未定义 |
TLS 密钥文件的路径 |
docker_tlsverify |
否 | 未定义 |
使用 TLS 并验证远程 |
docker_userland_proxy |
否 | 未定义 |
对于回环流量使用用户空间代理 |
docker_userns_remap |
否 | 未定义 |
用户命名空间的用户/组设置 |
docker_users |
否 | 未定义 |
要添加到 Docker 组的系统用户列表(以便他们可以在服务器上使用 Docker) |
docker_http_proxy |
否 | 未定义 |
设置 Docker 服务使用 HTTP_PROXY |
docker_https_proxy |
否 | 未定义 |
设置 Docker 服务使用 HTTPS_PROXY |
docker_no_proxy_params |
否 | 未定义 |
Docker 服务参数不使用代理 |
示例剧本
将 Docker 安装到主机上,使用基本默认设置。此操作不会安装 devicemapper,也不会将服务器配置为生产环境。只是简单地安装 Docker 并使其运行。与 apt install docker-ce
或 yum install docker-ce
进行比较。
- hosts: servers
roles:
- role: avinetworks.docker
使用 devicemapper 安装 Docker。请注意,这将创建一个新的 LVM 在 /dev/sda3 上,请不要使用已经在使用的块设备。这是在 RHEL/CentOS/Fedora 系统上的推荐生产部署。
- hosts: servers
roles:
- role: avinetworks.docker
docker_storage_driver: devicemapper
docker_block_device: /dev/sda3
使用 AUFS 安装 Docker。这是推荐的在 Ubuntu 系统上的生产部署。
- hosts: servers
roles:
- role: avinetworks.docker
docker_storage_driver: aufs
有关更多示例,请查看 examples/ 文件夹。
许可证
Apache 2.0