※本記事はアフィリエイト広告(PR)を含みます。
止めないためには、Service を前に置いて、生きている Pod にだけ振り分ける必要がある。 ——そこが宿題として残っていました。
前回: 1台落としてもPodは移る — kubeadmで組む3台クラスタ
これは Kubernetes コースの「到達作品」の回です。 新しい知識はほとんど出てきません。minikube 入門から3台クラスタまででやってきたことを、1つの「公開されて、壊れても直るサービス」に束ねる回です。
この記事のコマンドは、VMで組んだ Kubernetes クラスタ(前回のkubeadm 3台)で打ちます。
cp1(コントロールプレーン)とw1/w2(ワーカー2台)がReadyで揃っている状態から始めます。まだ組んでいない人は、先に前回を終えてください。kubectlは、前回と同じくcp1からだけ打ちます。
前回、ワーカーVMの電源を実際に切って、Pod が別のマシンに作り直されるところを見ました。そして最後に、正直にこう書きました。
今回見たのは「壊れた分が自動で作り直される」ところまで。「一切止まらない」ではない。
この回で、その宿題を回収します。 そして、コースで別々に触ってきた Deployment・Service・Ingress・ConfigMap・Secret・ローリング更新 を、1つの動くサービスにまとめます。
対象レベル: 中級 / 区分: 必修
めがける作品
このコースを終えたら、これが作れるようになっている。 ——そう言い切れる1本を、ここで作ります。
作るのは 「クラスタの上で公開されている、小さなWebサービス」 です。中身は最初はただの nginx ですが、Kubernetes の基礎が全部入っています。
- アプリが Deployment で3つ動いている(3レプリカ)。そして3台のノードに散っている
- Service で安定した入口ができている(Pod のIPが変わっても、入口は変わらない)
- Ingress で、クラスタの外=Windows のブラウザから開ける
- Pod を1つ消しても、数秒で復活する(自己修復)
- アプリを新しい版に、無停止で入れ替えられる(ローリング更新)。失敗したら1コマンドで戻せる
- 設定は ConfigMap、秘密は Secret に分けてあり、アプリ本体に埋め込んでいない
完成すると、こう動きます。
Windows のブラウザ ──► http://web.local/
│
┌──────────────────────────┼──────────────────────────┐
│ Kubernetes クラスタ(前回の3台) │
│ ▼ │
│ Ingress(外からの入口) │
│ │ │
│ Service web(安定した内部の入口)│
│ ┌─────────────┼─────────────┐ │
│ Pod Pod Pod │
│ (w1) (w2) (w1) │
└──────────────────────────────────────────────────────┘
1つ消しても、勝手に3つに戻る/版を上げても止まらない
そして最後に、「1台のVM」から「壊れても直り、無停止で更新できる基盤」へ、自分が来たことを確かめます。
この記事でわかること
kubectl runで手で立てるのと、YAMLで宣言するのは、似て非なるものであること。到達作品では全部マニフェストで宣言します- Pod のIPは変わる。だから直接 Pod を指してはいけない。 Service という「変わらない入口」を1枚かませる、という考え方
- Service だけでは、クラスタの外からは入れない。 外へ出す口が Ingress / NodePort / LoadBalancer で、それぞれ何が違うか
- 「壊れても直る」の正体は、宣言した状態に戻し続けているだけだということ。Pod 単位(数秒)とノード単位(前回の約5分)の違い
- 無停止更新は魔法ではなく、
maxUnavailable: 0という設定の結果であること。そして失敗を1コマンドで巻き戻せること - 設定と秘密をアプリから分ける理由。そして Secret は「暗号化」ではないこと
この記事でやること
- アプリを Deployment(replicas 3)としてマニフェストで宣言し、3台のノードに散らす
- Service を置いて、安定した入口を作る(Pod のIPが変わっても壊れない)
- Ingress で外に出し、Windows のブラウザから実際に開く(山場)
- Pod を1つ消して、勝手に復活するのを見る(自己修復)
- アプリの版を、無停止で入れ替える(ローリング更新)。そして戻す(ロールバック)
- ConfigMap と Secret で、設定と秘密をアプリから分ける
- 完成の判定(6つのチェック)を自分で通し、後片づけする
先に知る言葉
この記事で軸になる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| Deployment | 「このアプリを◯個、この版で保て」という宣言。数が減ると自分で足す |
| ReplicaSet | Deployment が裏で作る、レプリカ数を守る係。「3個」を実際に見張っているのはこれ |
| Service(ClusterIP) | 変わらない内部の入口。裏の Pod が入れ替わっても、宛先はこの1つ |
| Endpoints | Service がいま振り分けている Pod のIP一覧。Pod が増減すると自動で書き換わる |
| NodePort | 各ノードのポートを開けて、外から Service に入れる簡単な方法 |
| Ingress | ホスト名やパスで振り分ける、外からの入口。Webの表玄関にあたる |
| Ingress コントローラ | Ingress の中身を実際に動かす部品。これを入れないと Ingress は効かない |
| ConfigMap | 設定値を入れておく箱。アプリ本体(イメージ)から設定を切り離す |
| Secret | 秘密を入れておく箱。base64 で符号化されるだけで、暗号化ではない |
| ローリングアップデート | 古い Pod を1つずつ新しいものに置き換える更新のしかた。止めずに入れ替える |
① まず「何を、どう宣言するか」を決める
最初に、この記事でいちばん大事なルールを置きます。
手で立てない。全部マニフェスト(YAML)で宣言する。
前回・前々回で、こういうコマンドを見たかもしれません。
これは動きます。 でも、到達作品ではこれを使いません。 理由は3つあります。
kubectl run(命令) | マニフェスト(宣言) |
|---|---|
| 「いま何を作ったか」がどこにも残らない | ファイルに残る。 これが設計図であり、記録 |
| 数を保つ / 更新する / 戻すが、あとから効かない | Deployment なので、全部あとから効く |
| 同じものをもう一度作れない(記憶頼み) | kubectl apply -f で、何度でも同じ状態に戻せる |
Kubernetes の値打ちは「宣言したものに、現実を寄せ続けてくれる」ところでした(minikube の回の「状態を宣言する」)。手で run した瞬間、その値打ちを自分から捨てています。
同じ「アプリを3つ動かす」を、2通りで並べると差がはっきりします。
【命令(kubectl run)】 【宣言(apply -f deployment.yaml)】
「Pod を作れ」と3回言う 「3個であれ」と1回書く
↓ ↓
作った直後の状態しか無い ファイル(設計図)が残る
↓ ↓
1個消えても、誰も足さない 1個消えると、自動で足される
↓ ↓
版を上げる方法が無い 版を上げる・戻すが効く
↓ ↓
同じ環境をもう一度作れない apply でいつでも同じ状態に戻せる
左の道は、最初の一歩は速いのに、そのあとが全部行き止まりです。到達作品では、最初にひと手間かけて YAML を書き、そのぶんを④以降で何倍にも回収します。
作業用のフォルダを1つ作ります。cp1 で:
これ以降のマニフェストは、全部この
~/capstone/の中に置きます。 このフォルダごと残しておけば、それがあなたの「作品の設計図一式」になります。あとでGitOps の回で、このフォルダをそのまま Git に載せます。
最初のアプリは、いちばん確実に動く nginx にします。 「自分のアプリ」に差し替えるのは、⑤と⑥のあと、動く形が手に入ってからにします。最初から自作イメージにすると、アプリのバグとKubernetesの設定ミスの、どちらで詰まったか分からなくなるからです。
② Deployment で3レプリカ — 数を保つ仕組み
1つ目のマニフェストを書きます。cp1 で:
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
spec:
replicas: 3
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: nginx
image: nginx:1.27.0
ports:
- containerPort: 80
| 場所 | 意味 |
|---|---|
kind: Deployment | 「Pod を◯個保て」という宣言。Pod を直接は書かない |
replicas: 3 | 保ってほしい数。 ここが今回の主役 |
selector.matchLabels | Deployment が「自分の Pod」を見分ける目印。下の labels と一致させる |
template | Pod の設計図。この形の Pod を3つ作る |
image: nginx:1.27.0 | 版(タグ)を固定する。 latest にしない(⑤で理由が分かります) |
selectorとtemplate.metadata.labelsは必ず一致させます。 ここがずれると、Deployment は「自分の Pod が0個だ」と思い込んで、Pod を無限に作ろうとします。 よくある最初の事故です。
適用します。
NAME READY STATUS RESTARTS AGE IP NODE
web-6b7d9c4f8-2xk9p 1/1 Running 0 20s 10.244.1.4 w1
web-6b7d9c4f8-7mq3t 1/1 Running 0 20s 10.244.2.3 w2
web-6b7d9c4f8-b8n5r 1/1 Running 0 20s 10.244.1.5 w1
NODE の列を見てください。 w1 と w2 に散っています。 これも前回やった「置き場所が複数あること」の効き目です。
「数を保つ」を、宣言で確かめる
replicas を変えて apply するだけで、数が変わります。手で Pod を足しません。
5つに増えます。 戻します。
これが「宣言」の意味です。 「2つ足せ」ではなく「5であれ」と言う。いまが何個かをこちらが数えない。 クラスタが差分を埋めます。この考え方が、④の自己修復にそのまま繋がります。
「3個を保つ係」の正体を見る
Deployment が直接 Pod を見張っているわけではありません。 間に ReplicaSet という係がいます。
NAME DESIRED CURRENT READY AGE
web-6b7d9c4f8 3 3 3 3m
| 列 | 意味 |
|---|---|
DESIRED | 宣言した数(replicas: 3)。「こうあってほしい」 |
CURRENT | いま実在する数。ここが DESIRED を下回ると、埋めにいく |
READY | そのうち実際に使える数 |
DESIREDとCURRENTの差を、ゼロに保ち続けているのが ReplicaSet です。 ④で Pod を消すとCURRENTが一瞬 2 になり、すぐ 3 に戻ります。「壊れても直る」は、この2列の差を埋める動きにすぎません。
一時的に数を変えるだけなら、ファイルを触らず kubectl scale でもできます。
ただし
kubectl scaleは「その場の命令」で、deployment.yamlには反映されません。 次にkubectl apply -fすると、ファイルの3に戻ります。恒久的に変えたいなら、必ずファイルを直す——①で決めた「宣言を正にする」を、ここでも崩さないでください。負荷に応じて自動で増減させる仕組み(オートスケール)もありますが、それは別の回に譲ります。
[スクリーンショット: 01_3レプリカが3ノードに散る.png] cp1 で kubectl get pods -o wide を実行し、3つの Pod が w1 と w2 に分かれている(NODE 列)画面を撮ってください。
③ Service と Ingress で公開する
ここがこの記事の山場です。 「アプリは動いている。でも、誰も開けない」——その隙間を埋めます。
なぜ Pod を直接指してはいけないのか
②の出力に、Pod のIP(10.244.1.4 など)が出ていました。 「じゃあ、そのIPに繋げばいい」と思いますが、これは絶対にやってはいけません。
Pod のIPは、いつでも変わります。
Pod は壊れれば作り直され、そのたびに新しいIPになります。 ④でPodを消すと、まさにそれが起きます。IPを控えて繋ぐ設計は、次にPodが入れ替わった瞬間に壊れます。
だから、間に「変わらないもの」を1枚かませます。それが Service です。
Service(ClusterIP)を置く
2つ目のマニフェスト。cp1 で:
apiVersion: v1
kind: Service
metadata:
name: web
spec:
selector:
app: web
ports:
- port: 80
targetPort: 80
| 場所 | 意味 |
|---|---|
kind: Service | 変わらない入口を1つ作る |
selector.app: web | 「app=web のラベルが付いた Pod ぜんぶ」に振り分ける。 IPではなくラベルで指す |
port / targetPort | 入口のポート / 転送先(Pod)のポート |
NAME TYPE CLUSTER-IP PORT(S) AGE
web ClusterIP 10.108.12.34 80/TCP 10s
NAME ENDPOINTS AGE
web 10.244.1.4:80,10.244.1.5:80,10.244.2.3:80 10s
kubectl get endpointsを見てください。 Service の裏に、②で見た3つの Pod のIPが自動で並んでいます。 Pod が入れ替わると、この一覧も自動で書き換わります。 あなたは何もしません。これが「変わらない入口」の中身です。
振り分けを確かめます。使い捨ての Pod から、Service の「名前」で叩きます。
200
200
200
200
200
200
webという名前でIPも書かずに繋がったことに注目してください。クラスタ内では、Service 名がそのままホスト名になります(CoreDNS が解決しています)。IPを一切書いていないから、Pod が入れ替わっても壊れません。
Service が「いま」どの Pod へ流しているかは、describe で見えます。
Selector: app=web
Endpoints: 10.244.1.4:80,10.244.1.5:80,10.244.2.3:80
Selectorが「どのラベルの Pod を集めるか」、Endpointsが「その結果いま集まっている Pod」です。あなたはIPを1つも書いていません。 ラベル(app=web)だけを頼りに、Kubernetes が宛先一覧を組み立て直し続けています。この「ラベルで指す」考え方が、Kubernetes 全体を貫いています。
でも、これはまだ「クラスタの中」だけ
いまの Service(ClusterIP)は、クラスタの内側からしか見えません。 Windows のブラウザからは、まだ開けません。外に出す口が要ります。 道は主に3つです。
| 外への出し方 | 何をするか | 今回 |
|---|---|---|
| NodePort | 各ノードのポート(30000番台)を開ける。手早い | まず動作確認に使う |
| LoadBalancer | クラウドが本物のロードバランサを1台くれる | 自前VMには「くれる人」がいないので使えない |
| Ingress | ホスト名・パスで振り分ける表玄関。本命 | ✅ これを作る |
type: LoadBalancerは、自前クラスタではEXTERNAL-IPが<pending>のまま止まります。 「払い出す人(クラウド)」がいないからです。エラーではありません。 クラウドの EKS 等なら、ここが自動で埋まります。自前とマネージドの差が、ちょうどこの1行に出ます。
まず NodePort で、外に出るか確かめる
山場の Ingress の前に、いちばん確実な NodePort で「そもそも外から届くか」を先に確かめます。 ここが通らないなら、Ingress でも通りません。
Service に2行だけ足します。
apiVersion: v1
kind: Service
metadata:
name: web
spec:
type: NodePort
selector:
app: web
ports:
- port: 80
targetPort: 80
nodePort: 30080
Windows の PowerShell から、ワーカーのIPと 30080 番で叩きます。
nginx の歓迎ページのHTMLが返れば、外から届いています。 前回 ufw で 30000:32767 を開けておいたのが、ここで効いています。 届かないなら、前回の ufw を見直してください。
NodePort は「動く。でも住所が汚い」入口です。
IP:ポート番号を人に伝えるのは現実的ではありません。だから本命は Ingress——ホスト名でアクセスできる表玄関です。
本命:Ingress コントローラを入れる
Ingress は「ルール」であって、それ自体は何もしません。 ルールを実際に読んで振り分ける「Ingress コントローラ」を、先に入れる必要があります。 これを入れ忘れて「Ingress を作ったのに繋がらない」が、いちばん多い詰まり方です。
今回は、手順が単純で資料も多い ingress-nginx を、学習用として自前クラスタ向け(bare-metal)の設定で入れます。cp1 で:
バージョン番号は、読む時期によって変わります。 下の
controller-v1.11.3を、そのまま信じないでください。Ingress コントローラの一覧(公式)から ingress-nginx の最新版の番号に読み替えてから打ってください。前回 kubeadm でやったのと同じ注意です。 また ingress-nginx は、Kubernetes SIG Network が引退を発表し、2026年3月で保守が終了しています。 以後はリリースも脆弱性の修正も出ません(既存の導入物と配布ファイルは引き続き使えます)。この回では練習用クラスタでの学習に限って使い、本番や外に公開する環境では Gateway API か、公式の一覧にある別の Ingress コントローラを選んでください。
コントローラの Pod が立つのを待ちます。
ingress-nginx-controller-xxxx が Running(1/1)になったら Ctrl + C で止めます。 その入口ポートを見ます。
NAME TYPE CLUSTER-IP PORT(S) AGE
ingress-nginx-controller NodePort 10.106.7.20 80:31180/TCP,443:31443/TCP 40s
80:31180の右側(31180)が、外から入るポートです。この番号はあなたの環境では違います。 メモしてください。bare-metal 版は、この NodePort が外への入口になります。
Ingress リソースを作る
3つ目のマニフェスト。ここで「web.local に来たら、Service web へ流せ」というルールを書きます。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: web
spec:
ingressClassName: nginx
rules:
- host: web.local
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: web
port:
number: 80
| 場所 | 意味 |
|---|---|
ingressClassName: nginx | どのコントローラに任せるか。 さっき入れた ingress-nginx を指す |
host: web.local | この名前で来たときだけ振り分ける |
path: / / pathType: Prefix | / で始まる全てのパスを対象にする(サイト全体を1つの Service へ) |
backend.service.name: web | 流す先は Service web(Pod ではなく Service を指す) |
pathTypeは省略できません(networking.k8s.io/v1の Ingress では必須です)。Prefixは「前方一致」で、いちばんよく使います。/apiは別の Service へ、のようにパスで振り分けたくなったら、ここに行を足していきます。 今回は1つのアプリなので/の1本だけです。
NAME CLASS HOSTS ADDRESS PORTS AGE
web nginx web.local 192.168.226.51 80 15s
ルールがどう解釈されたかは、describe で確かめられます。
Rules:
Host Path Backends
---- ---- --------
web.local / web:80 (10.244.1.4:80,10.244.1.5:80,10.244.2.3:80)
web.local / → web:80という1本の道ができました。そしてweb:80の先に、②で見た3つの Pod のIPがぶら下がっています。外の名前(web.local)→ Ingress → Service → Pod、という4段の橋が、ここで初めて繋がりました。
Windows に「web.local はここ」と教える
web.local はインターネットに存在しない名前です。 Windows に、手動で住所を教えます。DNSの回で見た hosts ファイルを使います。
Windows で、管理者として C:\Windows\System32\drivers\etc\hosts を開き、末尾に1行足します(ワーカーのIP)。
192.168.226.51 web.local
そして、さっきの Ingress コントローラの NodePort(例では 31180)を付けて、ブラウザで開きます。
http://web.local:31180/
nginx の歓迎ページが、web.local という名前で表示されれば——公開できています。
本番では、この NodePort は見せません。 前段に nginx などを置いて 80/443 に受け、そこへ流します(リバースプロキシの回でやった役割そのもの)。学習用の自前クラスタでは、NodePort 直打ちで十分です。「なぜ番号が要るのか」を分かったうえで使ってください。
[スクリーンショット: 02_ブラウザから公開アプリが見える.png] Windows のブラウザで http://web.local:ポート番号/ を開き、アドレスバーに web.local が見えていて、ページが表示されている画面を撮ってください。この記事でいちばん「繋がった」と実感する場所です。
④ 自己修復を見る — 「壊れても直る」の正体
ここは短いですが、Kubernetes の核心です。
2つのターミナルを使います。1つ目(cp1)で、監視を始めます。
このまま流しっぱなしにします。 -w(watch)は、変化があるたびに行を足していきます。
もう1つ cp1 のターミナルを開いて(Windows から ssh をもう1本)、Pod を1つ、名前を指定して消します。
Pod名はあなたの環境の実物に置き換えてください。 上の
web-6b7d9c4f8-2xk9pは例です。
監視している側を見てください。
web-6b7d9c4f8-2xk9p 1/1 Terminating 0 8m
web-6b7d9c4f8-k4v2m 0/1 Pending 0 0s
web-6b7d9c4f8-k4v2m 0/1 ContainerCreating 0 0s
web-6b7d9c4f8-k4v2m 1/1 Running 0 3s
消した瞬間、別の名前の Pod が数秒で立ち上がります。 数はまた3に戻ります。
これが「壊れても直る」の正体です。魔法ではありません。 ②で
replicas: 3と宣言しました。裏で ReplicaSet が「3個であれ」を見張っています。1個消えて2個になった瞬間、宣言(3)と現実(2)が食い違う。 だから足す。それだけです。
前回(ノード落ち)との違い
前回は「ノードごと」落として、Pod が移るのに約5分かかりました。 今回は「Pod 1つ」を消して、数秒で戻りました。この差は、どちらも同じ仕組みの別の側面です。
| 壊し方 | 気づくまで | なぜ |
|---|---|---|
| Pod を消す(今回) | 数秒 | クラスタは「消えた」を即座に知っている(自分が消した相手だから) |
| ノードが落ちる(前回) | 約5分 | 「返事がないだけか、本当に死んだか」を見極める猶予(前回の話) |
どちらも「宣言した状態に、現実を寄せ続けている」だけです。あなたは何も打っていません。 そこがコースを通して繰り返してきた、Kubernetes の一番の値打ちです。
「気づいて、直した」記録が残っている
「勝手に直った」を、気のせいで済ませません。 クラスタは、自分が何をしたかを記録しています。
TYPE REASON OBJECT MESSAGE
Normal Killing pod/web-6b7d9c4f8-2xk9p Stopping container nginx
Normal SuccessfulCreate replicaset/web-6b7d9c4f8 Created pod: web-6b7d9c4f8-k4v2m
Normal Scheduled pod/web-6b7d9c4f8-k4v2m Successfully assigned ...
Normal Pulled pod/web-6b7d9c4f8-k4v2m Container image already present
Normal Started pod/web-6b7d9c4f8-k4v2m Started container nginx
SuccessfulCreate ... Created podの行が、ReplicaSet が欠員に気づいて Pod を作り直した瞬間の記録です。「消えた → 数が足りない → 作った」という判断が、あなたの代わりに行われて、ログに残っています。 何かおかしいと思ったら、まずkubectl get eventsを見る——これは前回までも、この先もずっと使う癖です。
⑤ 無停止でローリング更新する — そして戻す
アプリを新しい版に入れ替えます。 本番の更新で一番怖いのは「更新中にサービスが落ちること」です。それを起こさない設定を、先に宣言します。
まず「止めない」を宣言する
Deployment に、更新のしかたを書き足します。
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
spec:
replicas: 3
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1
maxUnavailable: 0
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: nginx
image: nginx:1.27.0
ports:
- containerPort: 80
| 設定 | 意味 |
|---|---|
type: RollingUpdate | 古い Pod を1つずつ新しいものに置き換える(全部いっぺんに落とさない) |
maxSurge: 1 | 更新中、一時的に1つ多く立ててよい(先に新を用意してから旧を落とす) |
maxUnavailable: 0 | 「使える Pod が、規定数を1つも下回ってはならない」。 これが「無停止」の実体 |
maxUnavailable: 0が、この節の主役です。 これがあると、新しい Pod が「使える」状態になるまで、古い Pod は落ちません。 だから、いつでも3つ(以上)が生きています。「無停止」は祈りではなく、設定の結果です(この1行だけで足りない場合は「つまずいたところ」へ)。
更新中も切れないことを、目で見る
まず、絶え間なくアクセスし続ける見張りを、クラスタ内から動かします。
200 200 200 ... が流れ続けます。 これを流したまま、別のターミナル(cp1)で版を上げます。
Waiting for deployment "web" rollout to finish: 1 out of 3 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 2 out of 3 new replicas have been updated...
deployment "web" successfully rolled out
見張りの
200が、更新の間じゅう途切れなかったはずです。 これが「無停止でローリング更新できた」ということです。古い Pod と新しい Pod が、一瞬だけ共存して、切れ目なくバトンを渡しています。
見張りは Ctrl + C で止めます(--rm なので Pod は自動で消えます)。
何が起きたのかを、ReplicaSet で見る
ローリング更新の実体は、「新しい ReplicaSet を1つ作って、古いほうを空にしていく」ことです。 目で見えます。
NAME DESIRED CURRENT READY AGE
web-6b7d9c4f8 0 0 0 20m
web-7c8e5d9a2 3 3 3 3m
| 見えるもの | 意味 |
|---|---|
古い ReplicaSet(web-6b7d9c4f8) | DESIRED が 0 に減らされた。もう Pod を持っていない |
新しい ReplicaSet(web-7c8e5d9a2) | DESIRED が 3 に増やされた。いまの3つはこちら |
古い ReplicaSet は、消されずに 0 のまま残っています。 これが
rollout undoの種明かしです。「前の版の設計図」がそのまま残っているから、そこへ戻せるのです。⑤の最後で戻すとき、この古いほうが再び 3 に増えます。
kubectl set imageは手早いですが、それだけだとdeployment.yamlのタグ(1.27.0)と、実際に動いている版(1.27.3)がずれます。 記録を正にするなら、deployment.yamlのimage:も書き換えてapplyします。「動いているもの」と「ファイルに書いてあるもの」を一致させておくのが、あとで自分を助けます(GitOps の回の核心です)。
[スクリーンショット: 03_更新中もアクセスが切れない.png] probe の 200 200 200 ... が流れているターミナルと、kubectl rollout status が走っているターミナルを並べて、更新中も 200 が途切れていないところを撮ってください。
失敗したら、戻す
更新は失敗します。 存在しないタグを指してしまった、新しい版が起動しない、など。やってみます。
新しい Pod がイメージを取得できず、ImagePullBackOff で止まります。
ここで
maxUnavailable: 0が効いています。 新しい Pod が「使える」にならないので、古い Pod は落ちていません。 つまりサービスはまだ古い版で生きています。 更新は「進めない」だけで、「壊れた」わけではありません。
1コマンドで、直前の版に戻します。
失敗した Pod が消え、動いていた版に戻ります。
rollout undoが使えるのは、Deployment が「これまでの版」を覚えているからです。手でkubectl runしていたら、戻る先がありません。 ①で「宣言で作る」と決めたことが、ここで効いています。
⑥ 設定と秘密を、アプリから分ける
最後に、実際のアプリに必要な「設定」と「秘密」を扱います。
設定値(接続先、動作モードなど)や秘密(パスワード、APIキー)を、イメージの中に焼き込んではいけません。 焼き込むと、設定を変えるたびにイメージを作り直すことになり、秘密がイメージに残ります。 Kubernetes では、これを箱に分けます。
ConfigMap — 秘密でない設定
apiVersion: v1
kind: ConfigMap
metadata:
name: web-config
data:
APP_ENV: "staging"
GREETING: "Hello from ConfigMap"
Secret — 秘密(中身はダミー)
秘密は Secret に入れます。 ここで入れるパスワードは、この記事用のダミーです。本物を打たないでください。
dummy-password-change-meは、練習用のでたらめな文字列です。 実在のパスワードでは絶対にやらないでください。理由は、すぐ下で分かります。
Secret は「暗号化」ではない
「秘密の箱」と聞くと暗号化されている気がしますが、違います。 中身を取り出してみます。
dummy-password-change-me
打ち込んだ文字が、そのまま読めました。 Secret は base64 で符号化されているだけで、base64 は「暗号」ではなく「文字の並べ替え」です。誰でも元に戻せます。 つまり Secret の値打ちは「暗号化」ではなく「ConfigMap と扱いを分けられること」——アクセス権を別に絞れる、
kubectl getの一覧に平文で出にくい、といった運用上の分離です。本当に守るには、保存時の暗号化などを別途かけます(この掘り下げは別の回に譲ります)。まずは「Secret ≠ 暗号化」を体で知っておくことが大事です。
アプリに、環境変数として渡す
Deployment の containers に、ConfigMap と Secret を環境変数として差します。
containers の中を、こう書き換えます(image の行はそのまま)。
containers:
- name: nginx
image: nginx:1.27.3
ports:
- containerPort: 80
envFrom:
- configMapRef:
name: web-config
env:
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: web-secret
key: DB_PASSWORD
| 場所 | 意味 |
|---|---|
envFrom.configMapRef | ConfigMap の中身を、まとめて環境変数にする(APP_ENV と GREETING) |
env + secretKeyRef | Secret の1つの値を、DB_PASSWORD という環境変数にする |
template(Pod の中身)を変えてapplyしたので、⑤のローリング更新が自動で走ります。 設定を変えただけでも、Pod は作り直されます。「変えたら、宣言に合わせて置き換わる」が、ここでも一貫しています。
新しい Pod に、値がちゃんと渡っているか確かめます。
staging / Hello from ConfigMap / dummy-password-change-me
設定はアプリの外の箱にあり、アプリはそれを環境変数として受け取っています。 これで、同じイメージのまま、staging を production に変えるだけで動作を変えられます。 イメージを作り直しません。
いま ~/capstone/ にあるもの
ここまでで、作品の設計図が5枚そろいました。 これが到達作品の本体です。
~/capstone/
├── deployment.yaml アプリ本体(3レプリカ・更新のしかた・環境変数の受け口)
├── service.yaml 変わらない内部の入口(+NodePort)
├── ingress.yaml 外からの表玄関(web.local → web)
└── configmap.yaml 秘密でない設定
(Secret は kubectl create で作成。YAML化して置いてもよい)
| ファイル | kind | 役割 | 依存 |
|---|---|---|---|
deployment.yaml | Deployment | Pod を3つ、この版で保つ | ConfigMap / Secret を参照 |
service.yaml | Service | ラベル app=web の Pod へ振り分ける | Deployment の Pod |
ingress.yaml | Ingress | web.local を Service web へ流す | Service |
configmap.yaml | ConfigMap | APP_ENV などの設定値 | — |
この5枚を読めば、「何が、いくつ、どうやって公開され、どう更新されるか」が全部分かります。 頭の中にも、誰かの記憶にも頼っていません。「作れる」とは、この設計図を自分で書けることでした。ばらばらに触ってきた部品が、ここで1つの図に収まりました。
⑦ 完成の判定 — 自分で「できた」と言えるように
「なんとなく動く」で終わらせません。 この6つを自分で通したら、Kubernetes の到達作品は完成です。
□ アプリが Deployment(replicas 3)で立ち、2台のワーカー(w1 / w2)に散っている
□ Service を通して、名前(web)でアクセスでき、Pod が入れ替わっても壊れない
□ Ingress(または NodePort)で、Windows のブラウザから開ける
□ Pod を1つ消すと、数秒で別の Pod が立ち、数が3に戻る
□ 版を無停止でローリング更新でき、失敗しても rollout undo で戻せる
□ 設定は ConfigMap、秘密は Secret に分かれていて、イメージに焼き込んでいない
全部を、一度に確かめられます。cp1 で:
1つでも通らなかったら、それがこのコースで「まだ手が届いていない場所」です。 そこだけ、対応する回に戻ればいい。この判定リストが、「触った」を「作れる」に変えます。
最後の証明:まっさらから、1コマンドで立て直す
「宣言で作った」ことの、いちばん強い証拠を見せます。 作品を全部消して、フォルダから丸ごと立て直します。
cp1 で、いったん全部消します。
Deployment も Service も Ingress も ConfigMap も消えます。 そして、同じフォルダから、もう一度立てます。
Secret だけは
kubectl create secretで作ったので、~/capstone/には入っていません。 消えたままなら、⑥のkubectl create secret ...をもう一度打つか、Secret も YAML にして同じフォルダに入れておきます。「フォルダを見れば、作品の全部が分かる」状態が理想です。
数十秒で、さっきと同じサービスが立ち上がります。 これが kubectl run では絶対にできなかったことです。手順を覚えている必要も、順番を思い出す必要もありません。フォルダが設計図で、apply が組み立てです。 ——このフォルダをそのまま Git に載せれば、GitOpsの入口に立っています。
「自分のアプリ」に差し替えるのは、ここからです。 image: nginx:1.27.3 を、Docker の回で作った自分のイメージ名に変えるだけです。Deployment・Service・Ingress・ConfigMap・Secret の骨組みは、そのまま使えます。あなたはもう、その骨組みを手で書けます。
つまずいたところ
Deployment を apply したら、Pod が無限に増え続けた。 selector.matchLabels と template.metadata.labels がずれていました。Deployment が「自分の Pod が0個だ」と誤認して、作り続けていました。2つのラベルは必ず一致させます。
Service を作ったのに、ブラウザから開けなかった。 ClusterIP はクラスタの内側だけの入口でした。外に出すには NodePort か Ingress が要る、を知らずに「Service を作れば公開だ」と思い込んでいました。
type: LoadBalancer にしたら EXTERNAL-IP が <pending> のまま固まった。 故障だと思って調べ続けました。自前のVMクラスタには、ロードバランサを払い出す人(クラウド)がいないだけでした。エラーではありません。NodePort か Ingress に切り替えて解決。
Ingress を作ったのに、何も起きなかった。 Ingress コントローラを入れていませんでした。 Ingress は「ルール」で、それを読む「係」が別に要ります。ingress-nginx を入れたら効きました。
web.local で開けなかった。 そんなドメインは世界に存在しないので当然でした。Windows の hosts ファイルに 192.168.226.51 web.local を足すのを忘れていました。DNSの回の「名前を住所に変える」を、手でやる話です。
Pod を消したのに「壊した」気がして焦った。 数秒で別の Pod が立ち、何事もなかったように3つに戻りました。これは「壊した」のではなく「自己修復を確かめた」のだと、あとで腑に落ちました。
ローリング更新で、一瞬アクセスが切れた。 maxUnavailable のせいだと思いましたが、規定値の 25% は切り捨てなので replicas: 3 なら規定のままでも 0 です。瞬断は、readinessProbe が無い・止まる Pod が振り分け先から外れる前に止まる、でも起こります。 「無停止」は設定の組み合わせの結果でした。
Secret に本物のパスワードを入れかけた。 base64 -d で平文がそのまま出るのを見て、肝が冷えました。Secret は暗号化ではない。 練習は必ずダミーで、を徹底しました。
見張りの probe Pod が、作業のあとも残っていた。 --rm は「kubectl run が終わったら消す」なので、Ctrl + C で抜けずにターミナルを閉じると、Pod が残ることがあります。kubectl get pods に知らない probe がいたら、kubectl delete pod probe で消します。使い捨てのつもりのものが残っていないか、最後に一度見る癖をつけました。
kubectl exec deploy/web -- ... が、どの Pod で実行されたのか分からず混乱した。 deploy/web を指すと、3つのうち1つが自動で選ばれます。 環境変数の確認では3つとも同じなので問題ありませんが、「Pod ごとに違う値」を見たいときは、kubectl get pods で名前を確かめて1つずつ指定します。
後片づけ
作品の設計図(~/capstone/ の YAML)は、消さないでください。 それが到達作品の本体です。動いているものだけ、止めます。
アプリと入口だけ消す
cp1 で、フォルダごと一括で消せます。 宣言で作ったので、宣言で消せます。
Ingress コントローラも消すなら:
残っていないか確認します。
Secret を消す
クラスタごと止める / 戻す
しばらく使わないなら、前回の「後片づけ」と同じです。 3台とも sudo shutdown -h now で止めれば、メモリは全部返ってきます。クラスタ構成はディスクに残るので、次に cp1 → w1 → w2 の順で起動すれば、また使えます。
Windows の
hostsに足した192.168.226.51 web.localの行も、使い終わったら消しておくと、あとで別のものと紛れません。緩めた・足したものを戻すまでが後片づけです。
まとめ — 理解できたこと
- 手で
kubectl runせず、全部マニフェスト(YAML)で宣言した。 記録が残り、何度でも同じ状態に戻せる - Deployment の
replicas: 3は「3であれ」という宣言。 増減は差分で埋められる。数をこちらで数えない - Pod のIPは変わる。だから直接指さず、Service という変わらない入口を1枚かませる
- Service は Endpoints で裏の Pod を自動追従する。 Pod が入れ替わっても、名前(
web)で繋がり続ける - ClusterIP はクラスタの中だけ。外に出すのは NodePort / LoadBalancer / Ingress
- 自前クラスタでは
LoadBalancerが<pending>で止まる。 払い出す人がいないから。ここがマネージドとの差 - Ingress は「ルール」。読む「係」= Ingress コントローラを別に入れないと効かない
web.localは Windows のhostsで住所を教えて、ブラウザから開いた- 「壊れても直る」の正体は、宣言した数に現実を寄せ続けているだけ。 Pod 単位は数秒、ノード単位は約5分
- 無停止更新は
maxUnavailable: 0の結果。 新しい Pod が使えるまで、古い Pod を落とさない - 更新に失敗しても
rollout undoで戻せる。 宣言で作ったから、戻る先がある - 設定は ConfigMap、秘密は Secret に分け、環境変数で渡した。 イメージに焼き込まない
- Secret は暗号化ではない。
base64 -dで平文が読める。練習は必ずダミーで - 「1台のVM」から「公開されて、壊れても直り、無停止で更新できる基盤」へ来た。 これが Kubernetes コースの到達点
そして、この先へ
ここまでで、Kubernetes を「動かす」側は一周しました。 次に効いてくるのは、「運用し続ける」重さです。
- 自前クラスタは、放っておくと勝手に古びます。 証明書の期限、版の更新、バックアップ——「組んだあと、誰が面倒を見るのか」という重さは、EKS など、クラウドのマネージド Kubernetesが肩代わりする部分と、それでも残る部分に分かれます。自前とマネージドの分かれ目は、そこにあります
- 今回、更新を
kubectlで手打ちしました。 これを「Git に置いた YAML を正として、クラスタを自動で寄せる」形にするのが、手で直した設定は勝手に戻る — ArgoCD で GitOpsです。~/capstone/のフォルダが、そのまま出発点になります - そして「わざと壊して、直す」を体系立ててやるのが、障害対応の回です。今回の「Pod を消す」「ノードを落とす」は、その入口でした
あなたはもう、宣言で作り、壊して直し、止めずに更新できます。 ここから先は、その上に「運用」を積んでいくだけです。
3台のクラスタを手元のVMで組めない場合は、複数台をローカル接続で組めるVPSで同じ構成を再現する手もあります。クラウド VPS byGMO
は初期費用0円の定額制で転送量課金が無く、全プランに月間稼働率99.99%のSLAが付き、4GB(仮想4コア・200GB)が12ヶ月契約で月額 2,618円です(税込、2026-11 時点)。表示月額とは別にサーチャージ費が毎月加算され(4GB・12ヶ月契約なら合計で月 3,927円)、15日間の無料お試しは初回申し込みの1GB/2GB/4GBプランのみで最終日の2営業日前までに解約しないと本契約になるため、3台ぶんの月額を先に計算しておいてください。
参考リンク
- roadmap.sh — Kubernetes
- Kubernetes 公式ドキュメント(日本語)
- Deployment(公式・日本語)
- Service(公式・日本語)
- Ingress(公式・日本語)
- Ingress コントローラの一覧(公式)
- ConfigMap(公式・日本語)
- Secret(公式・日本語)
- kubectl チートシート(公式・日本語)
次に読む
この記事は 【第6段階】インフラとコンテナ の 8 / 25 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
Kubernetes コースの到達作品です。 kubeadm で組んだクラスタにアプリをデプロイし、Podを消しても復活し、止めずに更新するところまで束ねます。

コメント