apache/ranger-db

Ranger数据库Docker镜像文档

镜像概述

该Docker镜像专为Apache Ranger提供数据库支持，旨在简化Ranger部署过程中的数据库配置环节。容器内置预配置的数据库环境（如MySQL），并自动初始化Ranger服务所需的数据库架构与表结构，可直接满足Ranger的策略存储、用户管理等数据需求，减少手动配置数据库的复杂度。

核心功能与特性

• 预配置数据库环境：内置适用于Ranger的数据库（如MySQL），无需额外安装数据库软件
• 自动初始化架构：启动时自动创建Ranger所需的数据库、表及初始数据，省去手动执行SQL脚本步骤
• 环境变量配置：支持通过环境变量灵活调整数据库参数（如用户名、密码、端口等）
• 轻量级部署：基于官方数据库镜像构建，体积小巧，资源占用低，部署快速
• 无缝集成Ranger：与Apache Ranger服务完全兼容，满足Ranger对数据存储的全部需求

使用场景

• Ranger快速部署与测试：在开发或测试环境中，快速搭建Ranger所需的数据库环境，加速Ranger服务验证流程
• 开发环境支持：为开发人员提供独立的Ranger数据库实例，避免与其他环境数据库冲突
• 小规模生产环境：适用于数据量较小、对高可用性要求不高的Ranger部署场景，降低基础设施复杂度

使用方法

Docker Run命令示例

通过以下命令启动容器，快速部署Ranger数据库环境：

bash
docker run -d \
  --name ranger-db \
  -p 3306:3306 \
  -e DB_USER=rangeradmin \
  -e DB_PASSWORD=StrongPassword123! \
  -e DB_NAME=ranger \
  -e ROOT_PASSWORD=RootStrongPassword! \
  -v ranger-db-data:/var/lib/mysql \
  [镜像名称]

参数说明：

• -d：后台运行容器
• --name ranger-db：指定容器名称为ranger-db
• -p 3306:3306：映射容器内数据库端口（MySQL默认3306）到主机
• -v ranger-db-data:/var/lib/mysql：挂载数据卷，持久化数据库数据
• 环境变量：配置数据库用户、密码等核心参数（详见「配置参数」章节）

Docker Compose配置示例

与Ranger服务配合部署时，可使用docker-compose.yml实现一体化部署：

yaml
version: '3'
services:
  ranger-db:
    image: [镜像名称]
    container_name: ranger-db
    ports:
      - "3306:3306"
    environment:
      - DB_USER=rangeradmin
      - DB_PASSWORD=StrongPassword123!
      - DB_NAME=ranger
      - ROOT_PASSWORD=RootStrongPassword!
      - DB_PORT=3306
    volumes:
      - ranger-db-data:/var/lib/mysql
    networks:
      - ranger-network
    restart: unless-stopped

  ranger-admin:
    image: apache/ranger-admin:latest
    container_name: ranger-admin
    depends_on:
      - ranger-db
    environment:
      - DB_HOST=ranger-db
      - DB_PORT=3306
      - DB_USER=rangeradmin
      - DB_PASSWORD=StrongPassword123!
      - DB_NAME=ranger
    ports:
      - "6080:6080"
    networks:
      - ranger-network
    restart: unless-stopped

networks:
  ranger-network:

volumes:
  ranger-db-data:

验证数据库状态

容器启动后，可通过以下命令验证数据库是否正常运行：

bash
# 连接数据库
docker exec -it ranger-db mysql -u${DB_USER} -p${DB_PASSWORD} ${DB_NAME}

# 验证Ranger表结构（示例）
mysql> SHOW TABLES;

若成功列出Ranger相关表（如ranger_policy、ranger_users等），表明数据库环境已就绪。

配置参数

容器支持通过以下环境变量配置数据库参数，具体说明如下：

注意事项

• 数据持久化：生产环境必须使用Docker卷（Volume）挂载数据库数据目录（如/var/lib/mysql），避免容器删除导致数据丢失
• 安全配置：禁止使用默认密码，通过DB_PASSWORD和ROOT_PASSWORD设置强密码；限制数据库仅允许Ranger服务访问，避免公网暴露
• 高可用性：该镜像适用于开发/测试或小规模环境，大规模生产环境建议使用独立部署的高可用数据库集群（如MySQL主从、PostgreSQL集群）
• 版本兼容性：确保镜像版本与Ranger服务版本匹配，避免数据库架构不兼容问题（可参考Ranger官方文档的数据库版本要求）