Commit c76ff8cf authored by Gabriel Mazetto's avatar Gabriel Mazetto

Improved redis sentinel documentation for CE

parent a6b49757
No related merge requests found
...@@ -143,6 +143,7 @@ the master, and `masterauth` in slaves. ...@@ -143,6 +143,7 @@ the master, and `masterauth` in slaves.
redis['port'] = 6379 redis['port'] = 6379
## Slave redis instance ## Slave redis instance
redis['master'] = false
redis['master_ip'] = '10.10.10.10' # IP of master Redis server redis['master_ip'] = '10.10.10.10' # IP of master Redis server
redis['master_port'] = 6379 # Port of master Redis server redis['master_port'] = 6379 # Port of master Redis server
redis['master_password'] = "<huge password string here>" redis['master_password'] = "<huge password string here>"
...@@ -157,31 +158,19 @@ servers. ...@@ -157,31 +158,19 @@ servers.
### Sentinel setup ### Sentinel setup
We don't provide yet an automated way to setup and run the Sentinel daemon We provide an automated way to setup and run the Sentinel daemon
from Omnibus installation method. You must follow the instructions below and with GitLab EE.
run it by yourself.
The support for Sentinel in Ruby has some [caveats](https://github.com/redis/redis-rb/issues/531). See the instructions below how to setup it by yourself.
While you can give any name for the `master-group-name` part of the
configuration, as in this example:
```conf
sentinel monitor <master-group-name> <ip> <port> <quorum>
```
,for it to work in Ruby, you have to use the "hostname" of the master Redis
server, otherwise you will get an error message like:
`Redis::CannotConnectError: No sentinels available.`. Read
[Sentinel troubleshooting](#sentinel-troubleshooting) for more information.
Here is an example configuration file (`sentinel.conf`) for a Sentinel node: Here is an example configuration file (`sentinel.conf`) for a Sentinel node:
```conf ```conf
port 26379 port 26379
sentinel monitor master-redis.example.com 10.10.10.10 6379 1 sentinel monitor gitlab-redis 10.0.0.1 6379 1
sentinel down-after-milliseconds master-redis.example.com 10000 sentinel down-after-milliseconds gitlab-redis 10000
sentinel config-epoch master-redis.example.com 0 sentinel config-epoch gitlab-redis 0
sentinel leader-epoch master-redis.example.com 0 sentinel leader-epoch gitlab-redis 0
``` ```
--- ---
...@@ -213,10 +202,11 @@ The following steps should be performed in the [GitLab application server](gitla ...@@ -213,10 +202,11 @@ The following steps should be performed in the [GitLab application server](gitla
1. Edit `/etc/gitlab/gitlab.rb` and add/change the following lines: 1. Edit `/etc/gitlab/gitlab.rb` and add/change the following lines:
```ruby ```ruby
gitlab-rails['redis_host'] = "master-redis.example.com" redis['master_name'] = "gitlab-redis"
gitlab-rails['redis_port'] = 6379 redis['master_ip'] = "10.0.0.1"
gitlab-rails['redis_password'] = '<huge password string here>' redis['master_port'] = 6379
gitlab-rails['redis_sentinels'] = [ redis['master_password'] = '<huge password string here>'
gitlab_rails['redis_sentinels'] = [
{'host' => '10.10.10.1', 'port' => 26379}, {'host' => '10.10.10.1', 'port' => 26379},
{'host' => '10.10.10.2', 'port' => 26379}, {'host' => '10.10.10.2', 'port' => 26379},
{'host' => '10.10.10.3', 'port' => 26379} {'host' => '10.10.10.3', 'port' => 26379}
...@@ -229,33 +219,33 @@ The following steps should be performed in the [GitLab application server](gitla ...@@ -229,33 +219,33 @@ The following steps should be performed in the [GitLab application server](gitla
If you get an error like: `Redis::CannotConnectError: No sentinels available.`, If you get an error like: `Redis::CannotConnectError: No sentinels available.`,
there may be something wrong with your configuration files or it can be related there may be something wrong with your configuration files or it can be related
to [this issue][gh-531] ([pull request][gh-534] that should make things better). to [this issue][gh-531].
It's a bit rigid the way you have to config `resque.yml` and `sentinel.conf`, It's a bit non-intuitive the way you have to config `resque.yml` and
otherwise `redis-rb` will not work properly. `sentinel.conf`, otherwise `redis-rb` will not work properly.
The hostname ('my-primary-redis') of the primary Redis server (`sentinel.conf`) The `master-group-name` ('gitlab-redis') defined in (`sentinel.conf`)
**must** match the one configured in GitLab (`resque.yml` for source installations **must** be used as the hostname in GitLab (`resque.yml` for source installations
or `gitlab-rails['redis_*']` in Omnibus) and it must be valid ex: or `gitlab-rails['redis_*']` in Omnibus):
```conf ```conf
# sentinel.conf: # sentinel.conf:
sentinel monitor my-primary-redis 10.10.10.10 6379 1 sentinel monitor gitlab-redis 10.10.10.10 6379 1
sentinel down-after-milliseconds my-primary-redis 10000 sentinel down-after-milliseconds gitlab-redis 10000
sentinel config-epoch my-primary-redis 0 sentinel config-epoch gitlab-redis 0
sentinel leader-epoch my-primary-redis 0 sentinel leader-epoch gitlab-redis 0
``` ```
```yaml ```yaml
# resque.yaml # resque.yaml
production: production:
url: redis://my-primary-redis:6378 url: redis://:myredispassword@gitlab-redis/
sentinels: sentinels:
- -
host: slave1 host: slave1.example.com # or use ip
port: 26380 # point to sentinel, not to redis port port: 26380 # point to sentinel, not to redis port
- -
host: slave2 host: slave2.exampl.com # or use ip
port: 26381 # point to sentinel, not to redis port port: 26381 # point to sentinel, not to redis port
``` ```
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment