Kubernetesは要るのか — 1台で足りるなら入れない

※本記事はアフィリエイト広告(PR)を含みます。

1台で足りるうちは、Kubernetesを入れないほうが速く進みます。入れない条件を先に決めます。

前回: Kubernetesは「状態を宣言する」 — minikube入門

これは【深掘り】の記事です。本線の順路ではありません。 読まなくても先へ進めます。 本線の Kubernetesは「状態を宣言する」 — minikube入門 の続きとして、そこで「Kubernetes は宣言する仕組みです」と一言で通り過ぎたところを、「では、なぜそれが要るのか」「どこからが要らないのか」まで戻ってやり直す回です。

この記事のコマンドは、断りがない限りすべてVMの中(Ubuntu Server)で打ちます。 Windows の PowerShell で打つものは、そのつど「ホストの PowerShell」と書きます。 前提: Composeなら1コマンド — 複数コンテナをまとめるまで終わっていて、docker compose version が通ること。 この記事は、Kubernetes の【深掘り】シリーズの1本目です。 ここだけはKubernetesをほとんど動かしません。 動かすのは Docker Compose です。


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

目次

先にメモリを確認してください

このシリーズは、途中からメモリを本気で食います。 1本目のうちに測っておきます。

bash
$ free -h
$ nproc
$ df -h /
               total        used        free      shared  buff/cache   available
Mem:           7.8Gi       521Mi       6.6Gi       1.0Mi       901Mi       7.0Gi
Swap:             0B          0B          0B

見るのは Mem: の行の total です。available(いま空いている量)ではありません。VMに何GB割り当ててあるかを見ています。

total の値このシリーズでの進め方
8GB 以上本線で組んだ kubeadm の3台クラスタをそのまま使えます。いちばん本物に近い
4GB 以上 8GB 未満kind(Docker の中にクラスタを作るツール)を使ってください。1台のVMに収まります
2GB 以上 4GB 未満kind の1ノード構成なら、ぎりぎり動きます。複数ノードは諦めてください
2GB 未満手を動かすのは無理です。 ただしこの1本目は読むだけで完結します(動かすのは Compose だけなので)

足りないときの選択肢は3つです。

  1. VMware でVMのメモリ割り当てを増やす(VMをシャットダウンしてから設定を変える。ホスト側の物理メモリを超えないこと)
  2. kind に切り替える(この記事の最後で入れ方を書きます)
  3. この1本目だけ読んで、続きは後日にする

ホストのWindowsが使う分を残してください。 ホストの物理メモリが16GBなら、VMに渡すのは8GBまでにしておくと安全です。全部渡すとホストごと固まります。


前回、minikube を動かして Pod を消して、勝手に復活するところを見ました。動いたので満足したのですが、そのあとが良くなかったです。

自分の小さな個人サイトを、Kubernetes に載せ替えようとしました。

結果、3日溶かしました。

  • 1日目: マニフェストを書く。Ingress が動かない。kubectl get ingress は ADDRESS が空のまま
  • 2日目: Ingress コントローラを入れていないと気づく。入れる。今度は証明書が出ない
  • 3日目: cert-manager を入れる。DNS の設定を間違えて、証明書の発行が5回失敗してレート制限に当たる

3日かけて到達したのは、Docker Compose で30分だった状態です。 機能はひとつも増えていません。

そこで、やっと考えました。

自分は、Kubernetes に何を解いてほしかったのか。

答えは何も無かったです。サーバーは1台。落ちても数分待てる。運用しているのは自分1人。アクセスは1日数百。 この4つが揃っているなら、Kubernetes は要りません。 私はそれを、3日払ってから知りました。

だからこの記事は、「入れる理由」より先に「入れない条件」を決めます。 そのうえで、入れる場合に何が解けるのかを、Compose で実際に困ってみることで確かめます。

この記事でわかること

  • Kubernetes が解いている問題は4つのうち3つであること。「落ちたら再起動」は Compose でも解けるので、それは Kubernetes を入れる理由にならない
  • Compose では絶対に解けない問題がはっきりあること。ホストごと落ちたとき、台数を増やすとき、無停止で入れ替えるときの3つ
  • Kubernetes の部品は暗記するものではないこと。「誰が何を担当するか」で並べると、6つの名前は全部その3つの問題から出てくる
  • 宣言的とは「あるべき状態を置いておくと、誰かが差を埋めに来る」という意味であること。spec と status という2つの欄がAPIに実在する
  • 入れない条件を先に決めないと、必ず入れてしまうこと。1台 / 数分待てる / 1人 / 安定の4つが揃うなら入れない
  • 学習コストの正体は「概念の数」ではなく「壊れたときに見る場所の数」であること

この記事でやること

  1. ~/k8slab に、小さなアプリを Docker Compose で立てる
  2. そのアプリを4通りの方法で困らせる(プロセスを殺す / ホストごと落とす / 台数を増やす / 無停止で入れ替える)
  3. 4つのうち、Compose で解けたものと解けなかったものを表にする
  4. Kubernetes の6つの部品を、いま困った内容に対応させて並べる
  5. kubectl で spec と status を1回だけ見て、「あるべき状態」と「いまの状態」を確かめる
  6. 入れない条件・入れる条件を、自分の環境に当てはめて決める

先に知る言葉

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

言葉意味
オーケストレーション複数のコンテナを、複数のサーバーにまたがって配置・維持すること。「指揮」の意味。Kubernetes はこれをやる道具
コントロールプレーンクラスタの頭脳側。何をどこで動かすかを決める側で、アプリ自体は動かさない
データプレーン実際にアプリのコンテナが動く側。ワーカーノードのこと
spec(スペック)Kubernetes のオブジェクトの中の、「こうあってほしい」を書く欄。人が書く
status(ステータス)同じオブジェクトの中の、「いまこうなっている」を書く欄。人は書かない。機械が書く
調整ループ(reconciliation loop)spec と status の差を見つけて、埋めようとし続ける処理。Kubernetes の動作原理そのもの
kindDocker のコンテナをノードに見立てて、その中にクラスタを作るツール。名前は Kubernetes IN Docker の略。軽い
ローリングアップデート古いものを全部止めてから新しいものを起動するのではなく、少しずつ入れ替えて、止まらないようにするやり方

Compose で、実際に困ってみる

「Kubernetes は便利です」と言われても納得できないのは、困った経験が無いからです。 先に困ります。

作るのは、この2つだけです。

サービス中身役割
webnginx外から見えるWebサーバー
apinginx(別ポート)web が中で呼ぶ、裏側のサービス

「アプリ」と呼べるほどのものではありませんが、困らせるには十分です。

置き場所を作る

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

この記事で作るものは、全部この中に入ります。 後片づけはフォルダごと消せば済みます。

Compose ファイルを書く

bash
$ nano compose.yaml
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
  api:
    image: nginx:alpine

api には ports: を書いていません。 外から直接見せる必要が無いからです。web からはサービス名 api で届きます。

保存は Ctrl + O → Enter、終了は Ctrl + X です。

立てる

bash
$ docker compose up -d
$ docker compose ps
NAME              IMAGE          STATUS         PORTS
k8slab-api-1      nginx:alpine   Up 3 seconds   80/tcp
k8slab-web-1      nginx:alpine   Up 3 seconds   0.0.0.0:8080->80/tcp

2つとも Up なら成功です。 確かめます。

bash
$ curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8080/
200

200 が返れば動いています。 ここから、4通りに困らせます。


① プロセスを殺すと戻らない

中の nginx を殺します。

bash
$ docker compose exec web nginx -s stop
$ docker compose ps
NAME              IMAGE          STATUS                     PORTS
k8slab-api-1      nginx:alpine   Up 2 minutes               80/tcp
k8slab-web-1      nginx:alpine   Exited (0) 4 seconds ago

web が Exited になりました。 確認します。

bash
$ curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8080/
000

000 は「HTTPのやり取りが1回も成立しなかった」という意味です。 繋がっていません。

そして、誰も直しません。 docker compose ps を何度打っても Exited のままです。

ここで一度、反論します

これは Compose の欠点ではありません。 1行足せば解けます。

bash
$ nano compose.yaml
services:
  web:
    image: nginx:alpine
    restart: unless-stopped
    ports:
      - "8080:80"
  api:
    image: nginx:alpine
    restart: unless-stopped
bash
$ docker compose up -d
$ docker compose exec web nginx -s stop

5秒ほど待ってから見ます。

bash
$ docker compose ps
NAME              IMAGE          STATUS          PORTS
k8slab-api-1      nginx:alpine   Up 1 minute     80/tcp
k8slab-web-1      nginx:alpine   Up 3 seconds    0.0.0.0:8080->80/tcp

Up 3 seconds に戻っています。 勝手に起動し直しました。

restart の値いつ再起動するか
noしない(既定値)
on-failure異常終了したときだけ
unless-stopped落ちたら常に。ただし人が stop したものは起こさない
always落ちたら常に。Docker を再起動すると、人が止めたものまで起きてくる

ここは大事なところです。 「コンテナが落ちたら勝手に戻ってほしい」は、Kubernetes を入れる理由になりません。 Docker が最初から持っている機能です。これを理由に Kubernetes を選ぶと、3日溶かします。(私です)

では、Compose で解けないものは何か。残り3つです。


② ホストごと落ちたら終わり

さっきの restart: unless-stopped を仕事させているのは、誰でしょうか。

bash
$ systemctl is-active docker
active

Docker のデーモン(dockerd)です。 そして、それはこのVMの中にいます。

では、そのVM自体が落ちたら。 再現します。

bash
$ sudo systemctl stop docker
$ sudo systemctl stop docker.socket
$ docker compose ps
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?
bash
$ curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8080/
000

繋がりません。そして、待っても戻りません。

restart: unless-stopped は、「Docker が動いている限り」という条件付きです。 復旧してくれる相手が、壊れた機械の中にいます。

元に戻します。

bash
$ sudo systemctl start docker
$ docker compose ps
NAME              IMAGE          STATUS          PORTS
k8slab-api-1      nginx:alpine   Up 5 seconds    80/tcp
k8slab-web-1      nginx:alpine   Up 5 seconds    0.0.0.0:8080->80/tcp

Docker が起きたら戻ってきました。 つまり、「Docker を誰かが起こす」までは、確実に止まっています。

これが Compose では解けない1つ目です。 解こうとすると、「そのVMの外に、監視して起こす人」が要ります。 それはもう1台という意味です。

[スクリーンショット: 01_docker停止.png] sudo systemctl stop docker のあとに docker compose ps を打って、Cannot connect to the Docker daemon が出ている画面を撮ってください。「復旧役が一緒に死んだ」ところが見せたい部分です。


③ 台数を増やすと、どこに置くか自分で決める必要がある

1台の中で増やすだけなら、Compose でもできます。

bash
$ docker compose up -d --scale api=3
$ docker compose ps
NAME              IMAGE          STATUS          PORTS
k8slab-api-1      nginx:alpine   Up 10 seconds   80/tcp
k8slab-api-2      nginx:alpine   Up 3 seconds    80/tcp
k8slab-api-3      nginx:alpine   Up 3 seconds    80/tcp
k8slab-web-1      nginx:alpine   Up 2 minutes    0.0.0.0:8080->80/tcp

3つになりました。 ただし、web を増やそうとすると失敗します。

bash
$ docker compose up -d --scale web=3
Error response from daemon: driver failed programming external connectivity on endpoint k8slab-web-2: Bind for 0.0.0.0:8080 failed: port is already allocated

8080番は1つしか無いからです。 ポートを固定したサービスは、同じホストでは1個までです。

そして本題は、そこではありません。

問題は「3つ増やせるか」ではなく、「サーバーが2台あるとき、3つをどう分けるか」です。

Compose には、その概念がありません。 compose.yaml は1台のホストの中の話しか書けません。2台に分けたければ、

  • どちらのサーバーに何個置くかを、人が決める
  • それぞれのサーバーに ssh して、それぞれ docker compose up -d を打つ
  • 1台が満杯なら、人が気づいて、もう片方に寄せる

この「どこに置くか決める」を、人がやり続けることになります。 3個なら耐えられます。サービスが10個・サーバーが5台になると、破綻します。

戻しておきます。

bash
$ docker compose up -d --scale api=1
$ docker compose ps

④ 無停止で入れ替えられない

イメージを新しくして、入れ替えます。 そのあいだ止まらないか、測りながらやります。

まず、確認用の窓をもう1つ開けます。 VS Code のターミナルなら + で、SSH ならもう1回ログインして2枚目を用意してください。

2枚目のターミナルで、0.2秒ごとに叩き続けます。

bash
$ while true; do curl -s -o /dev/null -w "%{http_code} " http://localhost:8080/; sleep 0.2; done

200 200 200 ... が流れ続けます。 これを流したまま、1枚目のターミナルで入れ替えます。

bash
$ cd ~/k8slab
$ sed -i 's|image: nginx:alpine|image: nginx:stable-alpine|' compose.yaml
$ docker compose up -d

2枚目の画面を見てください。

200 200 200 000 000 000 000 000 200 200 200

000 が並んだところが、止まっていた時間です。 私の環境では1.5〜3秒でした。

2枚目は Ctrl + C で止めます。

なぜ止まるのか。 docker compose up -d は、古いコンテナを止めてから、新しいコンテナを起動するからです。 その間、8080番を持っているコンテナが存在しません。

「たった2秒」と思うかもしれません。 ただし、

状況2秒の意味
個人サイト、1日数百アクセス誰にも当たらない可能性が高い。無視してよい
1日10万アクセス数人が確実にエラー画面を見る
決済の処理中その2秒に入った処理が、中途半端に終わる

そしてこれは、1日に何回もデプロイするようになると効いてきます。 止まらずに入れ替える(ローリングアップデート)は、Compose の機能ではありません。


4つを整理する

やってみた結果です。

#困りごとCompose で解けるか解き方 / 解けない理由
①プロセスが死ぬ解けるrestart: unless-stopped の1行
②ホストごと落ちる解けない復旧役(dockerd)が、壊れた機械の中にいる
③台数を増やす1台の中だけ「どのサーバーに置くか」という概念が無い
④無停止で入れ替える解けない止めてから起動する。その間、誰もいない

ここがこの記事の結論です。

Kubernetes が担当しているのは、②③④です。①ではありません。

①しか困っていないなら、Kubernetes は要りません。 restart を1行足して終わりです。

そして②③④には、共通点があります。

3つとも「サーバーが2台以上ある」ことを前提にしないと、解けません。

②は壊れた1台の外に復旧役が要るから。③は置き場所の選択肢が2つ以上あるから。④は古いのを動かしたまま新しいのを起動する場所が要るから。

逆に言えば——サーバーが1台しか無いなら、Kubernetes を入れても②③④は解けません。 本線の minikube の回で「1台なので、落ちたら全部落ちる」と書いたのは、この話でした。

Kubernetes の中身を、役割で並べる

部品の名前が6つ出てきます。 覚える必要はありません。さっきの②③④を、誰が担当しているかという表として読んでください。

部品置き場所何を担当するか②③④のどれ
API Serverコントロールプレーンすべての入口。 kubectl も他の部品も、必ずここを通す。部品同士は直接話さない全部の土台
etcdコントロールプレーン「あるべき状態」を保存する唯一の場所。 クラスタの記憶。ここが消えるとクラスタは復元できない全部の土台
Schedulerコントロールプレーン「置き場所が決まっていないコンテナ」を見つけて、どのサーバーに置くか決める。 決めるだけで、起動はしない③
Controller Managerコントロールプレーン「あるべき状態」と「いまの状態」の差を、ひたすら埋め続ける。 足りなければ作り、多ければ消す②④
kubelet各サーバー(ワーカー)自分の担当分を、実際にコンテナとして起動・監視する。 ホストで言えば dockerd の位置②
kube-proxy各サーバー(ワーカー)「どのサーバーにあるか分からない相手」に届くよう、通信を振り分ける③④

流れにするとこうです。

  あなた
   │  kubectl apply -f web.yaml
   ▼
 API Server ──書き込み──▶ etcd (あるべき状態を保存)
   │
   │ 「置き場所が未定のものがある」
   ▼
 Scheduler  ──▶ 「w1 に置く」と決めて API Server に書き戻す
   │
   ▼
 kubelet(w1) ──▶ 実際にコンテナを起動する
   │
   │ 「起動した」を API Server に報告(=いまの状態)
   ▼
 Controller Manager ──▶ あるべき状態 と いまの状態 を見比べ続ける

ここで大事なのは、部品の名前ではありません。

全員が、API Server を経由してしか話しません。 Scheduler は kubelet に「起動しろ」と命令しません。API Server に「w1 に置くことにした」と書くだけです。 kubelet は、API Server を見て「自分の担当が増えた」と気づいて起動します。

この作りのおかげで、どれか1つが落ちても全部は止まりません。

落ちた部品何が起きるか
Scheduler新しいコンテナの置き場所が決まらなくなる。 すでに動いているものは動き続ける
Controller Manager壊れたものが直らなくなる。 動いているものは動き続ける
kubelet(1台分)その1台の面倒を見る人がいなくなる。 他の台は無事
etcd記憶が消える。 バックアップが無いと、クラスタは作り直し

「etcd のバックアップを取れ」と必ず書いてあるのは、これが理由です。 他の部品は入れ直せば復活します(状態を持っていないから)。etcd だけは、中身そのものが資産です。

「あるべき状態」と「いまの状態」

Kubernetes が②④を解ける理由は、部品が6つあるからではありません。 状態の持ち方が違うからです。

命令的と宣言的

命令的(imperative)宣言的(declarative)
代表例docker runkubectl apply -f web.yaml
何を書くかやること(動かせ・止めろ)どうあってほしいか(3個動いていてほしい)
いつ効くか打った瞬間だけ書き換えるまで、ずっと
打った後の状態どこにも残らない(履歴はシェルの中だけ)etcd に残り続ける
同じものを2回打つと2個できる(docker run を2回)何も起きない(すでにその状態だから)
手で壊すと壊れたまま差として検出され、埋められる
誰が実行し続けるか人Controller Manager

「2回打つと何も起きない」は、欠陥ではなく目的です。 同じファイルを何回 apply しても結果が変わらないので、「いまどうなっているか分からなくても、とりあえず流せる」ようになります。 docker run は、いま何個動いているかを知らないと打てません。

この「何回やっても結果が同じ」性質を、冪等(べきとう)と呼びます。 Ansible の回で出てきたのと、まったく同じ考え方です。

API の形を、1回だけ見る

「あるべき状態」と「いまの状態」は、比喩ではありません。 同じオブジェクトの中に、別々の欄として実在します。

ここからは、クラスタが動いている人だけです。 動いていない人は、この節は読むだけで構いません(出力は全部載せてあります)。

本線の kubeadm クラスタなら、コントロールプレーンのVM(cp1)にログインして打ちます。

bash
$ kubectl get nodes
NAME   STATUS   ROLES           AGE   VERSION
cp1    Ready    control-plane   12d   v1.31.4
w1     Ready    <none>          12d   v1.31.4
w2     Ready    <none>          12d   v1.31.4

Ready が並んでいれば使えます。 動いていなければ、この記事の最後の「環境の準備」を先に見てください。

何か1つ作ります。

bash
$ kubectl create deployment demo --image=nginx:alpine --replicas=3
deployment.apps/demo created

Deployment そのものの中身(ReplicaSet との関係、更新のしかた)は、このシリーズの別の回でやります。 ここで見たいのは、中身ではなく「欄の形」だけです。

「あるべき状態」の欄を見ます。

bash
$ kubectl get deployment demo -o jsonpath='{.spec.replicas}'
3

「いまの状態」の欄を見ます。

bash
$ kubectl get deployment demo -o jsonpath='{.status.readyReplicas}'
3

両方 3 です。差がありません。 これが「望みどおり」の状態です。

では、spec だけを書き換えます。

bash
$ kubectl scale deployment demo --replicas=5
$ kubectl get deployment demo -o jsonpath='{.spec.replicas} {.status.readyReplicas}'

打った直後に見ると、こうなります。

5 3

左(あるべき)が5、右(いま)が3です。ずれています。 数秒待って、もう一度打ちます。

bash
$ kubectl get deployment demo -o jsonpath='{.spec.replicas} {.status.readyReplicas}'
5 5

追いつきました。

ここで起きたことを、正確に書きます。

私は spec を 3 → 5 に書き換えただけです。 「2個起動しろ」とは一度も言っていません。 Controller Manager が、差(5 と 3)を見つけて、埋めました。

これが「宣言的」の中身です。 命令を実行したのではなく、目標を置いたら、埋めに来たのです。

spec と status は、どのオブジェクトにもあります。

bash
$ kubectl explain deployment.spec --recursive | head -n 5
$ kubectl explain deployment.status | head -n 5
欄誰が書くか中身
spec人(またはツール)こうあってほしい
status機械だけ。人は書かないいまこうなっている

そして、この形はすべてのリソースで共通です。

bash
$ kubectl api-resources | head -n 12
NAME          SHORTNAMES   APIVERSION   NAMESPACED   KIND
configmaps    cm           v1           true         ConfigMap
namespaces    ns           v1           false        Namespace
nodes         no           v1           false        Node
pods          po           v1           true         Pod
services      svc          v1           true         Service
deployments   deploy       apps/v1      true         Deployment

kubectl が覚えることの多い道具に見えるのは、コマンドが多いからではありません。 リソースの種類が多いだけで、やることは全部「spec を書いて、status を見る」です。 kubectl get / describe / apply / delete の4つを、リソースの数だけ繰り返しているだけです。

[スクリーンショット: 02_spec_status.png] kubectl scale の直後に kubectl get deployment demo -o jsonpath='{.spec.replicas} {.status.readyReplicas}' を打って、5 3 のようにずれている瞬間を撮ってください。数秒後に 5 5 になった画面も続けて撮ると、差が埋まったことが分かります。

片づけます。

bash
$ kubectl delete deployment demo

「Pod を手で消しても戻ってくる」ところは、このシリーズの次の回でやります。 ここでは、戻す仕組みの正体が「差を埋め続ける処理」だと分かれば十分です。

要らない条件を、先に決める

ここが、この記事でいちばん役に立つ節です。

Kubernetes は、入れるかどうかを「機能の魅力」で決めると、必ず入れることになります。 どの機能も魅力的だからです。だから、入れない条件のほうを先に固定します。

この4つが全部当てはまるなら、入れない

#条件確かめ方
1サーバーが1台で足りているいまCPUとメモリが余っているか。 free -h と uptime を見て、常時50%を切っているなら1台で足りている
2落ちても、数分待てる「10分止まったら、誰にいくら損害が出るか」を金額で言えるか。 言えないなら、たぶん待てる
3運用しているのが1人自分が寝ている間に、誰かが直す約束になっているか。 なっていないなら、24時間動く仕組みは意味が薄い
4アクセスが安定している1日の中で最大と最小が10倍以上違うか。 違わないなら、自動で台数を増やす必要が無い

4つ全部に当てはまるなら、Kubernetes は入れないでください。

入れると、解決する問題より、増える問題のほうが多くなります。 私の3日は、この4つに全部当てはまっている環境に入れようとして溶けました。

当てはまるときの代替は、はっきりしています。

やりたいこと1台での答え
落ちたら戻したいrestart: unless-stopped
サーバー再起動後も戻したいrestart: unless-stopped + Docker の自動起動(systemctl is-enabled docker が enabled)
設定を再現したいcompose.yaml を Git に置く
落ちたら気づきたい外部の死活監視(別のサーバーから叩く)

この4つで、個人開発の要求はほぼ埋まります。

逆に、この条件が出てきたら要る

#条件なぜ Compose では無理か
1サーバーが複数台ある / 増える予定がある「どこに置くか」を人が決め続けることになる(山場①の③)
2止められない時間帯があるdocker compose up -d は必ず数秒止まる(山場①の④)
3運用する人が2人以上いる「誰がどのサーバーに何を入れたか」が、人の記憶になる。 宣言ファイルなら、Git が答えになる
4負荷が時間帯で大きく変わる台数を手で増減させることになる。 深夜に手で減らしに行く人はいない

1つでも当てはまるなら、検討する価値があります。 ただし——

「いつか複数台になるかもしれない」は、条件ではありません。 なってから入れても間に合います。 compose.yaml から移行するのは、ゼロから書くより簡単です。 先に入れて3日溶かすより、必要になってから2日かけるほうが安いです。

学習コストの正体

「Kubernetes は学習コストが高い」と言われます。 何が高いのかを、正直に分けます。

何が重いか実際のところ
① 概念の数見た目ほどではない。 kubectl api-resources は50行以上出るが、最初に要るのは Pod / Deployment / Service / ConfigMap / Secret の5つ。しかも全部 spec と status の同じ形
② YAML の量ここは本当に重い。 Compose で10行だったものが、Kubernetes では60〜80行になる。インデント1つで意味が変わり、間違えてもエラーが出ないことがある(知らないキーは無視される)
③ 壊れたときの調べ方ここが本丸。 Compose なら docker compose logs の1箇所。Kubernetes は見る場所が5つ以上に散る

③を具体的に書きます。 「繋がらない」ときに見る場所です。

順番見るものコマンド
1Pod が起動しているかkubectl get pods
2なぜその状態なのかkubectl describe pod <名前>
3アプリ自身のログkubectl logs <名前>
4クラスタ全体で何が起きたかkubectl get events --sort-by=.lastTimestamp
5サービスが Pod を見つけているかkubectl get endpoints <名前>
6ノード自体が正常かkubectl get nodes / kubectl describe node <名前>

「Compose なら5分で分かったことが、30分かかる」——これが学習コストの正体です。概念を覚える時間ではなく、詰まったときに余分にかかる時間です。

この差は、慣れると縮みます。ただしゼロにはなりません。 層が増えた分だけ、切り分ける場所が増えます。 障害対応は切り分けの順番がすべてで書いたとおり、順番を決めておくことでしか対処できません。

だからこのシリーズでは、毎回「壊れたときにどこを見るか」を書きます。

このシリーズで何をやるか

【深掘り】Kubernetes は、全15本の予定です。 順に積み上がるように並べています。

  1. なぜKubernetesが要るのか(この記事) — 要らない条件を先に決める
  2. Pod を1つ作って、壊す — Pod は何の単位なのか
  3. Deployment と ReplicaSet — 台数を保つ仕組みと、消しても戻る理由
  4. Service で宛先を固定する — 相手のIPが変わっても届く理由
  5. Ingress で外に公開する — NodePort・LoadBalancer・Ingress の使い分け
  6. 設定と秘密情報 — ConfigMap と Secret、そして Secret が暗号化ではないこと
  7. ストレージ — コンテナが消えても残す場所、PV・PVC・StorageClass
  8. StatefulSet — データベースを載せるときに何が変わるか
  9. リソース要求と制限 — requests と limits、そして OOM で殺される話
  10. Pod のスケジューリング — どのノードに載るかが決まる仕組み
  11. 無停止アップデートと Probe — 3種類の Probe と、更新中に 502 を出さない
  12. HPA でオートスケール — 負荷に応じて台数を自動で増減する
  13. RBAC と Pod のセキュリティ — 誰が何をできるか、Pod の権限を絞る
  14. 壊れたときの調べ方 — describe・logs・events を順番に読む
  15. 自前運用かマネージドか — 放っておくと止まる、EKS 等に渡す判断

リンクはまだ張っていません。 書けた回から順に、ナビが繋がります。 上から順に読める並びにしてありますが、この深掘りシリーズ全体が本線の脇道です。 飛ばしても本線は進みます。

環境の準備

次の回から、実際にクラスタを触ります。 手段は3つあり、メモリで決めます。

手段必要なメモリ向いている場面
kubeadm(本線で組んだ3台)8GB 以上本線でこれを組んだなら、これを使ってください。 複数ノードが本物なので、「別のノードに移る」が実際に見られる
kind4GB 程度からメモリが足りない場合はこれ。 1台のVMの中に、複数ノードのクラスタが作れる
minikube4GB 以上本線の1本目で使ったもの。1ノード。この深掘りでは kind を優先します

本線の kubeadm クラスタを使う場合

3台のVMを起動して、確認するだけです。

bash
$ kubectl get nodes
NAME   STATUS   ROLES           AGE   VERSION
cp1    Ready    control-plane   12d   v1.31.4
w1     Ready    <none>          12d   v1.31.4
w2     Ready    <none>          12d   v1.31.4

3台とも Ready なら、そのまま次の回に進めます。 組み方は 1台落としてもPodは移る — kubeadmで組む3台クラスタにあります。

メモリが足りない場合 — kind を入れる

kind は、Docker のコンテナ1つを「サーバー1台」に見立ててクラスタを作ります。 VMを3台起動する必要がありません。

Docker が動いていることが前提です。

bash
$ docker ps

入れます。

bash
$ curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.30.0/kind-linux-amd64   # 版を固定する。最新版は公式クイックスタートで確認
$ chmod +x ./kind
$ sudo mv ./kind /usr/local/bin/kind
$ kind version
kind v0.30.0 go1.24.0 linux/amd64

kubectl がまだ無ければ、こちらも入れます。

bash
$ which kubectl

無反応なら、本線の minikube の回の kubectl を入れる手順をそのまま使ってください。

2ノードのクラスタを作ります。

bash
$ nano ~/k8slab/kind-2node.yaml
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
  - role: control-plane
  - role: worker
bash
$ kind create cluster --name deep --config ~/k8slab/kind-2node.yaml

数分かかります。 終わったら確認します。

bash
$ kubectl get nodes
NAME                 STATUS   ROLES           AGE   VERSION
deep-control-plane   Ready    control-plane   64s   v1.31.2
deep-worker          Ready    <none>          48s   v1.31.2

2台とも Ready になれば成功です。

kind のクラスタは、コンテナです。 docker ps に出てきます。 VMを再起動すると止まります。 docker start で戻りますが、戻らないときは作り直すのがいちばん速いです。壊してよい環境として使ってください。

うまくいかないときは、この順で見ます。

症状見るところ
kind create cluster が途中で止まるメモリ不足。free -h を見て、available が2GBを切っていないか
kubectl get nodes が繋がらないkind get clusters でクラスタが存在するか。無ければ作成に失敗している
Ready にならない1〜2分待つ。ネットワークの準備に時間がかかります

作り直すのは1コマンドです。

bash
$ kind delete cluster --name deep

手元のPCのメモリが足りない場合は、VPSを1台借りて練習場にする手もあります。シンVPSはメモリの多いプランを揃えたVPSで、2026年11月時点の公式表示では大容量メモリプランの4GBが1ヶ月契約で月1,800円(税込)、無料のお試し期間はなく最低利用期間は3ヶ月です。壊しても、OSイメージから入れ直せば元に戻せます。

つまずいたところ

遠回りした順に書きます。

restart: unless-stopped を知らずに Kubernetes を検討した

これが3日の始まりでした。 「コンテナが落ちたら勝手に戻ってほしい」から調べ始めて、Kubernetes の記事にたどり着きました。

Compose のドキュメントを先に読んでいれば、1行で終わっていました。

「この問題は、いま使っている道具では解けないのか」を先に確かめる。 新しい道具を調べる前に、手元の道具の説明書を読む。 順番を逆にすると、たいてい高くつきます。

docker compose exec web nginx -s stop で「殺せていない」と思った

最初は docker compose exec web pkill nginx と打ちました。

OCI runtime exec failed: exec failed: unable to start container process: exec: "pkill": executable file not found in $PATH

nginx:alpine に pkill が入っていないからです。 素の Alpine には、普段あるコマンドの多くが入っていません。

本線の再現性の話と同じ罠でした。 「自分の環境に入っていたもの」を、コンテナの中にもあると思い込みました。 nginx を止めるなら、nginx 自身が持っている nginx -s stop を使うのが確実です。

sudo systemctl stop docker を打ったのに、まだ docker ps が動いた

docker.socket が生きていて、docker コマンドを打った瞬間に dockerd が起き直していました。

bash
$ sudo systemctl stop docker
$ docker ps

これだと、止めた実験になりません。 docker.socket も止める必要がありました。

bash
$ sudo systemctl stop docker
$ sudo systemctl stop docker.socket

systemd の「ソケット起動」という仕組みです。 アクセスが来た瞬間にサービスを起こすようになっています。 Afterは依存関係ではないで見た .socket は、ここで効いてきました。

無停止の実験で 000 が1つも出ずに、「Compose でも止まらない」と結論しかけた

curl を1秒に1回しか打っていなかったからです。 止まっていた時間が2秒弱だったので、運が良ければすり抜けます。

sleep 0.2 にしたら、毎回はっきり 000 が並びました。

「観測できなかった」を「起きていない」と読むと、間違えます。 測る間隔より短い現象は、測れません。 監視の回で「取得間隔より短い障害は見えない」と書いたのと、まったく同じ話でした。

kubectl get deployment demo -o jsonpath='{.status.readyReplicas}' が空で返った

bash
$ kubectl create deployment demo --image=nginx:alpine --replicas=3
$ kubectl get deployment demo -o jsonpath='{.status.readyReplicas}'

何も出ませんでした。 壊れたと思って describe を見に行きました。

まだ1個も起動していなかったからです。 readyReplicas は「0」ではなく、「欄そのものが無い」状態でした。

status は、機械が書き込むまで存在しません。 0 と「未記入」は別物です。 数秒待って打ち直したら、3 が出ました。 急いで打ちすぎただけでした。

kubectl scale したのに spec が変わっていないように見えた

kubectl get deployment demo の READY の列だけを見ていました。

NAME   READY   UP-TO-DATE   AVAILABLE   AGE
demo   3/5     5            3           40s

3/5 の「5」が spec、「3」が status です。 1つの列に両方入っていました。

READY の列は いま/あるべき です。 右側の数字が、自分が書いた spec の値です。 これに気づいてから、kubectl get の出力が急に読めるようになりました。

後片づけ

この記事で作ったものを消します。

まず Compose を止めます。

bash
$ cd ~/k8slab
$ docker compose down
$ docker compose ps
NAME   IMAGE   STATUS   PORTS

何も出なければ止まっています。

Kubernetes 側で作ったものを消します。(作った人だけ)

bash
$ kubectl delete deployment demo
$ kubectl get deployments
No resources found in default namespace.

次の回もこのシリーズを続けるなら、ここまでで十分です。

完全に片づけるなら、フォルダとイメージも消します。

bash
$ cd ~
$ rm -rf ~/k8slab
$ docker rmi nginx:stable-alpine
$ docker system df

nginx:alpine は、これ以降も使うので残しておいて構いません。 kind のクラスタは、次の回で使います。消さないでください。 消す場合は kind delete cluster --name deep です。

Docker を止めた実験のあと、起動し直したか確認しておきます。

bash
$ systemctl is-active docker
$ systemctl is-enabled docker
active
enabled

active と enabled の両方が出れば、元通りです。 startとenableは別物で見た2つが、ここでも効いています。

まとめ

  • 「とりあえず Kubernetes」で3日溶かした。 到達したのは、Compose で30分だった状態。機能は1つも増えなかった
  • Compose で困らせてみると、困りごとは4つに分かれた。 そのうち①「プロセスが死ぬ」は Compose で解ける。restart: unless-stopped の1行
  • 「落ちたら勝手に戻ってほしい」は、Kubernetes を入れる理由にならない。 Docker が最初から持っている
  • Kubernetes の担当は②③④。 ホストごと落ちる / 台数の置き場所を決める / 無停止で入れ替える
  • ②③④には共通点がある。 3つとも「サーバーが2台以上ある」ことを前提にしないと解けない
  • だから1台なら、Kubernetes を入れても②③④は解けない。 minikube が「落ちたら全部落ちる」のはこの理由
  • 6つの部品は、②③④の担当表として読める。 Scheduler が③、Controller Manager が②④、kubelet が②、kube-proxy が③④
  • 全員が API Server を経由してしか話さない。 部品同士は直接命令しない。だから1つ落ちても全部は止まらない
  • etcd だけは別格。 他は入れ直せば復活するが、etcd の中身は資産。バックアップが要るのはこれが理由
  • 宣言的とは「あるべき状態を置いておくと、誰かが差を埋めに来る」こと。 比喩ではなく、spec と status という2つの欄が実在する
  • spec は人が書き、status は機械しか書かない。 kubectl get の READY 列の 3/5 は、いま/あるべき
  • status は、機械が書くまで存在しない。 0 と「未記入」は別物
  • 同じファイルを2回 apply しても何も起きない。 これは欠陥ではなく目的(冪等)
  • 入れない条件を先に決める。 1台で足りる / 落ちても数分待てる / 運用が1人 / アクセスが安定——4つ全部に当てはまるなら入れない
  • 要る条件は、複数台 / 止められない時間帯がある / 運用が2人以上 / 負荷が変動する。 「いつか複数台になるかも」は条件ではない
  • 学習コストの正体は概念の数ではない。 重いのはYAMLの量と、壊れたときに見る場所が5箇所以上に散ること
  • 環境は、メモリで決める。 8GB以上なら本線の kubeadm 3台、足りなければ kind

参考リンク


次に読む

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

記事
← 前の記事React NativeとExpo — 書けてもdivは無い
→ 次の記事Podという最小単位 — 消したPodは戻ってこない

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

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

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

DevOps›Kubernetes — Overview
  • なぜKubernetesが要るのか / 要らない条件
  • 制御面の部品(API Server / etcd / Scheduler ほか)

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

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

コメント

コメントする

目次