参数列表

Docker 模块提供了 8 个相关配置参数

参数列表

Docker 模块有 8 个相关参数,如下表所示:

参数 类型 级别 注释
docker_enabled bool G/C/I 在当前节点上启用 Docker?默认不启用
docker_data path G/C/I Docker 主数据目录,默认为 /var/lib/docker
docker_storage_driver enum G/C/I Docker 存储驱动驱动,默认为 overlay2
docker_cgroups_driver enum G/C/I Docker CGroup 文件系统驱动:cgroupfs,systemd
docker_registry_mirrors string[] G/C/I Docker 仓库镜像列表
docker_exporter_port port G Docker 监控指标暴露端口,默认为 9323
docker_image string[] G/C/I Docker 待拉取的镜像列表,默认为空列表
docker_image_cache path[] G/C/I Docker 待导入的镜像压缩包路径,默认为 /tmp/docker/*.tgz

默认参数

Docker 模块的默认参数定义于 roles/docker/defaults/main.yml

docker_enabled: false # enable docker on this node? docker_data: /var/lib/docker # docker data directory, /var/lib/docker by default docker_storage_driver: overlay2 # docker storage driver, can be zfs, btrfs docker_cgroups_driver: systemd # docker cgroup fs driver: cgroupfs,systemd docker_registry_mirrors: [] # docker registry mirror list docker_exporter_port: 9323 # docker metrics exporter port, 9323 by default docker_image: [] # docker image to be pulled after bootstrap docker_image_cache: /tmp/docker/*.tgz # docker image cache glob pattern

docker_enabled

参数名称: docker_enabled, 类型: bool, 层次:C

是否在当前节点启用Docker?默认为: false,即不启用。


docker_data

参数名称: docker_data, 类型: path, 层次:C

Docker 主数据目录,默认为 /var/lib/docker


docker_storage_driver

参数名称: docker_storage_driver, 类型: enum, 层次:C

Docker 存储驱动,默认值为: overlay2

可选值请参考:https://docs.docker.com/engine/storage/drivers/select-storage-driver/

  • overlay2
  • fuse-overlayfs
  • brtfs
  • zfs
  • vfs

docker_cgroups_driver

参数名称: docker_cgroups_driver, 类型: enum, 层次:C

Docker使用的 CGroup FS 驱动,可以是 cgroupfssystemd,默认值为: systemd


docker_registry_mirrors

参数名称: docker_registry_mirrors, 类型: string[], 层次:C

Docker使用的镜像仓库地址,默认值为:[] 空数组。

您可以使用Docker镜像站点加速镜像拉取,下面是一些例子:

使用国内厂商的 Docker 镜像站点:

docker_registry_mirrors: - https://docker.m.daocloud.io - https://dockerproxy.com - https://docker.mirrors.ustc.edu.cn - https://docker.nju.edu.cn

使用各家云厂商内网镜像:

["https://docker.m.daocloud.io"] # 国内 DaoCloud 镜像站点 ["https://docker.1ms.run"] # 国内毫秒镜像镜像站点 ["https://mirror.ccs.tencentyun.com"] # 腾讯云内网的镜像站点 ["https://registry.cn-hangzhou.aliyuncs.com"] # 阿里云镜像站点,需要登陆

使用 Cloudflare Worker 一键免费自建 Docker 中转代理

如果拉取速度太慢,您也可以考虑:docker login quay.io 使用其他的 Registry。


docker_exporter_port

参数名称: docker_exporter_port, 类型: port, 层次:G

Docker 暴露指标使用的端口,默认为 9323


docker_image_cache

参数名称: docker_image_cache, 类型: path, 层次:C

本地的Docker镜像离线缓存包路径, 默认为 /tmp/docker/*.tgz

所有匹配该正则表达式的文件,会被视作 Tar + GZ 制作的压缩 Docker 镜像,会逐个通过 docker load 加载:

cat *.tgz | gzip -d -c - | docker load




最后修改 2025-03-22: update pig docs (3a10e19)