ConfigMapのImmutable機能を使ってヒヤッとした話と得られた知見／A Close Call with ConfigMap Immutability and the Lessons Learned

2026.10.6 Kubernetes Novice Tokyo #42
https://k8s-novice-jp.connpass.com/event/405343/

1. ConfigMapのImmutable機能を使って ヒヤッとした話と得られた知見 2026.10.6（火）Kubernetes Novice Tokyo #42 モブエンジニア（@mob_engineer）
2. 対象者／得られる学び 対象者 1. ConfigMapのImmutable機能について知りたい方 2. Immutable機能を利用するうえで注意する観点を知りたい方 得られる学び 1. Immutable機能=ConfigMapに登録した変数を固定する機能 2. 頻繁にConfigMapを更新する場合は無効化した方がよい 2
3. お話しすること／お話しないこと お話すること 1. ConfigMapに関する概要説明 2. Immutable機能を利用したことで発生したトラブル／得られた学び お話しないこと 1. Kubernetes（以下k8s）で利用する他リソース紹介 （Pods、Serviceなど） 2. k8sを用いたアーキテクチャパターン 3. ArgoCDなどのCI／CD 3
4. 自己紹介 ペンネーム:  モブエンジニア（@mob_engineer） 業務内容:  某SI企業のSRE／PL 好きな技術領域:  クラウド（AWS、Azure、OCI）  コンテナ（k8s）、ネットワーク（仮想）  オブザーバビリティ運用（Dynatrace） 趣味:  コミュニティ／カンファレンス運営  （最近は少ないが）登壇／ブログ執筆 一言:  Kubernetesの楽しさを少しずつ学んでいます  Kubernetesのタグ付け支援OSSを開発したいと思っています 4
5. アジェンダ 1. ConfigMapについて 2. ヒヤッとした話 3. 得られた知見 5
6. ConfigMapについて
7. ConfigMapとは ConfigMapとは 1. 設定値をKey-Value形式で保存 2. 環境変数としてPodへ渡す 反映の流れ（ロールアウト） 1. ConfigMapを更新する 2. rollout restartを実行する 3. 新Podが新しい値を読み込む 各Podに設定する変数を定義するもの ① ConfigMap 設定値を更新 ② Deployment rollout restart ③ Pod（新） 新しい値で起動 旧Podは順次終了 7
8. ConfigMapのImmutable機能 Immutable機能とは 1. immutable: true でデータを変更不可にする メリット（公式ガイドより） 1. 意図しない更新によるアプリ障害を防げる 2. kube-apiserverの負荷を軽減できる 注意点 1. 一度設定すると元に戻せない（再作成が必要） 余計な環境変数の更新を行いたくない場合に設定する 8
9. ヒヤッとした話
10. 体制／課題感 体制 1. チーム全体としてk8sを導入するのが初めて 2. コミュニティ+書籍を読みながらキャッチップしていた 課題感 1. プロジェクト内で有識者が多くないため単純な設定としたい 2. 安全なメンテナンスを実現できる方法を模索していた ⇒ConfigMapのImmutable機能がよさそうと思い導入 10
11. ヒヤッとした話・・・ 導入したタイミングでは大きなトラブルはなかった。 ConfigMapの変更が必要な更新があるタイミングで、 ConfigMapの設定変更がPodへ反映されないといった事象が判明。 公式ガイドはGitHubのIssueを探すなかで1つの解を見つけました。 11
12. 調査するなかで見つけたIssue 新しい名前でConfigMap を作成⇒紐づけすれば 解決可能 12 https://github.com/kubernetes/website/issues/42359より引用
13. 得られた知見
14. 得られた知見／まとめ Immutable機能について調査するうえで「公式ガイド」だけでなく、 Issueでの議論内容も調査することが大事。 • 現在はドキュメントへ更新されているが当時は未反映 とは言えIssueすべてを見るのは大変なためAIを活用することが大事 • 技術調査としてAIをあまり活用していなかった k8sに関しては触ってみないと分からないところがあるため、 自分で環境を構築してみて調べることが大事。 • K8sの面白さを感じたのでメンテナ活動もやっていきたい 14
15. 今後の展望 K8sを用いた基盤構築／運用知見を高めていく Helm／ArgoCDなどの周辺領域についても学んでいく クラウド環境下でのk8s運用／コンテナネットワークについても 学んでいく 15
16. プロポーザル募集 スポンサー募集 16