빠른 시작

빠른 시작 (Quick Start)

Redis를 처음 시작할 때는 "일단 서버를 띄워 놓고, 뭔가 저장하고 꺼내 보는 것"까지를 빠르게 해 보는 게 좋아요. 이 가이드는 Redis를 설치하고, redis-cli로 연결해 첫 명령을 실행해 보는 것까지를 최소한의 길로 안내할게요.

출처: 공식문서

⚠️ 확인 필요: 원문이 위치했던 URL(/docs/latest/develop/quick-start/)이 현재 Redis 공식 문서 사이트에서 더 이상 응답하지 않아요(404). 아래 내용은 Redis 공식 "시작하기(Get started)" 가이드 및 "Redis 개발 시작하기(Get started with Redis)" 안내에 실제로 존재하는 설치·연결·첫 명령 내용을 바탕으로 정리했어요. 번역 전 최신 URL을 확인해 보시길 권합니다.

Redis 설치하기 (Install Redis)

로컬에서 Redis를 바로 써 보는 가장 빠른 방법은 Docker예요. 아래 명령은 redis-server를 포트 6379로, Redis Insight를 포트 8001로 노출합니다:

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

서버를 시작하면 데이터베이스는 별도의 생성 단계 없이 바로 만들어져요. redis-server가 실행되면 기본적으로 6379 포트에서 대기합니다. Docker를 쓰지 않는다면 Linux, macOS, 또는 소스에서 Redis를 설치하는 방법을 참고해도 됩니다.

redis-cli로 연결하기 (Connect with redis-cli)

연결은 redis-cli로 가장 간단하게 해볼 수 있어요. 로컬 기본 서버라면 인자 없이 실행해도 되고, 호스트와 포트를 명시할 수도 있습니다:

# 1) 기본: localhost:6379
$ redis-cli

# 2) 호스트와 포트를 명시
$ redis-cli -h host -p port

비밀번호가 있는 서버라면 -a <password>를 쓰거나 REDISCLI_AUTH 환경 변수를 설정하면 돼요. 연결되면 127.0.0.1:6379> 같은 프롬프트가 보입니다.

$ redis-cli
127.0.0.1:6379> PING
PONG

PING에 PONG이 응답으로 돌아오면, 연결이 성공한 거예요.

첫 데이터 저장·조회 (First SET and GET)

Redis의 가장 기본적인 두 명령은 SET(저장)와 GET(조회)이에요. 다른 DB처럼 스키마나 별도 데이터 로드 단계는 필요 없어요. SET과 GET 명령이 데이터를 바로 만들고 읽어 줍니다:

127.0.0.1:6379> SET foo bar
OK
127.0.0.1:6379> GET foo
"bar"

SET foo bar는 키 foo에 값 bar를 저장하고 OK를 돌려줍니다. GET foo는 저장된 값을 꺼내와요. 여기까지 되면 Redis에 데이터를 쓰고 읽는 기본 흐름을 잡은 겁니다.

삭제는 DEL로, 만료 시간을 붙여 저장하려면 SET에 초 단위로 EX 옵션을 붙입니다:

127.0.0.1:6379> SET session abc123 EX 60
OK
127.0.0.1:6379> DEL session
(integer) 1

이상으로 Redis를 띄우고, 연결하고, 첫 데이터를 저장·조회·삭제하는 빠른 시작을 마무리했어요. 다음 단계로는 언어별 클라이언트로 같은 흐름을 구현해 보면 좋습니다.

Redis Insight로 연결하기 (Connect with Redis Insight)

명령줄보다 GUI가 편하다면 Redis Insight를 쓸 수 있어요. Redis Insight는 데이터를 시각화하고 명령을 실행할 수 있는 무료 GUI 도구입니다. 브라우저에서 Docker로 띄운 인스턴스라면 http://localhost:8001을 열어 연결 정보(호스트 localhost, 포트 6379)를 입력하면 됩니다. Workbench 탭에서 SET/GET 같은 명령을 실행해 볼 수 있어요.

더 알아보기 (Learn more)