bitnami/valkey-sentinel

Bitnami Valkey Sentinel 镜像文档

镜像概述和主要用途

Valkey Sentinel 是 Valkey 的高可用性解决方案，提供以下核心能力：监控 Valkey 节点状态、自动执行故障转移、发送通知以及为客户端提供配置信息。Bitnami Valkey Sentinel 镜像基于 Bitnami 安全最佳实践构建，支持非 root 用户运行，适用于开发和生产环境中的 Valkey 集群高可用部署。

核心功能和特性

Valkey Sentinel 核心功能

• 高可用性支持：自动检测主节点故障并触发故障转移，确保 Valkey 服务持续可用
• 监控能力：实时监控 Valkey 主节点和从节点的健康状态
• 通知机制：当节点状态变化（如故障、故障转移）时发送通知
• 配置提供：为客户端提供当前可用的 Valkey 主节点信息，简化客户端连接逻辑

Bitnami 镜像特性

• 安全强化：遵循 Bitnami Secure Images 标准，基于最小化操作系统（Photon Linux）构建，减少***面
• 非 root 容器：默认以非特权用户运行，增强容器安全性
• TLS 支持：可配置 SSL/TLS 加密通信，保护数据传输安全
• FIPS 合规：支持 FIPS 模式（需使用 Bitnami Secure Images 商业版）
• 配置灵活性：通过环境变量或挂载配置文件自定义 Valkey Sentinel 行为
• 持久化存储：支持数据目录挂载，确保配置和状态持久化

使用场景和适用范围

典型使用场景

• 生产环境 Valkey 集群：需高可用性保障的 Valkey 部署，避免单点故障
• 自动故障转移需求：无需人工干预即可实现主从切换的场景
• 分布式系统监控：需要集中监控 Valkey 节点状态的分布式架构
• 安全合规场景：对数据传输加密（TLS）或 FIPS 合规有要求的环境

适用范围

• 开发环境：快速搭建 Valkey 高可用测试集群
• 生产环境：通过合理配置（如调整 quorum 值、超时参数）满足生产级可用性要求
• 混合云部署：跨节点、跨区域的 Valkey 集群高可用配置

快速启动

基本启动命令

以下命令快速启动 Valkey Sentinel 容器（仅适用于开发环境）：

console
docker run --name valkey-sentinel -e VALKEY_PRIMARY_HOST=valkey bitnami/valkey-sentinel:latest

警告：此快速配置仅用于开发环境。生产环境需修改默认凭据并参考 环境变量 部分进行安全配置。

镜像获取与准备

拉取官方镜像

推荐从 Docker Hub 拉取预构建镜像：

console
# 获取最新版
docker pull bitnami/valkey-sentinel:latest

# 获取特定版本（需替换 [TAG] 为具体版本号，如 7.2.4）
docker pull bitnami/valkey-sentinel:[TAG]

本地构建镜像（可选）

如需自定义构建，可克隆 Bitnami 容器仓库并执行构建：

console
git clone https://github.com/bitnami/containers.git
cd containers/bitnami/valkey-sentinel/[VERSION]/[OS]  # 替换为具体版本和操作系统
docker build -t bitnami/valkey-sentinel:latest .

详细部署示例

单节点 Valkey + Sentinel 部署

步骤 1：创建 Docker 网络

console
docker network create valkey-network --driver bridge

步骤 2：启动 Valkey 主节点

console
docker run -d \
  --name valkey-primary \
  --network valkey-network \
  -e ALLOW_EMPTY_PASSWORD=yes \  # 开发环境允许空密码（生产环境需设置密码）
  bitnami/valkey:latest

步骤 3：启动 Valkey Sentinel

console
docker run -d \
  --name valkey-sentinel \
  --network valkey-network \
  -e VALKEY_PRIMARY_HOST=valkey-primary \  # 指向 Valkey 主节点容器名
  -e VALKEY_PRIMARY_SET=myprimary \        # 主节点集名称（自定义）
  -e VALKEY_SENTINEL_QUORUM=1 \            # 故障转移决策所需的最小 Sentinel 节点数（单节点场景设为 1）
  -e ALLOW_EMPTY_PASSWORD=yes \
  bitnami/valkey-sentinel:latest

Docker Compose 部署示例（多节点）

创建 docker-compose.yml 文件：

yaml
version: '3.8'

networks:
  valkey-network:
    driver: bridge

services:
  valkey-primary:
    image: bitnami/valkey:latest
    environment:
      - ALLOW_EMPTY_PASSWORD=yes
    networks:
      - valkey-network
    restart: unless-stopped

  valkey-sentinel-1:
    image: bitnami/valkey-sentinel:latest
    environment:
      - VALKEY_PRIMARY_HOST=valkey-primary
      - VALKEY_PRIMARY_SET=myprimary
      - VALKEY_SENTINEL_QUORUM=2  # 需至少 2 个 Sentinel 节点达成共识
      - ALLOW_EMPTY_PASSWORD=yes
    networks:
      - valkey-network
    restart: unless-stopped

  valkey-sentinel-2:
    image: bitnami/valkey-sentinel:latest
    environment:
      - VALKEY_PRIMARY_HOST=valkey-primary
      - VALKEY_PRIMARY_SET=myprimary
      - VALKEY_SENTINEL_QUORUM=2
      - ALLOW_EMPTY_PASSWORD=yes
    networks:
      - valkey-network
    restart: unless-stopped

启动部署：

console
docker-compose up -d

配置说明

环境变量

可自定义环境变量

只读环境变量（用于引用，不可修改）

安全配置

启用 TLS 加密通信

通过以下环境变量配置 TLS（生产环境必备）：

console
docker run --name valkey-sentinel \
  --network valkey-network \
  -v /host/path/to/certs:/opt/bitnami/valkey/certs \  # 挂载本地证书目录
  -e VALKEY_PRIMARY_HOST=valkey-primary \
  -e VALKEY_SENTINEL_TLS_ENABLED=yes \
  -e VALKEY_SENTINEL_TLS_CERT_FILE=/opt/bitnami/valkey/certs/server.crt \
  -e VALKEY_SENTINEL_TLS_KEY_FILE=/opt/bitnami/valkey/certs/server.key \
  -e VALKEY_SENTINEL_TLS_CA_FILE=/opt/bitnami/valkey/certs/ca.crt \
  bitnami/valkey-sentinel:latest

使用自定义配置文件

通过挂载配置目录自定义 sentinel.conf：

1. 启动容器并挂载持久化目录，生成默认配置：

   console
   docker run --name valkey-sentinel \
     -v /host/path/to/persistence:/bitnami \
     -e VALKEY_PRIMARY_HOST=valkey-primary \
     bitnami/valkey-sentinel:latest
   

2. 在宿主机编辑配置文件：

   console
   vi /host/path/to/persistence/valkey-sentinel/conf/sentinel.conf
   

3. 重启容器使配置生效：

   console
   docker restart valkey-sentinel
   

FIPS 模式配置（商业版）

Bitnami Secure Images 商业版支持 FIPS 140-2 合规模式，通过以下环境变量启用：

console
docker run --name valkey-sentinel \
  -e OPENSSL_FIPS=yes \  # 启用 FIPS 模式
  bitnami/valkey-sentinel:latest  # 需使用商业版镜像

日志管理

Valkey Sentinel 日志默认输出到 stdout，可通过 docker logs 查看：

console
docker logs valkey-sentinel  # 查看实时日志
docker logs -f valkey-sentinel  # 跟踪日志输出

如需自定义日志驱动（如输出到文件或日志系统），可通过 --log-driver 配置：

console
docker run --name valkey-sentinel \
  --log-driver json-file \  # 默认驱动，也可使用 journald、syslog 等
  --log-opt max-size=10m \  # 限制日志文件大小
  --log-opt max-file=3 \    # 保留日志文件数量
  bitnami/valkey-sentinel:latest

维护与升级

升级镜像

1. 拉取最新镜像：

   console
   docker pull bitnami/valkey-sentinel:latest
   

2. 停止并备份当前容器数据：

   console
   docker stop valkey-sentinel
   rsync -a /host/path/to/persistence /host/path/to/persistence.bkp.$(date +%Y%m%d)
   

3. 删除旧容器：

   console
   docker rm valkey-sentinel
   

4. 使用新镜像启动容器（复用原挂载目录）：

   console
   docker run --name valkey-sentinel \
     -v /host/path/to/persistence:/bitnami \
     --network valkey-network \
     -e VALKEY_PRIMARY_HOST=valkey-primary \
     bitnami/valkey-sentinel:latest
   

重要通知：Bitnami 镜像计划变更

自 2025 年 8 月 28 日起，Bitnami 将调整公共镜像策略，推出 Bitnami Secure Images 计划：

• 镜像迁移：所有现有镜像（含历史版本标签，如 7.2.4）将迁移至 docker.io/bitnamilegacy 仓库，不再更新
• 免费版调整：免费用户仅可访问部分安全强化镜像（仅 latest 标签），用于开发环境
• 商业版特性：生产环境推荐使用商业版 Bitnami Secure Images，包含安全硬化、CVE 透明度、SBOM、企业支持等功能

详情参见 https://github.com/bitnami/containers/issues/83267%E3%80%82

问题反馈与贡献

• 问题反馈：如遇容器运行问题，请在 https://github.com/bitnami/containers/issues 提交 issue
• 贡献代码：欢迎通过 PR 贡献功能或修复，详见仓库贡献指南

许可证

本镜像基于 Apache License 2.0 许可协议分发。详见 Apache 许可证。

商标声明：本软件由 Bitnami 打包，相关商标归各自公司所有，使用不代表关联或背书。