[Feature] Redis 설치 및 연결 (#350)

* feat: redis 연결 및 repository 생성

* feat: docker compose redis 추가

* feat: 서버 시작 시, redis 연결 여부 확인

Author: HoonDongKang

backend/package.json

@@ -37,6 +37,7 @@
     "class-validator": "^0.14.1",
     "cookie-parser": "^1.4.7",
     "dotenv": "^17.2.3",
+    "ioredis": "^5.9.2",
     "passport": "^0.7.0",
     "passport-github2": "^0.1.12",
     "passport-jwt": "^4.0.1",
@@ -57,6 +58,7 @@
     "@nestjs/testing": "^11.0.1",
     "@types/cookie-parser": "^1.4.10",
     "@types/express": "^5.0.0",
+    "@types/ioredis": "^5.0.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^22.19.3",
     "@types/passport": "^1.0.17",

backend/src/app.module.ts

@@ -7,9 +7,10 @@ import { OauthModule } from './oauth/oauth.module'
 import { MetricsModule } from './metrics/metrics.module'
 import { HttpMetricsMiddleware } from './metrics/http-metrics.middleware'
 import { GeminiModule } from './gemini/gemini.module'
+import { RedisModule } from './redis/redis.module'
 
 @Module({
-  imports: [ConfigModule.forRoot({ isGlobal: true }), GeminiModule, BattlesModule, OauthModule, MetricsModule],
+  imports: [ConfigModule.forRoot({ isGlobal: true }), RedisModule, GeminiModule, BattlesModule, OauthModule, MetricsModule],
   controllers: [AppController],
   providers: [AppService],
 })

backend/src/redis/redis.const.ts

@@ -0,0 +1 @@
+export const REDIS_CLIENT = 'REDIS_CLIENT'

backend/src/redis/redis.module.ts

@@ -0,0 +1,34 @@
+import { Module, Global } from '@nestjs/common'
+import { ConfigService } from '@nestjs/config'
+import Redis from 'ioredis'
+import { RedisRepository } from './redis.repository'
+import { REDIS_CLIENT } from './redis.const'
+
+@Global()
+@Module({
+  providers: [
+    {
+      provide: REDIS_CLIENT,
+      inject: [ConfigService],
+      useFactory: (configService: ConfigService) => {
+        return new Redis({
+          host: configService.get<string>('REDIS_HOST') || 'localhost',
+          port: configService.get<number>('REDIS_PORT') || 6379,
+          retryStrategy: times => {
+            const MAX_RETRIES = 10
+            const DELAY = 3000
+
+            if (times > MAX_RETRIES) {
+              return null
+            }
+
+            return DELAY
+          },
+        })
+      },
+    },
+    RedisRepository,
+  ],
+  exports: [RedisRepository],
+})
+export class RedisModule {}

backend/src/redis/redis.repository.ts

@@ -0,0 +1,77 @@
+import { Injectable, Inject, OnModuleDestroy, Logger } from '@nestjs/common'
+import Redis from 'ioredis'
+import { REDIS_CLIENT } from './redis.const'
+@Injectable()
+export class RedisRepository implements OnModuleDestroy {
+  private readonly logger = new Logger(RedisRepository.name)
+
+  constructor(@Inject(REDIS_CLIENT) private readonly redisClient: Redis) {
+    this.bindEvents()
+  }
+
+  private bindEvents() {
+    this.redisClient.on('connect', () => {
+      this.logger.log('🚀 Redis connection established')
+    })
+
+    this.redisClient.on('ready', () => {
+      this.logger.log('✅ Redis client ready to use')
+    })
+
+    this.redisClient.on('error', err => {
+      this.logger.error(`❌ Redis Error: ${err.message}`, err.stack)
+    })
+
+    this.redisClient.on('close', () => {
+      this.logger.warn('⚠️ Redis connection closed')
+    })
+  }
+
+  async onModuleDestroy() {
+    await this.redisClient.quit()
+  }
+
+  async get(key: string): Promise<string | null> {
+    return this.redisClient.get(key)
+  }
+
+  async set(key: string, value: string, ttl?: number): Promise<'OK'> {
+    if (ttl) {
+      return this.redisClient.setex(key, ttl, value)
+    }
+    return this.redisClient.set(key, value)
+  }
+
+  async del(key: string): Promise<number> {
+    return this.redisClient.del(key)
+  }
+
+  async exists(key: string): Promise<boolean> {
+    const result = await this.redisClient.exists(key)
+    return result === 1
+  }
+
+  async hset(key: string, field: string, value: string): Promise<number> {
+    return this.redisClient.hset(key, field, value)
+  }
+
+  async hget(key: string, field: string): Promise<string | null> {
+    return this.redisClient.hget(key, field)
+  }
+
+  async hgetall(key: string): Promise<Record<string, string>> {
+    return this.redisClient.hgetall(key)
+  }
+
+  async lpush(key: string, ...values: string[]): Promise<number> {
+    return this.redisClient.lpush(key, ...values)
+  }
+
+  async lrange(key: string, start: number, stop: number): Promise<string[]> {
+    return this.redisClient.lrange(key, start, stop)
+  }
+
+  getRedisClient(): Redis {
+    return this.redisClient
+  }
+}

docker-compose-prod.yml

@@ -19,6 +19,9 @@ services:
     ports:
       - "3000:3000"
     restart: unless-stopped
+    depends_on:
+      redis:
+        condition: service_healthy
 
   prometheus:
     image: prom/prometheus:latest
@@ -62,4 +65,21 @@ services:
       - "80:80"
     depends_on:
       - backend
-    restart: unless-stopped
+    restart: unless-stopped
+
+  redis:
+    image: redis:alpine
+    command: redis-server --appendonly yes
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis-data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    restart: unless-stopped
+
+volumes:
+  redis-data: