Linux 패키지를 사용해 독립 실행형 Redis 서버를 구성할 수 있습니다. 이 구성에서 Redis는 확장되지 않으며 단일 장애 지점이 됩니다. 다만 확장된 환경의 목적은 더 많은 사용자를 처리하거나 처리량을 높이는 데 있습니다. Redis 자체는 대체로 안정적이고 많은 요청을 처리할 수 있으므로, 인스턴스를 하나만 두는 것은 받아들일 만한 절충안입니다. GitLab 확장 옵션에 대한 개요는 참조 아키텍처 페이지를 참고합니다.

독립 실행형 Redis 인스턴스 설정#

다음 단계는 Linux 패키지로 Redis 서버를 구성하는 데 필요한 최소 절차입니다.

1. Redis 서버에 SSH로 접속합니다.

2. GitLab 다운로드 페이지의 1단계와 2단계를 따라 원하는 Linux 패키지를 다운로드해 설치합니다. 다운로드 페이지의 다른 단계는 수행하지 않습니다.

3. /etc/gitlab/gitlab.rb를 편집해 다음 내용을 추가합니다.

   ## Enable Redis and disable all other services
   ## https://docs.gitlab.com/omnibus/roles/
   roles ['redis_master_role']
   
   ## Redis configuration
   redis['bind'] = '0.0.0.0'
   redis['port'] = 6379
   redis['password'] = '<redis_password>'
   
   ## Disable automatic database migrations
   ## Only the primary GitLab application server should handle migrations
   gitlab_rails['auto_migrate'] = false
   

4. 변경 사항을 적용하려면 GitLab을 재구성합니다.

5. Redis 노드의 IP 주소 또는 호스트 이름, 포트, Redis 비밀번호를 기록해 둡니다. GitLab 애플리케이션 서버를 구성할 때 필요합니다.

고급 구성 옵션도 지원되며 필요하면 추가할 수 있습니다.

GitLab Rails 애플리케이션 인스턴스 설정#

GitLab 이 설치된 인스턴스에서 다음을 수행합니다.

1. /etc/gitlab/gitlab.rb 파일을 편집해 다음 내용을 추가합니다.

   ## Disable Redis
   redis['enable'] = false
   
   gitlab_rails['redis_host'] = 'redis.example.com'
   gitlab_rails['redis_port'] = 6379
   
   ## Required if Redis authentication is configured on the Redis node
   gitlab_rails['redis_password'] = '<redis_password>'
   

2. 변경 사항을 /etc/gitlab/gitlab.rb에 저장합니다.

3. 변경 사항을 적용하려면 GitLab을 재구성합니다.

Redis 대신 Valkey 사용#

Valkey를 Redis의 대체제로 그대로 사용할 수 있습니다. Valkey는 Redis와 동일한 구성 옵션을 사용합니다.

독립 실행형 노드에서 Redis 대신 Valkey를 사용하려면 다음을 수행합니다.

1. /etc/gitlab/gitlab.rb를 편집해 다음 내용을 추가합니다.

   ## Enable Redis and disable all other services
   ## https://docs.gitlab.com/omnibus/roles/
   roles ['redis_master_role']
   
   ## Switch to Valkey
   redis['backend'] = 'valkey'
   
   ## Redis configuration
   redis['bind'] = '0.0.0.0'
   redis['port'] = 6379
   redis['password'] = '<redis_password>'
   
   ## Disable automatic database migrations
   gitlab_rails['auto_migrate'] = false
   

2. 변경 사항을 적용하려면 GitLab을 재구성합니다.

GitLab Rails 애플리케이션 구성은 동일하게 유지됩니다. gitlab_rails['redis_host'], gitlab_rails['redis_port'], gitlab_rails['redis_password']를 Redis와 같은 방식으로 구성합니다.

알려진 문제#

• 알려진 이슈 589642 때문에 Admin Area에 Valkey 버전이 잘못 표시됩니다. 이 이슈는 설치된 Valkey 버전이나 동작에는 영향을 주지 않습니다.

문제 해결#

Redis 문제 해결 가이드를 참고합니다.