Redis autonome utilisant le package Linux

{{< details >}}

• Niveau : Free, Premium, Ultimate
• Offre : GitLab Self-Managed

{{< /details >}}

Le package Linux peut être utilisé pour configurer un serveur Redis autonome. Dans cette configuration, Redis n'est pas mis à l'échelle et représente un point de défaillance unique. Cependant, dans un environnement mis à l'échelle, l'objectif est de permettre à l'environnement de gérer davantage d'utilisateurs ou d'augmenter le débit. Redis lui-même est généralement stable et peut gérer de nombreuses requêtes, ce qui en fait un compromis acceptable de n'avoir qu'une seule instance. Consultez la page architectures de référence pour une vue d'ensemble des options de mise à l'échelle de GitLab.

Configurer l'instance Redis autonome {#set-up-the-standalone-redis-instance}

Les étapes ci-dessous sont le minimum nécessaire pour configurer un serveur Redis avec le package Linux :

1. Connectez-vous en SSH au serveur Redis.

2. Téléchargez et installez le package Linux souhaité en suivant steps 1 and 2 de la page de téléchargement de GitLab. Ne suivez pas d'autres étapes sur la page de téléchargement.

3. Modifiez /etc/gitlab/gitlab.rb et ajoutez le contenu suivant :

   rubyCopy

   ## 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. Reconfigurez GitLab pour que les modifications prennent effet.

5. Notez l'adresse IP ou le nom d'hôte, le port et le mot de passe Redis du nœud Redis. Ces informations sont nécessaires lors de la configuration des serveurs d'application GitLab.

Les options de configuration avancées sont prises en charge et peuvent être ajoutées si nécessaire.

Configurer l'instance d'application GitLab Rails {#set-up-the-gitlab-rails-application-instance}

Sur l'instance où GitLab est installé :

1. Modifiez le fichier /etc/gitlab/gitlab.rb et ajoutez le contenu suivant :

   rubyCopy

   ## 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. Enregistrez vos modifications dans /etc/gitlab/gitlab.rb.

3. Reconfigurez GitLab pour que les modifications prennent effet.

Utiliser Valkey à la place de Redis {#use-valkey-instead-of-redis}

{{< history >}}

• Introduit dans GitLab 18.9 en tant que bêta.
• Disponible en version générale dans GitLab 19.0.

{{< /history >}}

Vous pouvez utiliser Valkey comme remplacement compatible de Redis. Valkey utilise les mêmes options de configuration que Redis.

Pour utiliser Valkey à la place de Redis sur un nœud autonome :

1. Modifiez /etc/gitlab/gitlab.rb et ajoutez le contenu suivant :

   rubyCopy

   ## 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. Reconfigurez GitLab pour que les modifications prennent effet.

La configuration de l'application GitLab Rails reste la même. Configurez gitlab_rails['redis_host'], gitlab_rails['redis_port'] et gitlab_rails['redis_password'] comme vous le feriez pour Redis.

Problèmes connus {#known-issues}

• En raison du ticket 589642 connu, la zone d'administration signale incorrectement la version de Valkey. Ce ticket n'affecte pas la version de Valkey installée ni son fonctionnement.

Dépannage {#troubleshooting}

Consultez le guide de dépannage Redis.