[DB] Redis 설치하기 (MacOS)

로컬 환경에 설치하기

💡Homebrew를 이용해 Redis 설치

 

1. Homebrew를 설치한 적 없다면, Homebrew 먼저 설치

• Homebrew 설치 페이지 : https://brew.sh/

Homebrew

• Homebrew 설치 명령어

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

 

2. Homebrew를 이용해 Redis를 설치

• 아래 명령어를 터미널에 입력

brew install redis

 

3. 백그라운드에서 Redis 실행

brew services start redis

---

Docker에 설치하기 (권장)

💡Docker 사용을 권장하는 이유

• 컨테이너화된 환경을 제공함으로써 OS 차이, 라이브러리 버전 차이 등으로 인한 오류를 예방할 수 있다.

💡docker-compose.yml 이 필요한 이유

• 여러 개의 컨테이너로 구성된 애플리케이션을 YAML 파일로 정의하고 한 번의 명령어로 실행할 수 있게 해준다.

💡Docker 이용해 Redis 설치하기

• Docker가 설치되어 있다면 명령어 하나로 Redis를 실행해볼 수 있다.

• redis : Redis의 기본(Core) 서버 이미지로, 가장 표준적인 Redis 기능만 포함된 최소 구성 버전입니다. 단순 캐시·세션·Pub/Sub 등 기본 기능 실습에 적합
• redis/redis-stack-server : 기본 Redis에 Redis Stack 모듈(ex. JSON, Search, Bloom, TimeSeries 등)이 포함된 서버 이미지이다. JSON 문서 저장, 전문 검색, 확률형 자료구조 등을 사용할 때 선택한다.
• redis/redis-stack : redis/redis-stack-server에 Redis Insight(웹 기반 관리 GUI)가 추가된 통합 이미지이다. 서버 기능과 함께 시각적 관리 도구까지 함께 사용하려는 경우 적합하다.
• Docker Hub에서 Redis를 찾아보면 세가지 이미지가 상단에 나오게 되는데, 이중 한가지를 선택해서 사용할 수 있다.

❗️Docker Hub 란?

컨테이너 이미지를 저장하고(push) 검색하고 다운로드(pull) 할 수 있는 공식 이미지 레지스트리(registry) 서비스이다.

컨테이너(Container) : 이미지를 실행한 인스턴스로, 격리된 환경에서 애플리케이션이 동작하는 실행 단위
이미지(Image) : 컨테이너를 생성하기 위한 실행 파일과 라이브러리, 설정을 포함한 불변 템플릿
레지스트리(Registry) : Docker 이미지를 저장·관리하고 네트워크를 통해 배포하는 저장소 시스템
도커 허브(Docker Hub) : 컨테이너 이미지를 저장하고 공유하는 Docker 공식 public registry

 

💡Run Redis Stack on Docker (공식 문서)

• Redis 공식 문서에 Docker 를 통해 Redis Stack 이미지를 다운 받는 방법이 안내되어있다.

1. 프로젝트 루트에 docker-compose.yml 을 생성한다.

services:
  redis-stack:
    image: redis/redis-stack
    container_name: redis-stack-compose
    restart: always
    environment:
      REDIS_ARGS: "--requirepass systempass"
    ports:
      - 6379:6379
      - 8001:8001

• 위 예시의 systempass가 비밀번호의 역할을 한다. 이 부분을 수정하면 접속할 때 비밀번호가 바뀌니 주의!

2. docker-compose.yml 이 있는 폴더에서 터미널은 열어 아래 명령어를 실행한다.

docker compose up -d

• 자동으로 최신 버전의 Redis Stack 이미지를 사용하게 된다.

3. Redis 컨테이너가 정상적으로 실행되었는지 확인한다.

docker compose ps

• Up 3 minutes : 컨테이너 프로세스가 살아 있음을 의미

---

Intellij IDEA UE에서 연결해보기

1. Database 탭을 찾아 클릭

 

2. + 를 누른 다음, Data Source > Redis를 찾아거나, 검색을 통해 Data Source를 선택한 다음, Redis를 입력하면 쉽게 찾을 수 있다.

 

3. 자신의 Redis 인스턴스의 Host와 Port(위의 과정을 따랐다면 localhost, 6379)를, 이후 User는 default, Password는 로컬에 설치한 경우 생략, Docker로 설치한 경우 자신이 password에 넣은 값을 넣어준다.

 

4. 이후 Test Connection을 클릭해서 잘 연결되면, OK를 누른다.

 

5. console 탭에서 명령어들을 사용해서 데이터를 가져올 수 있다.

• 명령어 예시 (Command + Enter 로 명령어 한 줄 씩 실행 가능)

SET start "hello world"
GET start

• console 탭 예시

• 명령어를 통해 가져온 데이터

❗️console 탭이 사라지면 Database 탭에서 다시 열 수 있다

---

Redis Insight를 이용해 연결해보기

💡Redis Insight 란?

• Redis 전용 IDE (ex. MySQL Workbench)
• 간단한 기능 테스트만 할 때는 엄청 필요한 도구는 아닐 수 있다.

💡App Store 에서 설치하기

• MacOS의 경우 App Store 에 등록된 Redis Insight 를 다운로드 가능하다.

💡Docker 로 설치하기

 

1. 위에 소개된 docker-compose.yml 를 사용한 경우, Redis Insight 도 같이 설치된다.

services:
  redis-stack:
    image: redis/redis-stack
    container_name: redis-stack-compose
    restart: always
    environment:
      REDIS_ARGS: "--requirepass systempass"
    ports:
      - 6379:6379
      - 8001:8001

• redis/redis-stack : 이 이미지는 Redis 서버 + Redis Stack 모듈 + Redis Insight까지 포함된 통합 이미지이다.

2. 따라서 바로 localhost:8001 로 들어가면, 웹 애플리케이션으로 확인 가능하다.

 

3. Username 과 Password를 입력 후 Test Connection 을 진행한다.

• Connection이 성공했다면, Apply Changes 클릭하면 왼쪽 메뉴 바에 새로운 기능들이 활성화 된다.

---

참고 자료

https://teamsparta.notion.site/1-2-Redis-2242dc3ef51481d0b7a7d2f163d2df05

챕터1-2 : Redis 설치하기 | Notion