bitnamisecure/redis-sentinel

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。

订阅项目更新，请关注 https://github.com/bitnami/containers%E3%80%82

获取此镜像

获取 Bitnami Redis® Sentinel Docker 镜像的推荐方式是从 https://hub.docker.com/r/bitnami/redis-sentinel 拉取预构建镜像。

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

如需使用特定版本，可拉取带版本标签的镜像。可在 https://hub.docker.com/r/bitnami/redis-sentinel/tags/ 查看可用版本列表。

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

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

console
git clone https://github.com/bitnami/containers.git
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
   

也可通过https://github.com/bitnami/containers/blob/main/bitnami/redis-sentinel#configuration-file%E6%8F%90%E4%BE%9B%E6%AD%A4%E9%85%8D%E7%BD%AE%E3%80%82

配置文件

镜像会在 /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。

贡献

欢迎为此容器贡献代码。可通过创建 https://github.com/bitnami/containers/issues 请求新功能，或提交 https://github.com/bitnami/containers/pulls 贡献代码。

问题反馈

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