壊れても直り、止めずに更新 — Kubernetesの到達作品

Kubernetesの到達作品。コンテナのブロックと復旧の矢印、更新を表す部品。

※本記事はアフィリエイト広告(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 は「暗号化」ではないこと

この記事でやること

  1. アプリを Deployment(replicas 3)としてマニフェストで宣言し、3台のノードに散らす
  2. Service を置いて、安定した入口を作る(Pod のIPが変わっても壊れない)
  3. Ingress で外に出し、Windows のブラウザから実際に開く(山場)
  4. Pod を1つ消して、勝手に復活するのを見る(自己修復)
  5. アプリの版を、無停止で入れ替える(ローリング更新)。そして戻す(ロールバック)
  6. ConfigMap と Secret で、設定と秘密をアプリから分ける
  7. 完成の判定(6つのチェック)を自分で通し、後片づけする

先に知る言葉

この記事で軸になる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
Deployment「このアプリを◯個、この版で保て」という宣言。数が減ると自分で足す
ReplicaSetDeployment が裏で作る、レプリカ数を守る係。「3個」を実際に見張っているのはこれ
Service(ClusterIP)変わらない内部の入口。裏の Pod が入れ替わっても、宛先はこの1つ
EndpointsService がいま振り分けている Pod のIP一覧。Pod が増減すると自動で書き換わる
NodePort各ノードのポートを開けて、外から Service に入れる簡単な方法
Ingressホスト名やパスで振り分ける、外からの入口。Webの表玄関にあたる
Ingress コントローラIngress の中身を実際に動かす部品。これを入れないと Ingress は効かない
ConfigMap設定値を入れておく箱。アプリ本体(イメージ)から設定を切り離す
Secret秘密を入れておく箱。base64 で符号化されるだけで、暗号化ではない
ローリングアップデート古い Pod を1つずつ新しいものに置き換える更新のしかた。止めずに入れ替える

① まず「何を、どう宣言するか」を決める

最初に、この記事でいちばん大事なルールを置きます。

手で立てない。全部マニフェスト(YAML)で宣言する。

前回・前々回で、こういうコマンドを見たかもしれません。

bash
$ kubectl run web --image=nginx

これは動きます。 でも、到達作品ではこれを使いません。 理由は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 で:

bash
$ mkdir -p ~/capstone
$ cd ~/capstone

これ以降のマニフェストは、全部この ~/capstone/ の中に置きます。 このフォルダごと残しておけば、それがあなたの「作品の設計図一式」になります。あとでGitOps の回で、このフォルダをそのまま Git に載せます。

最初のアプリは、いちばん確実に動く nginx にします。 「自分のアプリ」に差し替えるのは、⑤と⑥のあと、動く形が手に入ってからにします。最初から自作イメージにすると、アプリのバグとKubernetesの設定ミスの、どちらで詰まったか分からなくなるからです。


② Deployment で3レプリカ — 数を保つ仕組み

1つ目のマニフェストを書きます。cp1 で:

bash
$ nano ~/capstone/deployment.yaml
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.matchLabelsDeployment が「自分の Pod」を見分ける目印。下の labels と一致させる
templatePod の設計図。この形の Pod を3つ作る
image: nginx:1.27.0版(タグ)を固定する。 latest にしない(⑤で理由が分かります)

selector と template.metadata.labels は必ず一致させます。 ここがずれると、Deployment は「自分の Pod が0個だ」と思い込んで、Pod を無限に作ろうとします。 よくある最初の事故です。

適用します。

bash
$ kubectl apply -f ~/capstone/deployment.yaml
$ kubectl get pods -o wide
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 を足しません。

bash
$ sed -i 's/replicas: 3/replicas: 5/' ~/capstone/deployment.yaml
$ kubectl apply -f ~/capstone/deployment.yaml
$ kubectl get pods

5つに増えます。 戻します。

bash
$ sed -i 's/replicas: 5/replicas: 3/' ~/capstone/deployment.yaml
$ kubectl apply -f ~/capstone/deployment.yaml

これが「宣言」の意味です。 「2つ足せ」ではなく「5であれ」と言う。いまが何個かをこちらが数えない。 クラスタが差分を埋めます。この考え方が、④の自己修復にそのまま繋がります。

「3個を保つ係」の正体を見る

Deployment が直接 Pod を見張っているわけではありません。 間に ReplicaSet という係がいます。

bash
$ kubectl get 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 でもできます。

bash
$ kubectl scale deployment/web --replicas=4
$ kubectl get pods
$ kubectl scale deployment/web --replicas=3

ただし 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 で:

bash
$ nano ~/capstone/service.yaml
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)のポート
bash
$ kubectl apply -f ~/capstone/service.yaml
$ kubectl get service web
$ kubectl get endpoints web
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 の「名前」で叩きます。

bash
$ kubectl run tmp --image=curlimages/curl --restart=Never --rm -it -- \
    sh -c 'for i in 1 2 3 4 5 6; do curl -s -o /dev/null -w "%{http_code}\n" web; done'
200
200
200
200
200
200

web という名前でIPも書かずに繋がったことに注目してください。クラスタ内では、Service 名がそのままホスト名になります(CoreDNS が解決しています)。IPを一切書いていないから、Pod が入れ替わっても壊れません。

Service が「いま」どの Pod へ流しているかは、describe で見えます。

bash
$ kubectl describe service web | grep -E "Selector|Endpoints"
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行だけ足します。

bash
$ nano ~/capstone/service.yaml
apiVersion: v1
kind: Service
metadata:
  name: web
spec:
  type: NodePort
  selector:
    app: web
  ports:
    - port: 80
      targetPort: 80
      nodePort: 30080
bash
$ kubectl apply -f ~/capstone/service.yaml

Windows の PowerShell から、ワーカーのIPと 30080 番で叩きます。

PowerShell
PS> curl.exe http://192.168.226.51: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 コントローラを選んでください。

bash
$ kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.11.3/deploy/static/provider/baremetal/deploy.yaml

コントローラの Pod が立つのを待ちます。

bash
$ kubectl get pods -n ingress-nginx --watch

ingress-nginx-controller-xxxx が Running(1/1)になったら Ctrl + C で止めます。 その入口ポートを見ます。

bash
$ kubectl get service -n ingress-nginx ingress-nginx-controller
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 へ流せ」というルールを書きます。

bash
$ nano ~/capstone/ingress.yaml
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本だけです。

bash
$ kubectl apply -f ~/capstone/ingress.yaml
$ kubectl get ingress web
NAME   CLASS   HOSTS       ADDRESS         PORTS   AGE
web    nginx   web.local   192.168.226.51  80      15s

ルールがどう解釈されたかは、describe で確かめられます。

bash
$ kubectl describe ingress web
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)で、監視を始めます。

bash
$ kubectl get pods -w

このまま流しっぱなしにします。 -w(watch)は、変化があるたびに行を足していきます。

もう1つ cp1 のターミナルを開いて(Windows から ssh をもう1本)、Pod を1つ、名前を指定して消します。

bash
$ kubectl get pods
$ kubectl delete pod web-6b7d9c4f8-2xk9p

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に戻ります。

bash
$ kubectl get pods

これが「壊れても直る」の正体です。魔法ではありません。 ②で replicas: 3 と宣言しました。裏で ReplicaSet が「3個であれ」を見張っています。1個消えて2個になった瞬間、宣言(3)と現実(2)が食い違う。 だから足す。それだけです。

前回(ノード落ち)との違い

前回は「ノードごと」落として、Pod が移るのに約5分かかりました。 今回は「Pod 1つ」を消して、数秒で戻りました。この差は、どちらも同じ仕組みの別の側面です。

壊し方気づくまでなぜ
Pod を消す(今回)数秒クラスタは「消えた」を即座に知っている(自分が消した相手だから)
ノードが落ちる(前回)約5分「返事がないだけか、本当に死んだか」を見極める猶予(前回の話)

どちらも「宣言した状態に、現実を寄せ続けている」だけです。あなたは何も打っていません。 そこがコースを通して繰り返してきた、Kubernetes の一番の値打ちです。

「気づいて、直した」記録が残っている

「勝手に直った」を、気のせいで済ませません。 クラスタは、自分が何をしたかを記録しています。

bash
$ kubectl get events --sort-by=.lastTimestamp | tail -n 6
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 に、更新のしかたを書き足します。

bash
$ nano ~/capstone/deployment.yaml
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つも下回ってはならない」。 これが「無停止」の実体
bash
$ kubectl apply -f ~/capstone/deployment.yaml

maxUnavailable: 0 が、この節の主役です。 これがあると、新しい Pod が「使える」状態になるまで、古い Pod は落ちません。 だから、いつでも3つ(以上)が生きています。「無停止」は祈りではなく、設定の結果です(この1行だけで足りない場合は「つまずいたところ」へ)。

更新中も切れないことを、目で見る

まず、絶え間なくアクセスし続ける見張りを、クラスタ内から動かします。

bash
$ kubectl run probe --image=curlimages/curl --restart=Never --rm -it -- \
    sh -c 'while true; do curl -s -o /dev/null -w "%{http_code} " web; sleep 0.3; done'

200 200 200 ... が流れ続けます。 これを流したまま、別のターミナル(cp1)で版を上げます。

bash
$ kubectl set image deployment/web nginx=nginx:1.27.3
$ kubectl rollout status deployment/web
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つ作って、古いほうを空にしていく」ことです。 目で見えます。

bash
$ kubectl get replicaset
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 が途切れていないところを撮ってください。

失敗したら、戻す

更新は失敗します。 存在しないタグを指してしまった、新しい版が起動しない、など。やってみます。

bash
$ kubectl set image deployment/web nginx=nginx:9.99-does-not-exist
$ kubectl rollout status deployment/web --timeout=60s

新しい Pod がイメージを取得できず、ImagePullBackOff で止まります。

bash
$ kubectl get pods

ここで maxUnavailable: 0 が効いています。 新しい Pod が「使える」にならないので、古い Pod は落ちていません。 つまりサービスはまだ古い版で生きています。 更新は「進めない」だけで、「壊れた」わけではありません。

1コマンドで、直前の版に戻します。

bash
$ kubectl rollout undo deployment/web
$ kubectl rollout status deployment/web

失敗した Pod が消え、動いていた版に戻ります。

bash
$ kubectl rollout history deployment/web

rollout undo が使えるのは、Deployment が「これまでの版」を覚えているからです。手で kubectl run していたら、戻る先がありません。 ①で「宣言で作る」と決めたことが、ここで効いています。


⑥ 設定と秘密を、アプリから分ける

最後に、実際のアプリに必要な「設定」と「秘密」を扱います。

設定値(接続先、動作モードなど)や秘密(パスワード、APIキー)を、イメージの中に焼き込んではいけません。 焼き込むと、設定を変えるたびにイメージを作り直すことになり、秘密がイメージに残ります。 Kubernetes では、これを箱に分けます。

ConfigMap — 秘密でない設定

bash
$ nano ~/capstone/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: web-config
data:
  APP_ENV: "staging"
  GREETING: "Hello from ConfigMap"
bash
$ kubectl apply -f ~/capstone/configmap.yaml

Secret — 秘密(中身はダミー)

秘密は Secret に入れます。 ここで入れるパスワードは、この記事用のダミーです。本物を打たないでください。

bash
$ kubectl create secret generic web-secret \
    --from-literal=DB_PASSWORD='dummy-password-change-me'

dummy-password-change-me は、練習用のでたらめな文字列です。 実在のパスワードでは絶対にやらないでください。理由は、すぐ下で分かります。

Secret は「暗号化」ではない

「秘密の箱」と聞くと暗号化されている気がしますが、違います。 中身を取り出してみます。

bash
$ kubectl get secret web-secret -o jsonpath='{.data.DB_PASSWORD}' | base64 -d
$ echo
dummy-password-change-me

打ち込んだ文字が、そのまま読めました。 Secret は base64 で符号化されているだけで、base64 は「暗号」ではなく「文字の並べ替え」です。誰でも元に戻せます。 つまり Secret の値打ちは「暗号化」ではなく「ConfigMap と扱いを分けられること」——アクセス権を別に絞れる、kubectl get の一覧に平文で出にくい、といった運用上の分離です。本当に守るには、保存時の暗号化などを別途かけます(この掘り下げは別の回に譲ります)。まずは「Secret ≠ 暗号化」を体で知っておくことが大事です。

アプリに、環境変数として渡す

Deployment の containers に、ConfigMap と Secret を環境変数として差します。

bash
$ nano ~/capstone/deployment.yaml

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.configMapRefConfigMap の中身を、まとめて環境変数にする(APP_ENV と GREETING)
env + secretKeyRefSecret の1つの値を、DB_PASSWORD という環境変数にする
bash
$ kubectl apply -f ~/capstone/deployment.yaml

template(Pod の中身)を変えて apply したので、⑤のローリング更新が自動で走ります。 設定を変えただけでも、Pod は作り直されます。「変えたら、宣言に合わせて置き換わる」が、ここでも一貫しています。

新しい Pod に、値がちゃんと渡っているか確かめます。

bash
$ kubectl exec deploy/web -- sh -c 'echo $APP_ENV / $GREETING / $DB_PASSWORD'
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.yamlDeploymentPod を3つ、この版で保つConfigMap / Secret を参照
service.yamlServiceラベル app=web の Pod へ振り分けるDeployment の Pod
ingress.yamlIngressweb.local を Service web へ流すService
configmap.yamlConfigMapAPP_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 で:

bash
$ kubectl get deployment,pods,service,ingress,configmap,secret -o wide

1つでも通らなかったら、それがこのコースで「まだ手が届いていない場所」です。 そこだけ、対応する回に戻ればいい。この判定リストが、「触った」を「作れる」に変えます。

最後の証明:まっさらから、1コマンドで立て直す

「宣言で作った」ことの、いちばん強い証拠を見せます。 作品を全部消して、フォルダから丸ごと立て直します。

cp1 で、いったん全部消します。

bash
$ kubectl delete -f ~/capstone/

Deployment も Service も Ingress も ConfigMap も消えます。 そして、同じフォルダから、もう一度立てます。

bash
$ kubectl apply -f ~/capstone/
$ kubectl get 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 で、フォルダごと一括で消せます。 宣言で作ったので、宣言で消せます。

bash
$ kubectl delete -f ~/capstone/

Ingress コントローラも消すなら:

bash
$ kubectl delete namespace ingress-nginx

残っていないか確認します。

bash
$ kubectl get deployment,service,ingress

Secret を消す

bash
$ kubectl delete secret web-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台ぶんの月額を先に計算しておいてください。

参考リンク


次に読む

この記事は 【第6段階】インフラとコンテナ の 8 / 25 本目です。

記事
← 前の記事1台落としてもPodは移る — kubeadmで組む3台クラスタ
→ 次の記事Helmは結局YAMLを作るだけ — Kubernetesのパッケージ管理

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Kubernetes コースの到達作品です。 kubeadm で組んだクラスタにアプリをデプロイし、Podを消しても復活し、止めずに更新するところまで束ねます。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次