Docker Redis 실행 & redis-cli 접속하기

Lui.Slki·2026년 2월 19일

Quick Tips

목록 보기
4/5

1) Docker Desktop 준비

  • docker run은 Docker 엔진이 켜져있어야 동작

2) Redis 컨테이너 실행

Redis 서버를 도커 컨테이너로 띄움

docker run -d --name going-redis -p 6379:6379 redis:7

--name going-redis : 컨테이너 이름 지정

-p 6379:6379 : 내 PC(host) 6379 → 컨테이너 6379 포트 연결

redis:7 : Redis 7 버전 이미지 사용 (버전 생략 가능)

3) 실행 확인

docker ps
  • going-redis 컨테이너가 Up
  • 포트도 매핑됨

→ 즉, 내 PC에서 localhost:6379 로 Redis 접근 가능한 상태

4) keys 명령 = redis-cli 안에서 처리할것

  • Bash 창에 바로 치면 리눅스 쉘 명령으로 실행하게 됨.

5) redis-cli 접속

컨테이너 안의 Redis CLI로 들어감

docker exec -it going-redis redis-cli

그러면 프롬프트가

127.0.0.1:6379>

로 바뀌고, 이제부터 Redis 명령이 동작

연결됐는지 확인하려면 PING 명령어 치면 PONG 이 옴. 귀여움

6) Redis 데이터(키) 확인

redis-cli 안에서

KEYS *
KEYS refreshToken*

했을때, 전체 키가 나옴 (현재 refreshToken)

  • Redis는 정상 동작 중
  • refreshToken 관련 데이터가 저장되어있음
  • 토큰값이 나오는건 아님

7) 토큰값을 확인하려면

TYPE refreshToken:test
  • test는 키데이터 명

  • string 일 때

GET refreshToken:test
  • hash 일 때
HGETALL refreshToken:test

자주 사용하는 도커 관리 명령

  • 컨테이너 로그
docker logs going-redis
  • 컨테이너 중지/시작
docker stop going-redis
docker start going-redis
  • 컨테이너 삭제
docker rm -f going-redis

추가 - 도커의 image란,

프로그램을 실행하기 위한 완제품 패키지(템플릿)

Redis를 예로 들면, Redis 서버를 실행하는 데 필요한 것들이 한 덩어리로 들어있는 설치본 + 실행환경

이미지(image) vs 컨테이너(container)

헷갈릴 수 있어서 정리하자면,

  • Image = 레시피가 포함된 틀
    • Redis가 어떻게 설치돼 있고, 어떤 파일들이 있고, 기본 실행 명령이 뭔지 정의된 템플릿
    • 한 번 다운받아두면 계속 재사용 가능
  • Container = 실제로 만들어진 제품(실행 중인 인스턴스)
    • 이미지를 실행(run) 해서 만들어진 실제 프로세스
    • 컨테이너를 여러 개 띄울 수도 있음(같은 이미지로 복제 가능)
docker run -d --name going-redis -p 6379:6379 redis

그래서 해당 명령어의 의미는

  1. redis 이미지가 로컬에 없으면 다운로드하고
  2. 그 이미지로 컨테이너(going-redis)를 하나 만들어서
  3. 실행한다

이미지에 포함되는 것

  • OS 파일 일부(최소한의 리눅스 기반)
  • Redis 실행 파일(redis-server, redis-cli)
  • 기본 설정 파일
  • 컨테이너가 시작될 때 뭘 실행할지에 대한 기본 명령(ENTRYPOINT/CMD)

그래서 내 컴퓨터에 Redis를 따로 설치하지 않아도 이미지 안에 다 들어있으니까 바로 실행 가능

이미지 확인/관리 명령

  • 내가 가진 이미지 목록 보기:
docker images
  • 지금 실행 중인 컨테이너 보기:
docker ps
  • redis 이미지가 정학히 어떤 태그인지 보기:
docker images redis

요약

이미지 = 실행 환경까지 포함된 프로그램 패키지(템플릿)

컨테이너 = 그 이미지를 실행해서 만들어진 실제 실행 중인 프로세스

0개의 댓글