クバネティス(Kubernetes) 環境で Redis-Sentinel Sidecarパターン構築実践ガイド ①

Sidecarパターンの概念

1つのポッド(Pod) に密接に結合した協働構造（2つのコンテナ(Container)/プロセス）を扱うためです。例えば、Webサーバー（メイン）コンテナ(Container)（例: Nginx, Node.js）の横にログ収集器やセキュリティプロキシ（サイドカー(Sidecar)）コンテナ(Container) を付ける必要があるときがあります。サイドカー(Sidecar) コンテナ(Container) はメインコンテナ(Container) に従属しているときに使います。つまりメインコンテナ(Container) がダウンすると、サイドカー(Sidecar) コンテナ(Container) が生きていても意味がないときに使います。

概念は少し異なり、Sentinel は Redis と別に運用するのが正しいですが（Redis を監視するため、同じポッド(Pod) に置いて一緒に落ちてはいけません。Sentinel は別ポッド(Pod) で構成するのが正しいです）、Redis-Sentinel 構成を3ポッド(Pod) で作らなければならない場合に試してみることができます。そして（幸い）Sentinel は CPU(1core) を平時は1〜2%使い、ピーク時でも5%以下で使い、メモリも約10MBしか使わないので Sidecarパターンで構成してみましょう。

1. Redis-Sentinel Sidecarパターン仕様書(YAML)

クバネティス(Kubernetes) で Redis-Sentinel Sidecarパターンをデプロイするときは設定(Config)、サービス(Service)、作成(StatefulSet) の役割を明確に分けて3つの YAML ファイルで管理します。

┌──────────────────────────────────────────────────────────┐ │ 1. redis-sentinel-sidecar-config.yaml (ConfigMap) │ │ : redis.conf, sentinel.conf, users.acl │ └──────────────────┬───────────────────────────────────────┘ │ [1段階: 設定の提供] ▼ ┌──────────────────────────────────────────────────────────┐ │ 2. redis-sentinel-sidecar-service.yaml (Service) │ │ : redis-sentinel-service, port, sentinel-port │ └──────────────────┬───────────────────────────────────────┘ │ [2段階: サービスの準備] ▼ ┌──────────────────────────────────────────────────────────┐ │ 3. redis-sentinel-sidecar-statefulset.yaml (StatefulSet) │ │ : Config, Service -> redis-sentinel-0~3 (3Pods) │ │ Persistent Volume Claim (PVC) │ └──────────────────────────────────────────────────────────┘ [3段階: Redis/Sentinel ポッド作成]

2. デプロイ順に沿ったファイル別の内容説明

🟢 [1段階] Redis-Sentinel Sidecarパターン設定: redis-sentinel-sidecar-config.yaml

種類(kind): ConfigMap
名前(metadata:name): redis-sentinel-sidecar-config
⚠️ 名前は小文字(a-z)、数字(0-9)、ハイフン(`-`)のみ使うよう厳密に制限します（大文字は使用不可）
ConfigMap 設定ファイルです。ここに設定した指示子で redis.conf、sentinel.conf ファイルを作ります。
既存の圧縮(tar) ファイルにデフォルトで含まれる redis.conf、sentinel.conf ファイルは使いません。
Redis インスタンス（ポッド(Pod)）ごとに異なる値が必要なら StatefulSet の command スクリプトで動的に設定できます。例) replica-priority 100, 110, 120

🧑‍💻 主な値の説明

bind * -::* # IP が動的に割り当てられ変更されるため、すべての IP を受けられるように設定します。
韓国インターネット振興院(KISA)［クラウド脆弱性点検ガイド］では、セキュリティ目的で bind 項目に IP を設定するよう求めます。 VM/物理サーバーではそれが正しいですが、クバネティス(Kubernetes) 環境では設定できません。
（公共/金融などプロジェクトでは監査委員に十分説明する必要があります）
protected-mode no # 'bind *' に設定しているため 'yes' にすると外部から接続できません。
セキュリティ違反に見えるかもしれませんが、クバネティス(Kubernetes) には独自のセキュリティがあるので、この設定でも問題ありません。
daemonize no # 'yes' にしてはいけません。
requirepass password # 💥password は必ず設定してください。サーバーや PC がインターネットに繋がっているなら、開発環境でも必ず password を設定してください。 Redis ハッキングは🕵️人（ハッカー）がするのではなく、💻 プログラムが24時間動き続けてハッキングします。 Password がなければ、開発用に数分だけ起動していてもすぐにハッキングされます。
詳しくはこちらを参照してください。 🔗 Redis Hacking
users.acl を設定した場合は 'requirepass' を設定しなくても大丈夫です。
masterauth password # 必ず設定してください。
replica-priority 100 # 📍Redis-0 100, Redis-1 110, Redis-2 120
statefulset.yaml の initContainer:command で動的に注入されます。
replica-announce-ip # 📍redis-0.redis-service...
statefulset.yaml の initContainer:command で動的に注入されます。
echo "replica-announce-ip redis-$INDEX.redis-service.default.svc.cluster.local" >> /data/redis.conf
users.acl: 66〜67行の設定です。Password('#0cbc...' 64桁) は別に設定する必要があります。
詳しくはこちらを参照してください。 🔗 ACL

💾 redis-sentinel-sidecar-config.yaml を表示 ▼

📄 redis-sentinel-sidecar-config.yaml

  1	apiVersion: v1
  2	kind: ConfigMap
  3	metadata:
  4	  name: redis-sentinel-sidecar-config
  5	data:
  6	  redis.conf: |
  7	    # Redis-8.8.2 configuration
  8	    # [NETWORK]
  9	    bind * -::*
 10	    protected-mode no
 11	    port 18504
 12	    tcp-keepalive 60
 13	    # [GENERAL]
 14	    daemonize no
 15	    pidfile /data/redis.pid
 16	    # notice / verbose / debug
 17	    loglevel notice
 18	    logfile /data/redis.log
 19	    always-show-logo yes
 20	    # locale-collate "ko_KR.UTF-8" -> Error: Failed to configure LOCALE for invalid locale name.
 21	    # [MEMORY MANAGEMENT]
 22	    maxmemory 700mb
 23	    # [SNAPSHOTTING]
 24	    dbfilename dump.rdb
 25	    rdb-del-sync-files yes
 26	    # [working directory]
 27	    dir /data
 28	    # [SECURITY]
 29	    requirepass redisgate
 30	    masterauth redisgate
 31	    enable-protected-configs yes
 32	    enable-debug-command yes
 33	    # 📍 ファイル作成が必要  
 34	    aclfile /data/users.acl
 35	    # [REPLICATION]
 36	    # 📍Redis-0 100, Redis-1 110, Redis-2 120
 37	    replica-priority 100                
 38	    repl-backlog-size 128mb
 39	    repl-diskless-sync yes
 40	    repl-diskless-sync-delay 3
 41	    repl-diskless-sync-max-replicas 0
 42	    repl-diskless-load on-empty-db
 43	    # [CLIENTS]
 44	    maxclients 10000
 45	    client-output-buffer-limit normal 0 0 0
 46	    client-output-buffer-limit replica 1gb 1gb 120
 47	    client-output-buffer-limit pubsub 128mb 64mb 60
 48	    # [APPEND ONLY MODE]
 49	    save ""
 50	    appendonly yes
 51	    appendfilename "aof"
 52	    appenddirname "aof"	
 53	    appendfsync everysec
 54	    no-appendfsync-on-rewrite yes
 55	    auto-aof-rewrite-percentage 200
 56	    auto-aof-rewrite-min-size 1gb
 57	    aof-use-rdb-preamble yes
 58	    aof-timestamp-enabled yes
 59	    # [SLOW LOG]
 60	    slowlog-log-slower-than 10000
 61	    slowlog-max-len 1024
 62	    # [LATENCY MONITOR]
 63	    # 10ms, 0 disable
 64	    latency-monitor-threshold 10		
 65	
 66	  users.acl: |
 67	    user default on sanitize-payload #0cbc79ebbac0552443521615124610ef12649d44d4550f16fc9edf5594624305 ~* &* +@all
 68	
 69	  sentinel.conf: |
 70	    bind * -::*
 71	    protected-mode no
 72	    port 28504
 73	    daemonize no
 74	    dir /data
 75	    loglevel notice
 76	    logfile /data/sentinel.log
 77	    pidfile /data/sentinel.pid
 78	    requirepass redisgate
 79	    #aclfile /data/sentinel-users.acl
 80	    sentinel auth-user mymaster default
 81	    sentinel auth-pass mymaster redisgate
 82	    sentinel sentinel-user default
 83	    sentinel sentinel-pass redisgate
 84	    sentinel resolve-hostnames yes
 85	    sentinel announce-hostnames yes
 86	    sentinel monitor mymaster redis-sentinel-0.redis-sentinel-service.default.svc.cluster.local 18504 2
 87	    sentinel down-after-milliseconds mymaster 3000
 88	    sentinel failover-timeout mymaster 60000
 89	    sentinel parallel-syncs mymaster 1

ここに示した値は RedisGate が100サイト以上にインストール/運用する際、90%以上適用した redis.conf 値です。 (maxmemory 値はデータサイズに合わせて調整してください)

💻 物理サーバー/VM の場合は、以下のいくつかの値を修正して使ってください。

bind 114.x.y.z 127.0.0.1 -::1 -> IP 指定
protected-mode yes
port -> default 💥6379 port はハッキングの主要ターゲットです。必ず別のポートを使ってください。
daemonize yes
dir /app/redis -> pidfile、logfile などもこの dir に置きます
aclfile /app/redis/users.acl -> ユーザー別に権限付与が可能: 使用推奨
#maxmemory <bytes> -> コメントアウト(default)
① Redis 専用サーバーの場合はシステムメモリの50%〜90%まで指定します
② メモリに余裕があるなら: システムメモリが16GBで Redis 使用メモリが1〜2GBなら（現実的には）無理に設定しなくてもよい
③ 💥 Redis がシステムメモリを使い切ると OS(Linux) が Redis プロセスを kill します。
# replica-announce-ip -> コメントアウト(default)

🟢 [2段階] サービス(Service) 設定: redis-sentinel-sidecar-service.yaml

種類(kind): Service
名前(metadata:name): redis-sentinel-service
⚠️ 名前は小文字(a-z)、数字(0-9)、ハイフン(`-`)のみ使うよう厳密に制限します（大文字は使用不可）
Service 設定ファイルです。ポッド(Pod) の IP が変わっても固定ドメイン名(FQDN:Full Qualified Domain Name) で個別 Redis にアクセスできるよう、あらかじめネットワーク住所録を作る役割です。

🧑‍💻 主な値の説明

clusterIP: None # 📍'None' に設定（個別ポッド(Pod) DNS 単独識別用）
port: 18504 # Redis ポート
port: 28504 # Sentinel ポート

💾 redis-sentinel-sidecar-service.yaml を表示 ▼

📄 redis-sentinel-sidecar-service.yaml

  1	apiVersion: v1
  2	kind: Service
  3	metadata:
  4	  name: redis-sentinel-service
  5	  labels:
  6	    app: redis-sentinel
  7	spec:
  8	  clusterIP: None
  9	  ports:
 10	  - port: 18504
 11	    name: redis-port
 12	  - port: 28504
 13	    name: sentinel-port
 14	  selector:
 15	    app: redis-sentinel

🟢 [3段階] Redis/Sentinel ポッド(Pod) 作成仕様書: redis-sentinel-sidecar-statefulset.yaml

Redis ポッド(Pod)（replicas, initContainers, memory, pvc(disk volume)）作成仕様書ファイルです。

種類(kind): StatefulSet
名前: metadata: name: redis-sentinel
⚠️ 名前は小文字(a-z)、数字(0-9)、ハイフン(`-`)のみ使うよう制限します（大文字は使用不可）
この名前で redis-sentinel-0,1,2 のように数字を付けてポッド(Pod) 名を付けます。
ポッド(Pod) 名と serviceName を使って、次のように FQDN(Full Qualified Domain Name) を作ります。
redis-sentinel-0.redis-sentinel-service.default.svc.cluster.local
Redis ごとに固有の FQDN 名で、Redis 間、Sentinel と Redis 間、または Redis/Sentinel と App 間で通信できます。 IP が変わると、変わった IP を FQDN に接続（設定）します。

🧑‍💻 主な値の説明

configMap: name: redis-sentinel-sidecar-config (1段階の Redis/Sentinel 設定と接続)
serviceName: redis-sentinel-service (2段階の Service と接続)
replicas: 3
- ポッド(Pod)① Redis-0(Master)/Sentinel-0
- ポッド(Pod)② Redis-1(Replica-1)/Sentinel-1
- ポッド(Pod)③ Redis-2(Replica-2)/Sentinel-2
image: redis:8.8.2 # 2026年08月17日(月) に発表されたバージョン 8.8.2 を使用
imagePullPolicy: IfNotPresent # ローカルイメージを使用
command スクリプト: 1段階 ConfigMap の設定ファイルコピーと動的設定
volumeMounts: mountPath: /data: Redis が使用/管理するすべてのファイル (redis.conf, users.acl, aof files など) を保存します。

💾 redis-sentinel-sidecar-statefulset.yaml ▼

📄 redis-sentinel-sidecar-statefulset.yaml

  1	apiVersion: apps/v1
  2	kind: StatefulSet
  3	metadata:
  4	  name: redis-sentinel
  5	spec:
  6	  serviceName: "redis-sentinel-service"
  7	  replicas: 3
  8	  selector:
  9	    matchLabels:
 10	      app: redis-sentinel
 11	  template:
 12	    metadata:
 13	      labels:
 14	        app: redis-sentinel
 15	    spec:
 16	      affinity:
 17	        # 1. 'nodeAffinity' を指定しない理由: 別ストレージに Redis ファイル(redis.conf, 
 18	        #   nodes.conf, AOF ファイル)を安全に保管(保存)しているため、どのノードで 
 19	        #   Redis ポッドが実行されても問題ない。 
 20	        # 2. podAntiAffinity: Master/Replica ノード分散
 21	        #   同じ app=redis-sentinel ラベルを持つポッド同士は可能な限り別ノード
 22	        #   (kubernetes.io/hostname 基準)に配置
 23	        podAntiAffinity:
 24	          preferredDuringSchedulingIgnoredDuringExecution:
 25	          - weight: 100
 26	            podAffinityTerm:
 27	              labelSelector:
 28	                matchExpressions:
 29	                - key: app
 30	                  operator: In
 31	                  values:
 32	                  - redis-sentinel
 33	              topologyKey: "kubernetes.io/hostname"
 34	      initContainers:
 35	      - name: init-config
 36	        image: redis:8.8.2
 37	        imagePullPolicy: IfNotPresent
 38	        command:
 39	        - /bin/sh
 40	        - -c
 41	        - |
 42	          # 1. ポッドインデックス抽出 (redis-sentinel-0 -> 0, redis-sentinel-1 -> 1, redis-sentinel-2 -> 2)
 43	          INDEX=$(echo $(hostname) | rev | cut -d'-' -f1 | rev)
 44	
 45	          # 2. /data/redis.conf の存在確認 (初回起動時のみコピーして設定を注入)
 46	          if [ ! -f /data/redis.conf ]; then
 47	            echo "First boot: Copying base redis.conf from ConfigMap..."
 48	            cp /readonly-config/redis.conf /data/redis.conf
 49	
 50	            # redis-0 でなければ初期レプリカ設定(replicaof)を注入
 51	            if [ "$INDEX" -ne "0" ]; then
 52	              echo "replicaof redis-sentinel-0.redis-sentinel-service.default.svc.cluster.local 18504" >> /data/redis.conf
 53	            fi
 54	            echo "replica-announce-ip redis-sentinel-$INDEX.redis-sentinel-service.default.svc.cluster.local" >> /data/redis.conf
 55	            # インデックスに基づく replica-priority の更新 
 56	            # redis-0 replica-priority 100, redis-1 110, redis-2 120
 57	            PRIORITY=$((100 + INDEX * 10))
 58	            sed -i '/replica-priority/d' /data/redis.conf
 59	            echo "replica-priority $PRIORITY" >> /data/redis.conf
 60	            # [クラウド脆弱性点検ガイド] 推奨値: rw-------
 61	            chmod 600 /data/redis.conf 
 62	          else
 63	            echo "Pod restarted: Keeping existing /data/redis.conf (Sentinel config preserved)."
 64	          fi
 65	
 66	          # 3. /data/users.acl の存在確認 (初回起動時のみコピー) 
 67	          if [ ! -f /data/users.acl ]; then
 68	            cp /readonly-config/users.acl /data/users.acl
 69	            chmod 600 /data/users.acl
 70	          fi
 71	
 72	          # 4. /data/sentinel.conf の存在確認 (初回起動時のみコピー) 
 73	          if [ ! -f /data/sentinel.conf ]; then
 74	            cp /readonly-config/sentinel.conf /data/sentinel.conf
 75	            # Sentinel 用 announce 設定 (同一 Pod の Headless DNS を活用)
 76	            POD_DNS="$(hostname).redis-sentinel-service.default.svc.cluster.local"
 77	            echo "sentinel announce-ip $POD_DNS" >> /data/sentinel.conf
 78	            echo "sentinel announce-port 28504" >> /data/sentinel.conf
 79	            chmod 600 /data/sentinel.conf
 80	          fi
 81	        volumeMounts:
 82	        - name: config-volume
 83	          mountPath: /readonly-config
 84	        - name: redis-data
 85	          mountPath: /data
 86	        # 📍 ポッドのメモリおよび CPU リソース設定
 87	        resources:
 88	          requests:
 89	            memory: "800Mi"      # 最小保証メモリ (ノードスケジューリング基準)
 90	            cpu: "500m"        # 最小保証 CPU (0.5 コア)
 91	          limits:
 92	            memory: "1Gi"    # 最大使用可能メモリ上限 (超過時 OOM)
 93	            cpu: "1000m"       # 最大使用可能 CPU (1 コア)
 94	
 95	      containers:
 96	      # [Container A: メイン Redis サーバー]
 97	      - name: redis
 98	        image: redis:8.8.2
 99	        imagePullPolicy: IfNotPresent
100	        command:
101	        - /bin/sh
102	        - -c
103	        - |
104	          cat << 'EOF' >> /root/.bashrc
105	          alias cls='clear'
106	          alias ll='ls -l --color=auto'
107	          alias ls='ls --color=auto'
108	          EOF
109	          exec redis-server /data/redis.conf
110	        ports:
111	        - containerPort: 18504
112	          name: redis-port
113	        volumeMounts:
114	        - name: redis-data
115	          mountPath: /data
116	        - name: tz-config
117	          mountPath: /etc/localtime
118	          readOnly: true
119	
120	      # [Container B: Sentinel サイドカー]
121	      - name: sentinel
122	        image: redis:8.8.2
123	        imagePullPolicy: IfNotPresent
124	        command:
125	        - /bin/sh
126	        - -c
127	        - |
128	          cat << 'EOF' >> /root/.bashrc
129	          alias cls='clear'
130	          alias ll='ls -l --color=auto'
131	          alias ls='ls --color=auto'
132	          EOF
133	          
134	          # ローカル Redis が完全に起動するまで待機
135	          until redis-cli -p 18504 -a redisgate ping > /dev/null 2>&1; do
136	            echo "Waiting for local redis-server..."
137	            sleep 1
138	          done
139	          
140	          exec redis-sentinel /data/sentinel.conf
141	        ports:
142	        - containerPort: 28504
143	          name: sentinel-port
144	        volumeMounts:
145	        - name: redis-data
146	          mountPath: /data
147	        - name: tz-config
148	          mountPath: /etc/localtime
149	          readOnly: true
150	
151	      volumes:
152	      - name: config-volume
153	        configMap:
154	          name: redis-sentinel-sidecar-config
155	      - name: tz-config
156	        hostPath:
157	          path: /etc/localtime
158	
159	  volumeClaimTemplates:
160	  - metadata:
161	      name: redis-data
162	    spec:
163	      accessModes: [ "ReadWriteOnce" ]
164	      resources:
165	        requests:
166	          storage: 5Gi

🧑‍💻 initContainers: command: スクリプト説明

ポッド(Pod) インデックス（数字）抽出(redis-sentinel-0 -> 0, redis-sentinel-1 -> 1, redis-sentinel-2 -> 2)してポッド(Pod) ごとに動的設定に使います。

📄 initContainers: command

INDEX=$(echo $(hostname) | rev | cut -d'-' -f1 | rev)
redis.conf ファイルがあればコピーしません。（初回起動時のみコピーして設定を注入）
Redis は運用中の重要イベント発生時に redis.conf へ書き込む(write) ため、ポッド(Pod) 再起動時に生成済みファイルをコピーしてはいけません。

📄 initContainers: command: redis.conf

if [ ! -f /data/redis.conf ]; then echo "First boot: Copying base redis.conf from ConfigMap..." cp /readonly-config/redis.conf /data/redis.conf # redis-0 でなければ初期レプリカ設定(replicaof)を注入 if [ "$INDEX" -ne "0" ]; then echo "replicaof redis-sentinel-0.redis-sentinel-service.default.svc.cluster.local 18504" >> /data/redis.conf fi echo "replica-announce-ip redis-sentinel-$INDEX.redis-sentinel-service.default.svc.cluster.local" >> /data/redis.conf # インデックスに基づく replica-priority の更新 # redis-0 replica-priority 100, redis-1 110, redis-2 120 PRIORITY=$((100 + INDEX * 10)) sed -i '/replica-priority/d' /data/redis.conf echo "replica-priority $PRIORITY" >> /data/redis.conf # [クラウド脆弱性点検ガイド] 推奨値: rw------- chmod 600 /data/redis.conf fi
users.acl ファイルがあればコピーしません。（初回起動時のみコピー）

📄 initContainers: command: users.acl

if [ ! -f /data/users.acl ]; then cp /readonly-config/users.acl /data/users.acl chmod 600 /data/users.acl fi
sentinel.conf ファイルがあればコピーしません。（初回起動時のみコピーして設定を注入）

📄 initContainers: command: sentinel.conf

if [ ! -f /data/sentinel.conf ]; then cp /readonly-config/sentinel.conf /data/sentinel.conf # Sentinel 用 announce 設定 (同一 Pod の Headless DNS を活用) POD_DNS="$(hostname).redis-sentinel-service.default.svc.cluster.local" echo "sentinel announce-ip $POD_DNS" >> /data/sentinel.conf echo "sentinel announce-port 28504" >> /data/sentinel.conf chmod 600 /data/sentinel.conf fi

🧑‍💻 containers: command: スクリプト説明

.bashrc ファイルに使いやすい alias をいくつか指定

📄 containers: command: .bashrc

cat << 'EOF' >> /root/.bashrc alias cls='clear' alias ll='ls -l --color=auto' alias ls='ls --color=auto' EOF
'--color=auto' を指定すると、ファイル名が次のように色分けされます。
dir file: redis-sentinel-model
exec file: cluster_create.sh
tar file: file redis-8.8.2.tar
基準時刻は UTC（英国）です。韓国時間（host OS time）に変更します。

📄 containers: command: 韓国時間（host OS time）に変更

# コンテナ内部に Host OS のタイムゾーンをマウント - name: tz-config mountPath: /etc/localtime readOnly: true # Host OS の /etc/localtime ファイルを参照 - name: tz-config hostPath: path: /etc/localtime

➡ 準備できたので、ポッド(Pod) を作成しに行きましょう。

<< K8s Redis-Sentinel App ②	K8s Sidecarパターン構築 ② >>

Email 返事がかかってなれば、メールでお知らせします。

クバネティス(Kubernetes) 環境で Redis-Sentinel Sidecarパターン 構築 実践ガイド ①

Sidecarパターンの概念

1. Redis-Sentinel Sidecarパターン 仕様書(YAML)

2. デプロイ順に沿ったファイル別の内容説明

🟢 [1段階] Redis-Sentinel Sidecarパターン 設定: redis-sentinel-sidecar-config.yaml

🧑‍💻 主な値の説明

🟢 [2段階] サービス(Service) 設定: redis-sentinel-sidecar-service.yaml

🧑‍💻 主な値の説明

🟢 [3段階] Redis/Sentinel ポッド(Pod) 作成仕様書: redis-sentinel-sidecar-statefulset.yaml

🧑‍💻 主な値の説明

🧑‍💻 initContainers: command: スクリプト説明

🧑‍💻 containers: command: スクリプト説明

クバネティス(Kubernetes) 環境で Redis-Sentinel Sidecarパターン構築実践ガイド ①

1. Redis-Sentinel Sidecarパターン仕様書(YAML)

🟢 [1段階] Redis-Sentinel Sidecarパターン設定: redis-sentinel-sidecar-config.yaml