hasnat/volumes-provisioner

Docker Volumes Provisioner

镜像概述和主要用途

Docker Volumes Provisioner 是一个基于 Alpine 的辅助镜像，主要用于创建具有适当所有者和权限的目录，供其他容器使用。它通过 install 命令实现目录创建及权限设置，解决了其他容器启动前需要特定权限目录的问题。

核心功能和特性

• 轻量级基础：基于 Alpine 镜像，体积小且资源占用低
• 灵活配置：通过环境变量指定目录的所有者（uid）、所属组（gid）、权限（mode）及路径
• 多目录支持：可同时配置多个目录，支持空格分隔多个目录路径
• 多配置支持：可通过分号分隔多个独立配置项，满足复杂场景需求
• 解决权限问题：确保其他容器启动前目录已具备正确权限，避免因权限不足导致的启动失败

使用场景和适用范围

适用于需要在容器启动前创建特定权限目录的场景，例如：

• https://hub.docker.com/_/mysql 数据目录需要 1000:1000 权限
• https://hub.docker.com/r/prom/prometheus 数据目录需要 65534:65534 权限
• https://hub.docker.com/r/grafana/grafana 数据目录需要 472:472 权限

使用方法和配置说明

环境变量配置

通过环境变量 PROVISION_DIRECTORIES 传递配置，格式为：

uid:gid:mode:dir(s)

• uid: 目录所有者的用户ID
• gid: 目录所属组的组ID
• mode: 目录权限（八进制格式，如 0755）
• dir(s): 目录路径，多个目录用空格分隔

多配置项：使用分号 ; 分隔多个独立配置，例如：

1000:1000:0755:/var/www /var/www/html;1001:1001:0755:/var/app /var/app/cache

Docker Run 示例

bash
docker run --rm \
-e PROVISION_DIRECTORIES=1000:1000:0755:/var/www \
-v `pwd`/data:/var/www \
hasnat/volumes-provisioner

# 验证目录权限
ls -dhn data

Docker Compose 示例（Prometheus）

通过 depends_on 确保在 Prometheus 启动前创建具有正确权限的目录：

yaml
version: '2'
services:
  volumes-provisioner:
    image: hasnat/volumes-provisioner
    environment:
      PROVISION_DIRECTORIES: "65534:65534:0755:/var/data/prometheus/data"
    volumes:
      - "./var/data:/var/data"
    network_mode: none

  prometheus:
    image: prom/prometheus:v2.3.2
    ports:
      - "9090:9090"
    depends_on:
      - volumes-provisioner
    volumes:
      - "./var/data/prometheus/data:/prometheus/data"

本地构建

bash
# 构建镜像
docker build -t volumes-provisioner .

# 运行测试
docker run --rm \
-e PROVISION_DIRECTORIES=1000:1000:0755:/var/www \
-v `pwd`/data:/var/www \
volumes-provisioner

# 验证目录权限
ls -dhn data

注意事项

• 不支持 Docker for macOS 的卷挂载场景