cloud-reporter/backend/REDIS_SETUP.md

Redis 设置指南

概述

AWS Resource Scanner 使用 Redis 作为 Celery 的消息队列和结果后端。Redis 是必需的组件，用于处理异步的 AWS 资源扫描任务。

安装 Redis

Windows

方式1: 使用 Chocolatey (推荐)

choco install redis-64
redis-server --service-install
redis-server --service-start

方式2: 下载预编译版本

从 https://github.com/microsoftarchive/redis/releases 下载并安装

Linux

Ubuntu/Debian

sudo apt-get install redis-server
sudo systemctl start redis-server
sudo systemctl enable redis-server

CentOS/RHEL

sudo yum install redis
sudo systemctl start redis
sudo systemctl enable redis

macOS

brew install redis
brew services start redis

Docker (跨平台)

docker run -d --name redis -p 6379:6379 redis:alpine

验证 Redis 运行

redis-cli ping
# 应该返回: PONG

配置

环境变量 (.env)

CELERY_BROKER_URL=redis://localhost:6379/0
CELERY_RESULT_BACKEND=redis://localhost:6379/1

# 如果 Redis 有密码
# CELERY_BROKER_URL=redis://:password@localhost:6379/0
# CELERY_RESULT_BACKEND=redis://:password@localhost:6379/1

启动 Celery Worker

Redis 运行后，需要启动 Celery Worker 来处理任务：

cd backend

# 激活虚拟环境
activate_venv.bat  # Windows
# 或 source activate_venv.sh  # Unix/Linux

# 启动 Celery Worker
celery -A celery_worker.celery_app worker --loglevel=info --pool=solo

故障排除

Redis 连接失败

1. 检查 Redis 是否运行：

   redis-cli ping
   

2. 检查端口占用：

   netstat -an | grep 6379
   

3. 重启 Redis 服务：

   # Windows
   redis-server --service-stop
   redis-server --service-start
   
   # Linux
   sudo systemctl restart redis-server
   

Celery Worker 问题

1. 确保使用正确的启动命令：

   celery -A celery_worker.celery_app worker --loglevel=info --pool=solo
   

2. 检查 Worker 状态：

   celery -A celery_worker.celery_app inspect active
   

生产环境建议

1. 配置 Redis 持久化
2. 设置 Redis 内存限制
3. 启用 Redis 密码认证
4. 配置 Celery Worker 监控
5. 设置任务结果过期时间