DeploymentとReplicaSet — 消したPodが戻ってくる

DeploymentとReplicaSet。3つのPodと更新マーク、状態を確認するチェックリスト。

消したPodが戻ってくるのは、DeploymentとReplicaSetが数を保っているからです。その仕組みを確かめます。

前回: Podという最小単位 — 消したPodは戻ってこない

これは【深掘り】の記事です。本線の順路ではありません。 読まなくても先へ進めます。 本線の Kubernetesは「状態を宣言する」 — minikube入門 の続きとして、そこで「宣言した状態が保たれる」と一言で書いたところを、実際に Pod を消して、戻ってくるのを見る回です。

この記事のコマンドは、すべて VM の中(Ubuntu Server)で打ちます。 Windows の PowerShell では打ちません。 前提: 本線の minikube入門 を終えて、kubectl get node が返ること。 この回の前に、VM のスナップショットを取ってください。 イメージを何度も引くので、ディスクを使います。

前回、Pod を1つ手で作って、手で壊しました。壊したあと、こうなりました。

bash
$ kubectl delete pod hello
$ kubectl get pod
No resources found in default namespace.

消えたままです。 ここが引っかかりました。

本線でこう書いたはずでした。

Kubernetes は「この状態であれ」という宣言だから、コンテナを手で消しても戻ってくる。

戻ってきませんでした。 嘘を書いたのかと思いましたが、そうではありませんでした。足りていなかったのは、Pod の面倒を見る人です。

Pod は、それ自体が「保たれるもの」ではありません。 「Pod が1つあるべきだ」と言い続ける誰かがいて、初めて保たれます。

その「言い続ける誰か」が Deployment で、実際に数を数えているのが ReplicaSet です。この記事は、その2人を目で見る回です。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • Pod を直接作ると、消したら戻らないこと。戻すのは Pod の仕事ではなく、上の人の仕事
  • Deployment の selector は「どの Pod を自分の担当と見なすか」の条件であること。作る側ではなく、数える側の設定
  • selector.matchLabels と template.metadata.labels がずれると、そもそも作れないこと。警告ではなくエラーで止まる
  • Deployment → ReplicaSet → Pod の3階層になっていること。Pod には「誰が親か」が書き込まれている
  • イメージを変えると、既存の ReplicaSet が書き換わるのではなく、新しい ReplicaSet が増えること。古いほうは 0 で残る。これが切り戻しの元
  • kubectl scale で増やしても、あとから apply すると YAML の数字に戻ること。手で変えたものは黙って消える
  • Job と CronJob は「終わってよい」仕事であること。Completed は異常ではない

この記事でやること

  1. Deployment の YAML を1行ずつ読んでから apply して、Pod を手で消し、数秒で戻るのを見る
  2. selector とラベルをわざとずらして、エラーで止まるのを確かめる
  3. kubectl get deploy,rs,pod で3階層を1画面に出し、ownerReferences で親子を確認する
  4. イメージを差し替えて、新しい ReplicaSet ができ、古いほうが 0 で残るのを見て、rollout undo で戻す
  5. kubectl scale のあとに apply して、数が戻ってしまう事故を自分で起こす
  6. Job・CronJob を1つ動かして Completed を見る
  7. 作ったものを全部片づける

先に知る言葉

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

言葉意味
Deployment「このアプリを何個、どのイメージで動かすか」を宣言するもの。Pod を直接持たず、ReplicaSet を通して面倒を見る
ReplicaSetPod の数を数え続ける係。足りなければ作り、多ければ消す。それだけをする
レプリカ同じ中身の複製。replicas: 3 は「同じ Pod を3つ」の意味
ラベルリソースに貼る キー: 値 の付箋。名前ではなく、まとめて選ぶための目印
セレクタラベルを条件にして選ぶ書き方。app: web の付箋が貼られたものを全部、という指定
ownerReferencesそのリソースの親が誰かを記録している欄。親を消すと子も消えるのはこれが根拠
ロールアウト新しい版に入れ替えていく作業そのもの。rollout コマンドはその進み具合を見る
リビジョンロールアウト1回ごとに振られる通し番号。戻す先を指すのに使う
Job終わってよい仕事を1回やらせるもの。終わったら Completed になって止まる
DaemonSet全ノードに1つずつ同じ Pod を置くもの。数ではなく「台数分」で決まる

Deployment を作って、Pod を消す

まず、YAML を1行ずつ読む

いきなり apply しません。中身が読めないまま動いたものは、壊れたときに直せません。

VM の中で、作業用のフォルダを作って書きます。

bash
$ mkdir -p ~/k8s-deploy
$ cd ~/k8s-deploy
$ nano web.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.25
          ports:
            - containerPort: 80

上から順に、何を言っているかです。

行意味
apiVersion: apps/v1どの API の言葉で書いているか。Pod は v1 だったが、Deployment は apps/v1。ここを間違えると no matches for kind で弾かれる
kind: Deployment作るものの種類
metadata.name: webこの Deployment の名前。あとで kubectl から指すときの呼び名
spec.replicas: 3Pod をいくつ保つか。「3つ作る」ではなく「常に3つであれ」
spec.selector.matchLabelsどの Pod を自分の担当と見なすかの条件。数を数える対象を決めている
spec.templatePod を作るときの型紙。ここから下は、まるごと Pod の設計図
template.metadata.labels型紙から作られる Pod に貼られるラベル
template.spec.containers中で動かすコンテナ。image と name は必須
containerPort: 80中のコンテナが待ち受けているポート。これを書いても外からは繋がらない(外に出す話は別のリソース)

selector と template.metadata.labels は、役割が違います。

template.metadata.labels … これから作る Pod に貼る付箋 selector.matchLabels … 世の中の Pod のうち、どれを数えるかの条件

貼る付箋と、数える条件。この2つが一致していないと、作った端から「自分の担当ではない」ことになります。 だから Kubernetes は、一致していない YAML を受け取りません。

わざと、ずらしてみる

読んだだけでは腹に落ちないので、先にエラーを出します。

bash
$ nano web-broken.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-broken
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: webserver
    spec:
      containers:
        - name: nginx
          image: nginx:1.25

selector は app: web、貼る付箋は app: webserver。 1文字違いです。

bash
$ kubectl apply -f web-broken.yaml
The Deployment "web-broken" is invalid: spec.template.metadata.labels: Invalid value: map[string]string{"app":"webserver"}: `selector` does not match template `labels`

作られません。 ここが大事なところでした。

「動いたけれど Pod が増え続ける」ではなく、その場で止まります。 一致していない Deployment は、自分が作った Pod を自分で数えられず、足りないと判断して作り続けてしまうからです。Kubernetes 側が先に禁止しています。

エラーの読み方: does not match template labels の一言だけ見れば十分です。selector と labels を見比べる、以上。

正しいほうを適用する

bash
$ kubectl apply -f web.yaml
$ kubectl get pod
NAME                   READY   STATUS    RESTARTS   AGE
web-6b7f8c9d5c-4xk2p   1/1     Running   0          12s
web-6b7f8c9d5c-8vnqz   1/1     Running   0          12s
web-6b7f8c9d5c-t9wl4   1/1     Running   0          12s

3つあります。 名前は web- のあとに2段の乱数が付いています。この2段が、あとで効いてきます。

Pod を消す

ここが山場です。 前回と同じことをします。ただし今回は上に人がいます。

別のターミナルを開けるなら、先に見張りを置くと変化が見えます。

bash
$ kubectl get pod -w

-w は watch(変化があるたびに行が増える)です。止めるのは Ctrl + C。

もう一方のターミナルで、1つ選んで消します。名前は自分の環境のものに読み替えてください。

bash
$ kubectl delete pod web-6b7f8c9d5c-4xk2p

見張り側にこう出ます。

web-6b7f8c9d5c-4xk2p   1/1   Terminating         0     3m
web-6b7f8c9d5c-lq7dr   0/1   Pending             0     0s
web-6b7f8c9d5c-lq7dr   0/1   ContainerCreating   0     0s
web-6b7f8c9d5c-lq7dr   1/1   Running             0     2s

消えた直後に、別の名前の Pod が生まれています。

[スクリーンショット: 01_pod復活.png] kubectl get pod -w を出したまま Pod を1つ削除し、消えた行と新しく生まれた行が並んでいるところを撮ってください。

ここで、ひとつ勘違いを正しておきます。

消した Pod が「復活」したのではありません。 別の Pod が新しく生まれただけです。 名前も違えば、中のファイルも空の状態に戻っています。

保たれているのは「Pod」ではなく「3つという数」です。 これが「あるべき状態を保つ」の実際の中身でした。個体は保証されていません。

念のため数を確認します。

bash
$ kubectl get pod
NAME                   READY   STATUS    RESTARTS   AGE
web-6b7f8c9d5c-8vnqz   1/1     Running   0          4m
web-6b7f8c9d5c-lq7dr   1/1     Running   0          40s
web-6b7f8c9d5c-t9wl4   1/1     Running   0          4m

3つに戻っています。 AGE を見ると、1つだけ若いのが分かります。

3階層を目で見る

「Deployment が Pod を作り直した」と言いたくなりますが、間に1人います。

bash
$ kubectl get deploy,rs,pod
NAME                  READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/web   3/3     3            3           5m

NAME                             DESIRED   CURRENT   READY   AGE
replicaset.apps/web-6b7f8c9d5c   3         3         3       5m

NAME                       READY   STATUS    RESTARTS   AGE
pod/web-6b7f8c9d5c-8vnqz   1/1     Running   0          5m
pod/web-6b7f8c9d5c-lq7dr   1/1     Running   0          1m
pod/web-6b7f8c9d5c-t9wl4   1/1     Running   0          5m

名前をよく見ると、階層が名前に出ています。

web                    ← Deployment
web-6b7f8c9d5c         ← ReplicaSet(Deployment名 + 型紙のハッシュ)
web-6b7f8c9d5c-lq7dr   ← Pod(ReplicaSet名 + 乱数)

deploy rs pod は kubectl の短縮名です。deployment replicaset と打っても同じです。

[スクリーンショット: 02_三階層.png] kubectl get deploy,rs,pod の出力全体を撮ってください。3つのブロックの名前が入れ子になっているのが分かる形でお願いします。

名前ではなく、記録で確かめる

名前が似ているだけでは根拠になりません。Pod 自身が「親は誰か」を持っています。

bash
$ kubectl get pod web-6b7f8c9d5c-lq7dr -o yaml

長いので、ownerReferences の欄だけ抜き出します。

bash
$ kubectl get pod web-6b7f8c9d5c-lq7dr -o yaml | grep -A 8 ownerReferences
  ownerReferences:
  - apiVersion: apps/v1
    blockOwnerDeletion: true
    controller: true
    kind: ReplicaSet
    name: web-6b7f8c9d5c
    uid: 2f1a9d7c-5b3e-4c8a-9f21-6d4e0b7a1c33

親は Deployment ではなく ReplicaSet です。 ここは自分でも取り違えていました。

同じことを ReplicaSet にもやると、その親が Deployment だと出ます。

bash
$ kubectl get rs web-6b7f8c9d5c -o yaml | grep -A 8 ownerReferences
  ownerReferences:
  - apiVersion: apps/v1
    blockOwnerDeletion: true
    controller: true
    kind: Deployment
    name: web
    uid: 8c4b1e60-77a2-41d9-b0f5-3ae9c2d51b48

kubectl delete deploy web で Pod まで全部消えるのは、この記録があるからです。 名前が似ているからではありません。

役割はこう分かれていました。

誰が何をするか
Deployment版(バージョン)の管理。新しい型紙が来たら、新しい ReplicaSet を作って入れ替える
ReplicaSet数の管理だけ。担当の Pod を数えて、足りなければ作り、多ければ消す
Pod実際に動くもの。自分では何も保証しない

ReplicaSet を直接作らない理由

ReplicaSet は単体でも作れます。kind: ReplicaSet と書けば動きます。それでも、まず作りません。

ReplicaSet は、数は保てても、版を入れ替えられないからです。

ReplicaSet のイメージを書き換えても、すでに動いている Pod は古いままです。 ReplicaSet がやるのは「数を数える」ことだけで、中身が古いかどうかは見ていません。 新しくするには、自分で Pod を消して回ることになります。

Deployment は、そこを引き受けます。新しい ReplicaSet を作り、古いほうを減らしながら新しいほうを増やすという段取りをやってくれます。次の節でそれを見ます。

つまり ReplicaSet は「Deployment に使われるための部品」です。 自分で書く場面は、当面ありません。

イメージを変えると何が起きるか

nginx:1.25 を nginx:1.27 にします。やる前に、いま ReplicaSet が1つしかないことを覚えておいてください。

bash
$ kubectl set image deployment/web nginx=nginx:1.27

nginx= の左は YAML に書いたコンテナ名(containers[].name)です。イメージ名ではありません。ここを間違えると unable to find container named ... で怒られます。

すぐに見ます。

bash
$ kubectl get rs
NAME             DESIRED   CURRENT   READY   AGE
web-6b7f8c9d5c   0         0         0       12m
web-7d9c4f5b88   3         3         3       25s

ReplicaSet が2つになりました。

  • 古いほう(web-6b7f8c9d5c)は 0 … 消えたのではなく、数がゼロで残っている
  • 新しいほう(web-7d9c4f5b88)が 3 … いま動いているのはこちら

書き換わったのではなく、増えました。 ここが一番の発見でした。

古い ReplicaSet が 0 で残っているのは、ゴミではありません。 これが「戻せる」ということの、実体です。

0 のまま残っているので、数字を戻すだけで、古い版がそのまま復活します。 戻すための情報が、どこかの記録ではなく動いている物として残っているわけです。

[スクリーンショット: 03_replicaset2つ.png] kubectl get rs で、古い ReplicaSet が 0、新しいほうが 3 で並んでいるところを撮ってください。

Pod のイメージも見ておきます。

bash
$ kubectl get pod -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.spec.containers[0].image}{"\n"}{end}'
web-7d9c4f5b88-2mdrx   nginx:1.27
web-7d9c4f5b88-9c8kt   nginx:1.27
web-7d9c4f5b88-hs4vq   nginx:1.27

Pod の名前も全部変わっています。 更新とは、中身の差し替えではなく、作り直しでした。

履歴を見る

bash
$ kubectl rollout history deployment/web
deployment.apps/web
REVISION  CHANGE-CAUSE
1         <none>
2         <none>

リビジョンが2つ。 ReplicaSet が2つあったことと、そのまま対応しています。

CHANGE-CAUSE が <none> なのは、理由を書いていないからです。書けます。

bash
$ kubectl annotate deployment/web kubernetes.io/change-cause="nginx 1.25 -> 1.27" --overwrite

以後の更新には、この文字列が履歴に残ります。あとで自分が読むためのものです。

戻す

bash
$ kubectl rollout undo deployment/web
$ kubectl get rs
NAME             DESIRED   CURRENT   READY   AGE
web-6b7f8c9d5c   3         3         3       18m
web-7d9c4f5b88   0         0         0       6m

数字が入れ替わっただけです。 新しいイメージを引き直してもいません。0 で残っていたほうを、また 3 にした。それだけでした。

イメージも戻っています。

bash
$ kubectl get pod -o jsonpath='{range .items[*]}{.spec.containers[0].image}{"\n"}{end}'
nginx:1.25
nginx:1.25
nginx:1.25

ここで確かめたかったのは、1つだけです。

戻せる。

「どういう順番で入れ替わるのか」「入れ替え中に止まらないのか」といった話は、この記事では扱いません。まず「戻せる」ことが分かっていれば、更新を試すのが怖くなくなります。 実際、この確認をしてから触り方が変わりました。

進み具合を見たいときはこれです。更新が終わるまで返ってこないので、動きが分かります。

bash
$ kubectl rollout status deployment/web
deployment "web" successfully rolled out

スケールする — そして事故を起こす

数を増やします。2つやり方があり、そこに落とし穴があります。

やり方1: コマンドで増やす

bash
$ kubectl scale deployment/web --replicas=5
$ kubectl get pod
NAME                   READY   STATUS    RESTARTS   AGE
web-6b7f8c9d5c-8vnqz   1/1     Running   0          20m
web-6b7f8c9d5c-c4tzp   1/1     Running   0          8s
web-6b7f8c9d5c-lq7dr   1/1     Running   0          16m
web-6b7f8c9d5c-nx6bd   1/1     Running   0          8s
web-6b7f8c9d5c-t9wl4   1/1     Running   0          20m

5つになりました。 速いです。

そのあと apply すると、黙って3に戻る

このあと、YAML の別の場所(たとえばラベルの追加)を直したくなったとします。web.yaml の replicas は 3 のままです。

bash
$ kubectl apply -f web.yaml
$ kubectl get pod
NAME                   READY   STATUS    RESTARTS   AGE
web-6b7f8c9d5c-8vnqz   1/1     Running   0          22m
web-6b7f8c9d5c-lq7dr   1/1     Running   0          18m
web-6b7f8c9d5c-t9wl4   1/1     Running   0          22m

3つに戻っています。 警告も確認も出ません。

これを実際にやって、しばらく原因が分かりませんでした。「増やしたはずなのに減っている」という状態です。

apply は「差分を当てる」のではなく、「このファイルの通りにしろ」と言っています。 ファイルに replicas: 3 と書いてある以上、5 は間違いです。

手で増やしたことは、ファイルには書かれていません。 だから消えます。Kubernetes が正しく、こちらが間違っていました。

やり方2: ファイルを直して apply

普段はこちらだけにします。

bash
$ nano web.yaml
spec:
  replicas: 5
bash
$ kubectl apply -f web.yaml
$ kubectl get deploy web
NAME   READY   UP-TO-DATE   AVAILABLE   AGE
web    5/5     5            5           23m

kubectl scale は「今すぐ増やす」ための応急処置です。手が空いたら、必ずファイルに反映して apply し直す。 そうしないと、次の apply で黙って戻ります。

(kubectl scale が要らないわけではありません。障害の最中に YAML を開いている余裕はありません。「あとで書き戻す」を忘れないだけです。)

apply と create と replace の違い

ここまで apply しか使っていませんが、似たコマンドが3つあります。

コマンドやること同じものが既にあると使う場面
kubectl create -f新しく作るエラー(already exists)一度きりの作成。手で試すとき
kubectl replace -fまるごと置き換える置き換わる(無いとエラー)ほぼ使わない
kubectl apply -fこの内容であれ、と宣言する差分だけ反映される普段はこれだけ

create と apply の差が出るのは、2回目です。

bash
$ kubectl create -f web.yaml
Error from server (AlreadyExists): error when creating "web.yaml": deployments.apps "web" already exists
bash
$ kubectl apply -f web.yaml
deployment.apps/web configured

apply は2回目以降も同じコマンドで通ります。 これが効いてきます。

同じコマンドを何回打っても、同じ結果になる。 だから、「いまどうなっているか」を気にせずに実行できます。

replace はまるごと差し替えるので、YAML に書いていない設定(あとから手で足したもの)が消えます。 apply は書いていない部分を残します。この違いが、事故の分かれ目です。

この記事以降、宣言的に使うなら apply だけを使います。 create は打ち捨てのテスト、replace は使わない、で通せます。

Job と CronJob — 終わってよい仕事

ここまでの Deployment は、終わらないものが前提でした。nginx は止まったら異常です。

世の中には、終わってよい仕事があります。 バックアップ、集計、データの取り込み。これを Deployment で動かすと、終わるたびに「落ちた」と判断されて再起動されます。

そのための入れ物が Job です。

bash
$ nano hello-job.yaml
apiVersion: batch/v1
kind: Job
metadata:
  name: hello-job
spec:
  template:
    spec:
      restartPolicy: Never
      containers:
        - name: hello
          image: busybox:1.36
          command: ["sh", "-c", "echo start; sleep 5; echo done"]

Deployment と違う点は3つだけです。

行意味
apiVersion: batch/v1Job は apps ではなく batch の側にいる
restartPolicy: Never終わっても再起動しない。Job では Never か OnFailure しか書けない
selector が無いJob が自分で付けるので、書かない
bash
$ kubectl apply -f hello-job.yaml
$ kubectl get job,pod

数秒待ってから、もう一度。

bash
$ kubectl get job,pod
NAME                  STATUS     COMPLETIONS   DURATION   AGE
job.batch/hello-job   Complete   1/1           7s         20s

NAME                  READY   STATUS      RESTARTS   AGE
pod/hello-job-x4mq2   0/1     Completed   0          20s

Completed です。異常ではありません。 READY が 0/1 なのも正常で、もう動いていないからです。

[スクリーンショット: 04_job完了.png] kubectl get job,pod で、Job が Complete、Pod が Completed になっているところを撮ってください。

出力も残っています。

bash
$ kubectl logs job/hello-job
start
done

Pod が終わっても、消さない限りログは読めます。 ここが Job の要点でした。終わった仕事の結果を、あとから確認できます。

CronJob — 時間になったら Job を作る

bash
$ nano hello-cron.yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: hello-cron
spec:
  schedule: "*/1 * * * *"
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: Never
          containers:
            - name: hello
              image: busybox:1.36
              command: ["sh", "-c", "date; echo tick"]

schedule の書き方は Linux の cron と同じです。*/1 * * * * で毎分。学習用に短くしています。

bash
$ kubectl apply -f hello-cron.yaml

1〜2分待ってから見ます。

bash
$ kubectl get cronjob,job
NAME                     SCHEDULE      SUSPEND   ACTIVE   LAST SCHEDULE   AGE
cronjob.batch/hello-cron */1 * * * *   False     0        30s             2m

NAME                            STATUS     COMPLETIONS   DURATION   AGE
job.batch/hello-cron-29294761   Complete   1/1           4s         90s
job.batch/hello-cron-29294762   Complete   1/1           3s         30s

CronJob が Job を作り、Job が Pod を作っています。 また3階層です。Deployment → ReplicaSet → Pod と同じ形で、ここでも「上の人が下を作る」になっています。

毎分の CronJob を放置すると、Completed の Pod が溜まり続けます。 この記事の最後で必ず消します。

DaemonSet — 数ではなく、台数分

もう1つだけ触れておきます。DaemonSet は、replicas を書きません。

全ノードに、1つずつ置く。 ノードが増えたら自動で増え、減ったら消える。

ログ収集や監視のように、「どのマシンにも1つ要る」もののための入れ物です。今の minikube は1台なので、作っても1つしか出ません。それでも、replicas が無い理由は分かります。数は自分で決めるものではなく、ノードの数で決まるからです。

いま動いているものを見るだけにします。

bash
$ kubectl get daemonset -A
NAMESPACE     NAME         DESIRED   CURRENT   READY   AGE
kube-system   kube-proxy   1         1         1       3h

-A は全ネームスペースの意味です。Kubernetes 自身が DaemonSet を使っています。 kube-proxy は各ノードに1つ必要なもので、まさに DaemonSet 向きでした。

つまずいたところ

1. Pod を消しても戻らないのは、Kubernetes のせいだと思った

本線を書いた直後、kubectl run で作った Pod を消して、戻ってこないのを見て混乱しました。 「宣言的」という説明が間違っていると思いました。

間違っていたのは、kubectl run で Pod を直接作っていたことです。 Pod は保たれる対象ではなく、保たれる結果でした。上に Deployment を置いた瞬間に、説明どおりに動きました。

2. selector を「作るときの条件」だと読んでいた

selector.matchLabels を、「このラベルを付けて作れ」 の意味だと読んでいました。だから template.metadata.labels と2箇所に同じことを書くのが冗長に見えて、片方を消そうとしました。どちらを消してもエラーになります。

貼る(labels)と、探す(selector)は別の動作です。ここが分かってから、この重複が冗長ではなくなりました。ReplicaSet は「自分が作ったから」ではなく「条件に合うから」で数えています。

3. kubectl set image でコンテナ名を間違えた

bash
$ kubectl set image deployment/web nginx:1.27
error: at least one image update is required

コンテナ名=イメージ の形が要ります。しかも左はコンテナ名で、イメージ名ではありません。 YAML の containers[].name を nginx にしていたので、たまたま同じ字面になっていて、しばらく気づきませんでした。

あとから、コンテナ名は役割で付けるほうがよいと思いました。 nginx ではなく web のように付けておけば、この取り違えは起きません。

4. kubectl scale した分が消えて、原因が分からなかった

上に書いた事故です。5に増やして、別件で apply して、3に戻っていました。 Pod が落ちたのかと思って describe や logs を見に行きましたが、どこにも異常はありません。 当然で、異常ではなかったからです。

「消えた」ではなく「戻された」と気づくのに時間がかかりました。kubectl get deploy の READY が 3/3 で揃っているのが手がかりでした。落ちたなら 3/5 のような形になります。

5. Completed の Pod をエラーだと思って消し続けた

Job を動かしたあと、kubectl get pod に Completed が残っているのが気持ち悪くて、毎回消していました。 消すとログも読めなくなります。

Completed は終わった証拠で、残っているのが正常です。 消すのは、ログを読み終わってからでした。

6. 毎分の CronJob を止め忘れた

*/1 * * * * を試して、そのまま別の作業をしていました。戻ってきたら Pod が数十個になっていました。VM が重くなるほどではありませんでしたが、kubectl get pod が読めません。

学習用に短い間隔を試すときは、確認したその場で消すか、止めておきます。

bash
$ kubectl patch cronjob hello-cron -p '{"spec":{"suspend":true}}'

suspend: true で、消さずに止められます。 false に戻せば再開します。

後片づけ

作ったものを全部消します。 順番は気にしなくて構いません。

まず、ファイルから作ったものはファイルで消します。

bash
$ cd ~/k8s-deploy
$ kubectl delete -f web.yaml
$ kubectl delete -f hello-job.yaml
$ kubectl delete -f hello-cron.yaml
deployment.apps "web" deleted
job.batch "hello-job" deleted
cronjob.batch "hello-cron" deleted

Deployment を消せば、ReplicaSet も Pod も消えます。 ownerReferences で親子が繋がっているからです。手で Pod を消して回る必要はありません。

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

bash
$ kubectl get deploy,rs,pod,job,cronjob
No resources found in default namespace.

No resources found が出れば片づいています。

Completed の Pod だけが残っているときは、これで消えます。

bash
$ kubectl delete pod --field-selector=status.phase==Succeeded

minikube ごと止めるなら、こうです。

bash
$ minikube stop

消さずに止めるだけなので、次回 minikube start で続きから使えます。まっさらにしたいときだけ minikube delete を使います。delete はクラスタごと消えるので、引いたイメージも消えます。

まとめ

理解できたこと。

  • Pod は、それ自体では保たれない。 消したら消えたままなのは正常で、保つ人(Deployment)を置いて初めて「宣言した状態」になる
  • 保たれているのは「その Pod」ではなく「数」。消した Pod は復活せず、別の Pod が生まれている。名前も中身も新品
  • selector.matchLabels は探す条件、template.metadata.labels は貼る付箋。 別の動作なので2箇所に書く。ずれていると、その場でエラーになって作れない
  • Deployment → ReplicaSet → Pod の3階層。 根拠は名前の似方ではなく ownerReferences。Pod の親は Deployment ではなく ReplicaSet
  • ReplicaSet を直接作らないのは、数は保てても版を入れ替えられないから。 Deployment に使われる部品
  • イメージを変えると、新しい ReplicaSet が増える。古いほうは 0 で残る。 この「0 で残っているもの」が、そのまま切り戻しの実体。だから rollout undo は速い
  • kubectl scale で増やした分は、次の apply で黙って戻る。 apply は差分を当てているのではなく、ファイルの通りにしろと言っている
  • create は2回目でエラー、replace は書いていない設定を消す。apply だけを使う
  • Job と CronJob は終わってよい仕事。Completed は異常ではなく、消さない限りログが読める
  • DaemonSet に replicas が無いのは、数がノードの数で決まるから

この回でいちばん効いたのは、古い ReplicaSet が 0 で残っているのを見たことでした。 「戻せる」が、記録ではなく物として残っていると分かってから、更新を試すのが怖くなくなりました。

参考リンク


次に読む

この記事は 【深掘り】Kubernetes の 3 / 15 本目です。

記事
← 前の記事Podという最小単位 — 消したPodは戻ってこない
→ 次の記事Serviceで宛先を固定する — PodのIPは翌日には変わる

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

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

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

DevOps›Kubernetes — Deployments
  • Deployment / ReplicaSet / 数を保つ仕組み
  • Job / CronJob / DaemonSet

この記事は、上の項目を実際に手を動かして確かめる回です。

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

コメント

コメントする

目次