# 管理预案 > Redis 集群管理 SOP，创建、销毁、扩容、缩容与高可用的详细说明 --- LLMS index: [llms.txt](/llms.txt) --- 以下是一些常见的 Redis 管理任务 SOP（预案）： REDIS 模块默认使用 `redis_type: redis`；选择 `redis_type: valkey` 时，服务端与客户端命令分别改为 `valkey-server` / `valkey-cli`。 本文命令行示例使用默认的 `redis-cli`，Valkey 集群请替换为 `valkey-cli`；剧本内部会自动选择正确的 CLI。 **基础运维** - [初始化Redis](#初始化redis) - [下线Redis](#下线redis) - [重新配置Redis](#重新配置redis) - [使用Redis客户端](#使用redis客户端) **高可用管理** - [手工设置Redis从库](#手工设置redis从库) - [设置Redis主从高可用](#设置redis主从高可用) - [初始化Redis原生集群](#初始化-redis-原生集群) **扩缩容与迁移** - [扩容Redis节点](#扩容redis节点) - [缩容Redis节点](#缩容redis节点) - [数据备份与恢复](#数据备份与恢复) **故障排查** - [常见问题诊断](#常见问题诊断) - [性能调优](#性能调优) 更多问题请参考 [FAQ：REDIS](/docs/redis/faq/)。 ------------- ## 初始化Redis 您可以使用 [`redis.yml`](/docs/redis/playbook#redisyml) 剧本来初始化 Redis 集群、节点、或实例： ```bash # 初始化集群内所有 Redis 实例 ./redis.yml -l # 初始化 redis 集群 # 初始化特定节点上的所有 Redis 实例 ./redis.yml -l 10.10.10.10 # 初始化 redis 节点 # 初始化特定 Redis 实例： 10.10.10.11:6379 ./redis.yml -l 10.10.10.11 -e redis_port=6379 -t redis ``` 你也可以使用包装脚本命令行脚本来初始化： ```bash bin/redis-add redis-ms # 初始化 redis 集群 'redis-ms' bin/redis-add 10.10.10.10 # 初始化 redis 节点 '10.10.10.10' bin/redis-add 10.10.10.10 6379 # 初始化 redis 实例 '10.10.10.10:6379' ``` ------------- ## 下线Redis 您可以使用 [`redis-rm.yml`](/docs/redis/playbook#redis-rmyml) 剧本来下线 Redis 集群、节点、或实例： `redis_rm_data` 默认为 `true`。先核对 RDB/AOF 备份、当前主从/哨兵/集群拓扑并让操作者确认精确目标；下面命令会直接执行相应的下线操作。 ```bash # 下线 Redis 集群 `redis-test` ./redis-rm.yml -l redis-test # 下线 Redis 集群 `redis-test` 并卸载所选引擎与 exporter ./redis-rm.yml -l redis-test -e redis_rm_pkg=true # 下线 Redis 节点 10.10.10.13 上的所有实例 ./redis-rm.yml -l 10.10.10.13 # 下线特定 Redis 实例 10.10.10.13:6379 ./redis-rm.yml -l 10.10.10.13 -e redis_port=6379 ``` 你也可以使用包装脚本来下线 Redis 集群/节点/实例： ```bash bin/redis-rm redis-ms # 下线 redis 集群 'redis-ms' bin/redis-rm 10.10.10.10 # 下线 redis 节点 '10.10.10.10' bin/redis-rm 10.10.10.10 6379 # 下线 redis 实例 '10.10.10.10:6379' ``` ------------- ## 重新配置Redis 您可以部分执行 [`redis.yml`](/docs/redis/playbook#redisyml) 剧本来重新配置 Redis 集群、节点、或实例： ```bash ./redis.yml -l -t redis_config,redis_launch ``` 请注意，redis 无法在线重载配置，您只能使用 launch 任务进行重启来让配置生效。 ------------- ## 使用Redis客户端 默认 Redis 引擎使用 `redis-cli` 访问实例；Valkey 使用 `valkey-cli`，参数与下列示例相同： ```bash $ redis-cli -h 10.10.10.10 -p 6379 # <--- 使用 Host 与 Port 访问对应 Redis 实例 10.10.10.10:6379> auth redis.ms # <--- 使用密码验证 OK 10.10.10.10:6379> set a 10 # <--- 设置一个Key OK 10.10.10.10:6379> get a # <--- 获取 Key 的值 "10" ``` Redis 提供了 `redis-benchmark` 工具，可以用于 Redis 的性能评估，或生成一些负载用于测试。 ```bash redis-benchmark -h 10.10.10.13 -p 6379 ``` ------------- ## 手工设置Redis从库 https://redis.io/commands/replicaof/ ```bash # 将一个 Redis 实例提升为主库 > REPLICAOF NO ONE "OK" # 将一个 Redis 实例设置为另一个实例的从库 > REPLICAOF 127.0.0.1 6379 "OK" ``` ------------- ## 设置Redis主从高可用 Redis 独立主从集群可以通过 Redis 哨兵集群配置自动高可用，详细用户请参考 [Sentinel官方文档](https://redis.io/docs/management/sentinel/) 以四节点 [**沙箱**](/docs/deploy/sandbox) 为例，一套 Redis Sentinel 集群 `redis-meta`，可以用来管理很多套独立 Redis 主从集群。 以一主一从的 Redis 普通主从集群 `redis-ms` 为例，您需要在每个 Sentinel 实例上，使用 `SENTINEL MONITOR` 添加目标，并使用 `SENTINEL SET` 提供密码，高可用就配置完毕了。 ```bash # 对于每一个 sentinel，将 redis 主服务器纳入哨兵管理：（26379,26380,26381） $ redis-cli -h 10.10.10.11 -p 26379 -a redis.meta 10.10.10.11:26379> SENTINEL MONITOR redis-ms 10.10.10.10 6379 1 10.10.10.11:26379> SENTINEL SET redis-ms auth-pass redis.ms # 如果启用了授权，需要配置密码 ``` 如果您想移除某个由 Sentinel 管理的 Redis 主从集群，使用 `SENTINEL REMOVE ` 移除即可。 您可以使用定义在 Sentinel 集群上的 [`redis_sentinel_monitor`](/docs/redis/param#redis_sentinel_monitor) 参数，来自动配置管理哨兵监控管理的主库列表。 ```yaml redis_sentinel_monitor: # 需要被监控的主库列表，端口、密码、法定人数（应为1/2以上的哨兵数量）为可选参数 - { name: redis-src, host: 10.10.10.45, port: 6379 ,password: redis.src, quorum: 1 } - { name: redis-dst, host: 10.10.10.48, port: 6379 ,password: redis.dst, quorum: 1 } ``` `redis.yml` 中的 `redis-ha` 阶段会根据该列表在每个哨兵实例上渲染 `/tmp/.monitor` 并依次执行 `SENTINEL REMOVE` 与 `SENTINEL MONITOR` 命令， 从而保证哨兵纳管状态与清单保持一致。如果只想移除某个目标而不再重新添加，可以在监控对象上设置 `remove: true`，剧本会在 `SENTINEL REMOVE` 后跳过重新注册。 使用以下命令刷新 Redis 哨兵集群上的纳管主库列表： ```bash ./redis.yml -l redis-meta -t redis-ha # 如果您的 Sentinel 集群名称不是 redis-meta，请在这里替换。 ``` ------------- ## 初始化 Redis 原生集群 当 [`redis_mode`](/docs/redis/param#redis_mode) 设置为 `cluster` 时，`redis.yml` 会额外执行 `redis-join` 阶段： 剧本会使用 `redis_type` 对应的 CLI 执行 `--cluster create --cluster-yes ... --cluster-replicas {{ redis_cluster_replicas }}`，把所有清单实例拼成原生集群。 该步骤在首次部署时自动运行；后续执行 `./redis.yml -l -t redis-join` 会先检查种子实例的 `cluster_state:ok`，健康集群会直接退出。该保护不负责 add-node、reshard 或修复部分初始化的拓扑，只有确认当前拓扑状态后才应单独触发。 ------------- ## 扩容Redis节点 ### 扩容独立主从集群 向现有的 Redis 主从集群添加新节点/实例时，首先在配置清单中添加新的定义： ```yaml redis-ms: hosts: 10.10.10.10: { redis_node: 1 , redis_instances: { 6379: { }, 6380: { replica_of: '10.10.10.10 6379' } } } 10.10.10.11: { redis_node: 2 , redis_instances: { 6379: { replica_of: '10.10.10.10 6379' } } } # 新增节点 vars: { redis_cluster: redis-ms ,redis_password: 'redis.ms' ,redis_max_memory: 64MB } ``` 然后仅针对新节点执行部署： ```bash ./redis.yml -l 10.10.10.11 # 仅部署新增的节点 ``` ### 扩容原生集群 向 Redis 原生集群添加新节点需要额外的步骤： ```bash # 1. 在配置清单中添加新节点 # 2. 部署新节点 ./redis.yml -l 10.10.10.14 # 3. 将新节点添加到集群中（手动执行） redis-cli --cluster add-node 10.10.10.14:6379 10.10.10.12:6379 # 4. 重新分配槽位（如需要） redis-cli --cluster reshard 10.10.10.12:6379 ``` ### 扩容哨兵集群 向 Sentinel 集群添加新实例后，需要同时完成实例部署与纳管目标刷新： ```bash # 1. 在配置清单中添加新的哨兵实例，部署实例 ./redis.yml -l -t redis_instance # 2. 重新下发 redis_sentinel_monitor 到所有哨兵 ./redis.yml -l -t redis-ha ``` ------------- ## 缩容Redis节点 ### 缩容独立主从集群 ```bash # 1. 如果要移除的是从库，直接移除即可 ./redis-rm.yml -l 10.10.10.11 -e redis_port=6379 # 2. 如果要移除的是主库，先进行主从切换 redis-cli -h 10.10.10.10 -p 6380 REPLICAOF NO ONE # 提升从库 redis-cli -h 10.10.10.10 -p 6379 REPLICAOF 10.10.10.10 6380 # 降级原主库 # 3. 然后移除原主库 ./redis-rm.yml -l 10.10.10.10 -e redis_port=6379 # 4. 更新配置清单，移除相关定义 ``` ### 缩容原生集群 ```bash # 1. 先迁移数据槽位 redis-cli --cluster reshard 10.10.10.12:6379 \ --cluster-from --cluster-to --cluster-slots # 2. 从集群中移除节点 redis-cli --cluster del-node 10.10.10.12:6379 # 3. 下线实例 ./redis-rm.yml -l 10.10.10.14 # 4. 更新配置清单 ``` ------------- ## 数据备份与恢复 ### 手动备份 ```bash # 触发 RDB 快照 redis-cli -h 10.10.10.10 -p 6379 -a BGSAVE # 查看快照状态 redis-cli -h 10.10.10.10 -p 6379 -a LASTSAVE # 复制 RDB 文件（默认位置） cp /data/redis/redis-ms-1-6379/dump.rdb /backup/redis-ms-$(date +%Y%m%d).rdb ``` ### 数据恢复 ```bash # 1. 停止 Redis 实例 sudo systemctl stop redis-ms-1-6379 # 2. 替换 RDB 文件 cp /backup/redis-ms-20241231.rdb /data/redis/redis-ms-1-6379/dump.rdb chown redis:redis /data/redis/redis-ms-1-6379/dump.rdb # 3. 启动 Redis 实例 sudo systemctl start redis-ms-1-6379 ``` ### 使用 AOF 持久化 如果需要更高的数据安全性，可以启用 AOF： ```yaml redis-ms: vars: redis_aof_enabled: true redis_rdb_save: ['900 1', '300 10', '60 10000'] # 同时保留 RDB ``` 重新部署以应用 AOF 配置： ```bash ./redis.yml -l redis-ms -t redis_config,redis_launch ``` ------------- ## 常见问题诊断 ### 连接问题排查 ```bash # 检查 Redis 服务状态 systemctl status redis-ms-1-6379 # 检查端口监听 ss -tlnp | grep 6379 # 检查防火墙 sudo iptables -L -n | grep 6379 # 测试连接 redis-cli -h 10.10.10.10 -p 6379 PING ``` ### 内存问题排查 ```bash # 查看内存使用情况 redis-cli -h 10.10.10.10 -p 6379 INFO memory # 查看大 Key redis-cli -h 10.10.10.10 -p 6379 --bigkeys # 查看内存分析报告 redis-cli -h 10.10.10.10 -p 6379 MEMORY DOCTOR ``` ### 性能问题排查 ```bash # 查看慢查询日志 redis-cli -h 10.10.10.10 -p 6379 SLOWLOG GET 10 # 实时监控命令 redis-cli -h 10.10.10.10 -p 6379 MONITOR # 查看客户端连接 redis-cli -h 10.10.10.10 -p 6379 CLIENT LIST ``` ### 复制问题排查 ```bash # 查看复制状态 redis-cli -h 10.10.10.10 -p 6379 INFO replication # 检查复制延迟 redis-cli -h 10.10.10.10 -p 6380 INFO replication | grep lag ``` ------------- ## 性能调优 ### 内存优化 ```yaml redis-cache: vars: redis_max_memory: 4GB # 根据可用内存设置 redis_mem_policy: allkeys-lru # 缓存场景推荐 LRU redis_conf: redis.conf ``` ### 持久化优化 ```yaml # 纯缓存场景：禁用持久化 redis-cache: vars: redis_rdb_save: [] # 禁用 RDB redis_aof_enabled: false # 禁用 AOF # 数据安全场景：同时启用 RDB 和 AOF redis-data: vars: redis_rdb_save: ['900 1', '300 10', '60 10000'] redis_aof_enabled: true ``` ### 连接池配置建议 客户端应用连接 Redis 时，建议： - 使用连接池，避免频繁创建连接 - 设置合理的超时时间（推荐 1-3 秒） - 启用 TCP keepalive - 对于高并发场景，考虑使用 Pipeline 批量操作 ### 监控关键指标 通过 Grafana 仪表盘关注以下指标： - **内存使用率**：`redis:ins:mem_usage` > 80% 时需要关注 - **CPU 使用率**：`redis:ins:cpu_usage` > 70% 时需要关注 - **QPS**：关注突增和异常波动 - **响应时间**：`redis:ins:rt` > 1ms 时需要排查 - **连接数**：关注连接数增长趋势 - **复制延迟**：主从复制场景下需要关注