백엔드 개발 일지

백엔드 개발에서 세션 관리는 사용자 경험을 향상시키고 서버의 성능을 최적화하는 데 중요한 역할을 합니다. 오늘은 Redis를 활용하여 세션 스토리지를 구축하는 방법에 대해 단계별로 알아보겠습니다. Redis는 인메모리 데이터 구조 저장소로, 빠른 속도와 유연성 덕분에 세션 관리에 적합한 솔루션입니다.

1. Redis 설치

먼저 Redis 서버를 설치해야 합니다. Redis는 다양한 플랫폼에서 사용할 수 있으며, 설치 방법은 다음과 같습니다.

macOS

Homebrew를 사용하는 경우 다음 명령어로 설치할 수 있습니다.

brew install redis

Ubuntu

Ubuntu에서는 다음 명령어를 사용하여 설치할 수 있습니다.

sudo apt update
sudo apt install redis-server

설치가 완료되면 Redis 서버를 시작합니다.

redis-server

2. 프로젝트 설정

이제 Redis를 사용할 백엔드 프로젝트를 설정해보겠습니다. Node.js와 Express를 사용하는 예시로 진행하겠습니다.

2.1. 프로젝트 초기화

새로운 Node.js 프로젝트를 생성하고 필요한 패키지를 설치합니다.

mkdir redis-session-example
cd redis-session-example
npm init -y
npm install express express-session connect-redis redis

2.2. 기본 서버 설정

아래와 같이 server.js 파일을 생성하고 기본 Express 서버를 설정합니다.

const express = require('express');
const session = require('express-session');
const RedisStore = require('connect-redis')(session);
const redis = require('redis');

const app = express();
const PORT = process.env.PORT || 3000;

// Redis 클라이언트 생성
const redisClient = redis.createClient();

// Redis 세션 스토어 설정
app.use(session({
  store: new RedisStore({ client: redisClient }),
  secret: 'your_secret_key',  // 비밀 키
  resave: false,
  saveUninitialized: false,
  cookie: { secure: false } // HTTPS를 사용하는 경우 true로 설정
}));

app.get('/', (req, res) => {
  // 세션 데이터 설정
  if (!req.session.views) {
    req.session.views = 1;
  } else {
    req.session.views++;
  }
  res.send(총 ${req.session.views} 번 방문하였습니다.);
});

app.listen(PORT, () => {
  console.log(서버가 ${PORT}번 포트에서 실행 중입니다.);
});

3. Redis 세션 스토리지 구성

위 코드에서는 Express 애플리케이션에서 Redis를 사용하여 세션을 저장하도록 설정했습니다. connect-redis를 사용하여 Express의 세션 스토어를 Redis로 지정했습니다.

3.1. 세션 데이터 사용

위에서 설정한 / 엔드포인트는 사용자가 페이지를 방문할 때마다 세션에 저장된 views 값을 증가시킵니다. 이 값은 사용자별 방문 횟수를 추적하는 데 사용됩니다.

4. Redis 클라이언트 설정

Redis 클라이언트는 기본적으로 localhost에서 실행됩니다. 만약 Redis가 다른 서버에서 실행되거나 비밀번호가 설정된 경우, 다음과 같이 연결 옵션을 지정해야 합니다.

const redisClient = redis.createClient({
  host: 'your_redis_host',
  port: 6379,
  password: 'your_redis_password'
});

5. 세션 데이터 확인

Redis에 저장된 세션 데이터를 확인하려면 Redis CLI를 사용할 수 있습니다. 터미널에서 Redis CLI에 접속한 후, 아래 명령어로 세션 데이터를 조회할 수 있습니다.

redis-cli
GET session:<session_id>

여기서 <session_id>는 사용자의 세션 ID로, 브라우저의 쿠키에서 확인할 수 있습니다.

6. 프로덕션 환경 설정

프로덕션 환경에서는 다음과 같은 추가적인 설정이 필요합니다.

보안: cookie.secure를 true로 설정하여 HTTPS를 사용할 때만 세션 쿠키가 전송되도록 합니다.
세션 만료: cookie.maxAge를 설정하여 세션의 만료 시간을 설정합니다.
Redis 클러스터: 데이터의 복잡성을 줄이기 위해 Redis 클러스터를 구성할 수 있습니다.

마무리

이 글에서는 Redis를 사용하여 세션 스토리지를 구축하는 방법에 대해 알아보았습니다. Redis는 빠르고 효율적인 세션 관리를 가능하게 하여 웹 애플리케이션의 성능을 향상시킵니다. 위 단계를 따른다면, 간단하게 세션 관리 시스템을 구축할 수 있습니다. Redis를 통해 더 나은 사용자 경험을 제공하는 백엔드 시스템을 만들어보세요!

Redis로 세션 스토리지 구축하기 – 단계별 튜토리얼