[Redis] Ubuntu 환경에서 Redis 설치 방법

설치 환경

• Ubuntu 20.04.6
• Intel N100 / Ram 8GB

참고 문서

• https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/

Install Redis on Linux

설치 방법

아래 설치 순서를 따라 Redis를 설치하기 위한 사전 준비를 합니다.

# 필수 패키지를 설치 합니다.
sudo apt-get install lsb-release curl gpg

# GPG 키를 다운로드하고, 파일로 변환하여 저장합니다.
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg

# GPG 키 파일에 읽기 권한을 설정합니다.
sudo chmod 644 /usr/share/keyrings/redis-archive-keyring.gpg

# APT 패키지 관리자의 소스 목록에 Redis URL을 추가 합니다.
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list

# 새로 추가된 Redis 저장소를 포함하여 패키지 목록을 업데이트 합니다.
sudo apt-get update

 

설치 가능한 Redis 버전을 확인하고, 설치하려는 버전을 선택합니다.

# 설치 가능한 Redis 버전 확인
apt list -a redis

# 선택한 버전으로 Redis 설치
sudo apt-get install redis=<version> redis-server=<version> redis-tools=<version>

# 6.0.20 설치
sudo apt-get install redis=6:6.0.20-1rl1~focal1 redis-server=6:6.0.20-1rl1~focal1 redis-tools=6:6.0.20-1rl1~focal1

 

버전을 지정하여 설치할 때는, redis 패키지 설치에 의존성을 가지는 redis-server, redis-tools 패키지의 버전을 함께 지정해야 합니다. 그렇지 않으면 아래와 같이 의존성 깨짐 문제가 발생합니다.

The following packages have unmet dependencies:
 redis-server : Depends: redis-tools (= 6:6.0.20-1rl1~focal1) but 6:7.4.1-1rl1~focal1 is to be installed
E: Unable to correct problems, you have held broken packages.

 

버전을 지정하지 않고 설치하려면 sudo apt-get install redis 명령을 사용하여 설치합니다.

설치를 완료하면 redis-server --version 명령어를 사용하여 설치를 확인합니다.

# 최신 버전으로 Redis 설치
sudo apt-get install redis

# Redis 설치 확인
redis-server --version

 

Redis가 정상 설치된 것을 확인 할 수 있습니다.

$ redis-server --version
Redis server v=6.0.20 sha=00000000:0 malloc=jemalloc-5.1.0 bits=64 build=75277ce672026dd0

 

설치 후 버전 자동 업데이트를 방지하기 위해 패키지를 고정(hold) 합니다.

버전이 고정 된 패키지는 apt upgrade, apt-get upgrade 명령어 실행 시 작업에서 제외 됩니다.

# Redis 패키지 버전 고정
sudo apt-mark hold redis redis-server redis-tools

# 고정된 패키지 확인
apt-mark showhold

 

아래와 같이 패키지 버전이 고정 된 것을 확인 할 수 있습니다.

$ sudo apt-mark hold redis redis-server redis-tools
redis set on hold.
redis-server set on hold.
redis-tools set on hold.

 

apt upgrade 명령어를 실행하여 버전이 업데이트 되지 않는지 확인합니다.

(주의) 명령을 실행하면 Ubuntu에 설치 된 다른 패키지가 모두 업데이트 됩니다.

# 패키지 업데이트
sudo apt upgrade

 

아래와 같이 Redis 패키지가 업데이트에서 제외 된 것을 확인 할 수 있습니다.

$ sudo apt upgrade
The following packages have been kept back:
  redis redis-server redis-tools

 

버전 고정 해제가 필요한 경우 sudo apt-mark unhold 명령어로 해제합니다.

# 패키지 버전 고정 해제
sudo apt-mark unhold redis redis-server redis-tools

 

버전을 고정하고 사용하기 위해 다시 sudo apt-mark hold 명령어를 실행합니다.

서비스 등록

운영 체제가 재시작 된 후에 Redis를 자동으로 시작하기 위해 서비스를 등록합니다.

# 시스템 부팅 시 자동 시작 설정
sudo systemctl enable redis-server

# 서비스 시작
sudo systemctl start redis-server

# 서비스 실행 상태 확인
sudo systemctl status redis-server

 

아래와 같이 서비스가 정상적으로 실행 된 것을 확인 할 수 있습니다.

$ sudo systemctl status redis-server
● redis-server.service - Advanced key-value store
     Loaded: loaded (/lib/systemd/system/redis-server.service; disabled; vendor preset: enabled)
     Active: active (running) since Tue 2024-12-17 12:48:44 UTC; 27min ago
       Docs: http://redis.io/documentation,
             man:redis-server(1)
   Main PID: 197643 (redis-server)
     Status: "Ready to accept connections"
      Tasks: 5 (limit: 9076)
     Memory: 2.6M
     CGroup: /system.slice/redis-server.service
             └─197643 /usr/bin/redis-server 127.0.0.1:6379

 

이제 Redis를 사용할 수 있습니다.

설치 결과

• Redis 6.0.20 버전 설치 (redis, redis-server, redis-tools 패키지)
• Redis 서비스 등록