Redisチートシート(設定編)

# 設定ファイルに 「port 6380」 と書くのと同じ
$ redis-server --port 6380

# 他のconfigファイルを読み込む
include path/to/other_config.conf

# デーモン化 yes/no
daemonize no

# デーモン化する場合のPIDファイルのパスを指定
pidfile /var/run/redis.pid

# DB数を設定する
databases 2

# ポートを指定
port 6379

# クライアントを限定する
bind 127.0.0.1

# タイムアウトを設定する(sec, 0の場合無効)
timeout 0

# TCPのKeepAlive機能を設定する(sec)
tcp-keepalive 0

# ログレベルを設定する(debug < verbose < notice < warning)
loglevel notice

# ログファイルを指定する(未設定時はSTDOUT)
logfile ''

# syslogを使う
syslog-enabled no

# syslogのIDを設定する
syslog-ident redis

# syslogのファシリティ(分類)を設定する(local0~local7)
syslog-facility local0

# ディスクへの保存条件
# ex. 900秒のうち、1つでもキーが更新されたら保存する
# saveは時間別に復数設定できる
save 900 1

# .rdbファイルの名前を指定する
dbfilename dump.rdb

# .rdbを圧縮する
rdbcompression yes

# .rdbにチェックサムを付ける
rdbchecksum yes

# .rdbを書き込むディレクトリを指定する
dir ./

# 最大接続数を設定(10000はデフォルト)
maxclients 10000

# メモリの利用可能容量を設定
# 1k => 1000 bytes
# 1kb => 1024 bytes
# 1m => 1000000 bytes
# 1mb => 1024*1024 bytes
# 1g => 1000000000 bytes
# 1gb => 1024*1024*1024 bytes
maxmemory 4g


# メモリポリシを設定
# Redisがメモリを使い果たした際の挙動を設定する
#   volatile-lru      -> 期限切れのキーを、LRUに基づいて削除する
#   allkeys-lru       -> 全てのキーを、LRUに基づいて削除する
#   volatile-random   -> 期限切れのキーを、ランダムに削除する
#   allkeys-random    -> 全てのキーを、ランダムに削除する
#   volatile-ttl      -> TTLの小さい順にキーを削除する
#   noeviction        -> 書き込み時にエラーを返すようにする
maxmemory-policy noeviction


# volatile-ttlの場合のサンプリング頻度を設定する
# 小さいほど負荷は増すが厳密になる
maxmemory-samples 5

bind 127.0.0.1
maxclients 3

requirepass <パスワード平文>

> GET 'foo'
=> (error) NOAUTH Authentication required.

> auth bad_password
=> (error) ERR invalid password

> auth good_password
=> OK

# CONFIGコマンドを使えなくする
rename-command CONFIG ''

# CONFIGコマンドを、知っていないと使えない名前にする
rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52

# AOF有効
appendonly yes

# AOFファイル名を指定
appendfilename "appendonly.aof"

# AOF追加時のflah()システムコールの利用可否を設定する
# no        : fsyncしない。速い
# always    : AOFの書き込みごとに毎回fsyncする。遅いが安全
# everysec  : 1秒ごとにfsyncする。妥協
# よくわからない場合はeverysecにしておけ、とのこと
#
appendfsync everysec

# マスタを指定
# SLAVEOFコマンドで代替可能
slaveof 127.0.0.1 6379

# Read-only状態を指定
slave-read-only yes

masterauth some_plain_password

$ redis-sentinel path/to/redis-sentinel.conf

# あるいはredis-serverのオプションで指定する
$ redis-server path/to/redis-sentinel.conf --sentinel

# ポートを指定
port 26379

# グループAを定義
# 指定のIP/ポートで接続し、2台のセンチネルが障害を観測した時点でフェールオーバする
sentinel monitor groupA 192.168.0.10 6379 2

# sentinelへの接続用のパスを設定
# requirepassの設定が優先される様子
sentinel auth-pass groupA some_password

# 障害発生とみなすためのタイムアウト時間を60,000msecに設定
sentinel down-after-milliseconds groupA 60000

# フェイルオーバー失敗時の再試行までの時間を180,000msecに設定
sentinel failover-timeout groupA 180000

# フェイルオーバー時に接続するスレーブの数
# この数は少ないほど、フェイルオーバーに時間がかかる
sentinel parallel-syncs groupA 1

# センチネルに接続する
$ redis-cli -p 26379

# groupAのマスタの情報を問い合せ
> SENTINEL master groupA
=> 1) "name"
=> 2) "groupA"
=> 3) "ip"
=> 4) "127.0.0.1"
=> 5) "port"
=> 6) "6379"
=> ...

# IPとポートのみ問い合わせ
> SENTINEL get-master-addr-by-name groupA
=> 1) "127.0.0.1"
=> 2) "6379"

# 同様にスレーブの一覧を問い合せ
> SENTINEL slaves groupA

# 監視しているセンチネルの一覧を問い合わせ
> SENTINEL sentinels groupA


# フェールオーバーをテストしたい場合はDEBUGを使う
> DEBUG sleep 30

# 強制フェールオーバーもできる
> SENTINEL failover groupA