Bitnami Redis® Sentinel 镜像

什么是 Redis® Sentinel？

Redis® Sentinel 为 Redis 提供高可用性支持。Redis Sentinel 还提供其他辅助功能，如监控、通知，并作为客户端的配置提供者。

Redis® Sentinel 概述
免责声明：Redis 是 Redis Ltd. 的注册商标。Bitnami 对其的任何使用仅为参考目的，不表示 Redis Ltd. 的任何赞助、认可或关联。

快速入门

console
docker run --name redis-sentinel -e REDIS_MASTER_HOST=redis REGISTRY_NAME/bitnami/redis-sentinel:latest

警告：此快速设置仅适用于开发环境。建议修改不安全的默认凭据，并查看环境变量部分的可用配置选项以进行更安全的部署。

核心功能和特性

为什么使用 Bitnami 安全镜像？

• Bitnami 安全镜像和 Helm 图表旨在提高开源软件的安全性和企业就绪性。
• 通过行业标准漏洞可利用性交换（VEX）、KEV 和 EPSS 评分，更快地分类安全漏洞，透明呈现 CVE 风险。
• 强化镜像使用最小化操作系统（Photon Linux），减少***面，同时通过行业标准包格式保持可扩展性。
• 持续构建的镜像在上游补丁发布后数小时内更新，确保更高的安全性和合规性。
• Bitnami 容器、虚拟机和云镜像使用相同的组件和配置方法，便于根据项目需求在不同格式间切换。
• 强化镜像附带证明签名（Notation）、SBOM、病毒扫描报告和其他元数据，均在符合 SLSA-3 标准的软件工厂中生成。

仅部分 BSI 应用可免费使用。如需访问完整应用目录及企业支持？立即尝试 Bitnami 安全镜像商业版。

为什么使用非 root 容器？

非 root 容器镜像增加了额外的安全层，通常推荐用于生产环境。但由于它们以非 root 用户运行，通常无法执行特权任务。更多关于非 root 容器的信息，请参见 Bitnami 文档。

支持的标签及对应 Dockerfile 链接

了解 Bitnami 标签策略及滚动标签与不可变标签的区别，请参见 Bitnami 文档。

可通过分支文件夹中的 tags-info.yaml 文件查看不同标签的对应关系，例如 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml。

订阅项目更新，请关注 bitnami/containers GitHub 仓库。

获取此镜像

获取 Bitnami Redis® Sentinel Docker 镜像的推荐方式是从 Docker Hub 仓库 拉取预构建镜像。

console
docker pull REGISTRY_NAME/bitnami/redis-sentinel:latest

如需使用特定版本，可拉取带版本标签的镜像。可在 Docker Hub 仓库 查看可用版本列表。

console
docker pull REGISTRY_NAME/bitnami/redis-sentinel:[TAG]

如需自行构建镜像，可克隆仓库，进入包含 Dockerfile 的目录，执行 docker build 命令。请将以下命令中的 APP、VERSION 和 OPERATING-SYSTEM 占位符替换为实际值。

console
git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t REGISTRY_NAME/bitnami/APP:latest .

使用场景和适用范围

Redis® Sentinel 适用于需要 Redis 高可用架构的场景，例如：

• 生产环境中确保 Redis 服务持续可用，自动故障转移
• 分布式系统中监控 Redis 主从节点状态
• 需要自动通知节点故障的业务场景
• 客户端通过 Sentinel 获取 Redis 主节点配置的架构

详细使用方法和配置说明

连接到其他容器

通过 Docker 容器网络，容器内运行的 Redis 服务器可被应用容器轻松访问。同一网络中的容器可通过容器名作为主机名相互通信。

使用命令行

以下示例将创建一个 Redis® Sentinel 实例，监控同一 Docker 网络中的 Redis® 实例。

步骤 1：创建网络

console
docker network create app-tier --driver bridge

步骤 2：启动 Redis® 实例

使用 --network app-tier 参数将 Redis 容器附加到 app-tier 网络。

console
docker run -d --name redis-server \
    -e ALLOW_EMPTY_PASSWORD=yes \
    --network app-tier \
    REGISTRY_NAME/bitnami/redis:latest

步骤 3：启动 Redis® Sentinel 实例

创建新容器实例以启动 Redis® Sentinel 并连接到上一步创建的服务器：

console
docker run -it --rm \
    -e REDIS_MASTER_HOST=redis-server \
    --network app-tier \
    REGISTRY_NAME/bitnami/redis-sentinel:latest

配置

环境变量

可自定义环境变量

只读环境变量

保护 Redis® Sentinel 通信

Redis® 从版本 6 开始支持 SSL/TLS 连接。如需启用此功能，可使用上述 REDIS_SENTINEL_TLS_* 环境变量进行配置。

启用 TLS 后，默认禁用常规流量。但该功能并非互斥，可同时监听 TLS 和非 TLS 连接。如需启用非 TLS 流量，需将 REDIS_SENTINEL_PORT_NUMBER 设置为非 0 的端口。

1. 使用 docker run 命令：

   console
   docker run --name redis-sentinel \
       -v /path/to/certs:/opt/bitnami/redis/certs \
       -v /path/to/redis-sentinel/persistence:/bitnami \
       -e REDIS_MASTER_HOST=redis \
       -e REDIS_SENTINEL_TLS_ENABLED=yes \
       -e REDIS_SENTINEL_TLS_CERT_FILE=/opt/bitnami/redis/certs/redis.crt \
       -e REDIS_SENTINEL_TLS_KEY_FILE=/opt/bitnami/redis/certs/redis.key \
       -e REDIS_SENTINEL_TLS_CA_FILE=/opt/bitnami/redis/certs/redisCA.crt \
       REGISTRY_NAME/bitnami/redis-sentinel:latest
   

也可通过自定义配置文件提供此配置。

配置文件

镜像会在 /bitnami/redis-sentinel/conf/ 目录中查找配置。可挂载卷到 /bitnami，并在 /path/to/redis-persistence/redis-sentinel/conf/ 中编辑配置。若 conf/ 目录为空，将自动填充默认配置。

步骤 1：运行 Redis® Sentinel 镜像

运行 Redis® Sentinel 镜像，挂载主机目录：

console
docker run --name redis-sentinel \
    -e REDIS_MASTER_HOST=redis \
    -v /path/to/redis-sentinel/persistence:/bitnami \
    REGISTRY_NAME/bitnami/redis-sentinel:latest

步骤 2：编辑配置

使用编辑器在主机上修改配置：

console
vi /path/to/redis-persistence/redis-sentinel/conf/sentinel.conf

步骤 3：重启 Redis® Sentinel

修改配置后，重启容器使变更生效：

console
docker restart redis-sentinel

完整配置选项请参考 Redis® 配置手册。

Bitnami 安全镜像中的 FIPS 配置

Bitnami 安全镜像 目录中的 Bitnami Redis® Sentinel Docker 镜像包含额外功能和设置，可配置容器支持 FIPS。可设置以下环境变量：

• OPENSSL_FIPS：OpenSSL 是否运行在 FIPS 模式。yes（默认）、no。

日志

Bitnami Redis® Sentinel Docker 镜像将容器日志输出到 stdout。查看日志：

console
docker logs redis-sentinel

如需自定义日志消费方式，可使用 --log-driver 选项配置容器日志驱动。默认使用 json-file 驱动。

维护

升级镜像

Bitnami 会及时提供 Redis® Sentinel 的更新版本，包括安全补丁。建议按以下步骤升级容器：

步骤 1：获取更新的镜像

console
docker pull REGISTRY_NAME/bitnami/redis-sentinel:latest

步骤 2：停止并备份当前运行的容器

使用以下命令停止当前容器：

console
docker stop redis-sentinel

使用 rsync 快照持久化卷 /path/to/redis-persistence：

console
rsync -a /path/to/redis-persistence /path/to/redis-persistence.bkp.$(date +%Y%m%d-%H.%M.%S)

步骤 3：移除当前运行的容器

console
docker rm -v redis-sentinel

步骤 4：运行新镜像

使用新镜像重新创建容器：

console
docker run --name redis-sentinel REGISTRY_NAME/bitnami/redis-sentinel:latest

重要变更

2024 年 1 月 16 日起

• docker-compose.yaml 文件已移除，该文件仅用于内部测试。

版本 4.0.14-debian-9-r201、4.0.14-ol-7-r222、5.0.5-debian-9-r169、5.0.5-ol-7-r175

• 减小容器体积。配置逻辑基于 rootfs/ 目录中的 Bash 脚本实现。

版本 4.0.10-r25

• Redis® Sentinel 容器已迁移至非 root 容器模式。此前容器以 root 用户运行，Redis 守护进程以 redis 用户运行；现在容器和 Redis 守护进程均以用户 1001 运行。因此，配置文件可被运行 Redis 进程的用户写入。如需恢复原有行为，可将 Dockerfile 中的 USER 1001 修改为 USER root。

贡献

欢迎为此容器贡献代码。可通过创建 issue 请求新功能，或提交 pull request 贡献代码。

问题反馈

如运行容器时遇到问题，请提交 [issue](