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 사용#

Redis의 드롭인 대체제로 Valkey를 사용할 수 있습니다. 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 애플리케이션 구성은 동일합니다. Redis의 경우와 같이 gitlab_rails['redis_host'], gitlab_rails['redis_port'], gitlab_rails['redis_password']를 구성합니다.

알려진 이슈#

• 알려진 이슈 589642로 인해 관리자 영역에서 Valkey 버전이 잘못 보고됩니다. 이 이슈는 설치된 Valkey 버전이나 작동 방식에 영향을 미치지 않습니다.

문제 해결#

Redis 문제 해결 가이드를 참조하세요.