Linuxパッケージを使用したスタンドアロンRedis

Linuxパッケージを使用して、スタンドアロンRedisサーバーを設定できます。この設定では、Redisはスケールされず、単一障害点となります。しかし、スケールされた環境では、より多くのユーザーを処理したり、スループットを向上させることが目的です。Redis自体は一般的に安定しており、多くのリクエストを処理できるため、単一のインスタンスのみとすることは許容できるトレードオフです。GitLabのスケーリングオプションの概要については、リファレンスアーキテクチャページを参照してください。

スタンドアロンのRedisインスタンスをセットアップする

LinuxパッケージでRedisサーバーを設定するには、以下の手順が最低限必要です。

1. RedisサーバーにSSHで接続します。

2. GitLabダウンロードページから、ダウンロードしてインストールしたいLinuxパッケージをsteps 1 and 2を使用して入手します。ダウンロードページの他の手順は完了しないでください。

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を使用することは、ベータ機能です。

スタンドアロンノードで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が原因で、管理者エリアはValkeyのバージョンを誤ってレポートします。このイシューは、インストールされているValkeyのバージョンやその機能には影響しません。

トラブルシューティング

Redisのトラブルシューティングガイドを参照してください。