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

Kubernetesとminikube。コンテナの箱と状態を示すチェックリスト、管理する歯車。

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

Kubernetesは「こうあってほしい」を宣言すると、その状態に近づけ続ける仕組みです。minikubeで1台から始めて、Composeでは足りない理由を確かめます。

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

DevOps/Kubernetes›Container Orchestration
  • Kubernetes(Pod / Service / Deployment)
  • 宣言的な運用
  • minikube

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

前回: 自分のAPIをコンテナ化する — コードは1行も載せません 作業場所は VM の中(Ubuntu Server)です。前回入れた Docker をそのまま使います。 この回の前に、VMのスナップショットを取ってください。 数GBのディスクを使います。

前回、compose.yaml を1枚書いて docker compose up -d で nginx と MySQL が同時に立ち上がりました。あそこで「もう十分では」と思ったなら、正しい感覚です。 個人の学習用なら、実際あれで足ります。

足りなくなるのは、こうなったときです。

深夜3時にコンテナが落ちて、朝までサイトが止まっていた。

docker compose up -d は「起動した」ところまでしか面倒を見ません。そのあとコンテナが死んでも、誰も起こしてくれません。 自分で気づいて、自分で docker compose up -d をもう一度打つ。それが運用です。

Kubernetes は、この「自分で打ち直す」を機械にやらせる仕組みです。

そして、そこに至る発想の転換が1つあります。この記事の山場はそこで、コマンドの暗記ではありません。


対象レベル: 中級 / 区分: 必修

目次

必要なメモリとディスク(先に確認してください)

これは Kubernetes を1台に押し込む練習用の構成です。空きが足りないと、起動の途中で止まります。

項目この記事で必要な量補足
VMに割り当てるメモリ4GB 以上minikube 公式の最低は空きメモリ2GB。Ubuntu 自身とDockerが使う分があるので4GBにします
VMのCPU2コア 以上minikube の最低要件が2コア。1コアだと起動を拒否されます
VMの空きディスク20GB 以上公式の最低要件。イメージ類で数GBが実際に減ります
Windows本体(ホスト)の物理メモリ16GB を推奨VMに4GB渡してもWindows側が苦しくならない量。8GB機では厳しい

空きディスクは、VMの中でこう確認できます。

bash
$ df -h /
$ free -h
$ nproc
Filesystem      Size  Used Avail Use% Mounted on
/dev/mapper/...   24G  8.2G   15G  36% /

Avail が 20GB を切っているなら、先にVMのディスクを広げるか、docker system prune -a で片づけてください。 PCのスペックを測る回で見たのと同じで、始める前に測ります。

ここで「足りない」と分かった場合、この記事は読むだけにして、手を動かすのは後日で構いません。 概念のところは実機がなくても読めます。


この記事でわかること

  • docker run は命令、Kubernetes は宣言という違い。「こう動かせ」と「この状態であれ」は別物だということ
  • Pod はコンテナではない(Compose の1サービスとも一致しない)
  • Pod / Service / Deployment が、Compose の何に当たるのか
  • minikube は「本物のクラスタ」ではないこと。1台なので、落ちたら全部落ちる
  • Docker の -p は ufw を素通りしたが、kubectl port-forward は素通りしないこと

この記事でやること

  1. 必要なメモリとディスクを測る
  2. minikube と kubectl を入れて、1台構成のクラスタを起動する
  3. nginx を Deployment として動かす
  4. Pod を手で消して、勝手に復活するところを見る(この記事の中心)
  5. Service で外に出して、Windows のブラウザから開く
  6. 止めて、消す(数GB食っているので必ずやります)

先に知る言葉

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

言葉意味
Kubernetes(K8s)コンテナを複数台のサーバーにまたがって動かし続ける仕組み。「K」と「s」の間に8文字あるので K8s と略す
クラスタKubernetes が束ねているサーバーの集まり。1台でもクラスタと呼ぶ
ノード(Node)クラスタを構成するサーバー1台。minikube ではVM1台がノード1つ
minikubeクラスタを1台のマシンの中に作る学習用ツール。本番用ではない
kubectlクラスタに命令を送るコマンド。読み方は「キューブコントロール」「キューブシーティーエル」など揺れがある
マニフェスト「こうあってほしい状態」を書いた YAML ファイル
宣言的(declarative)結果の状態を書くやり方。手順ではなく「あるべき姿」を渡す
命令的(imperative)手順を書くやり方。docker run はこちら

なぜ Compose では足りないのか

前回作ったものの限界を、3つに分けます。

① 落ちたら、そこで止まる

bash
$ cd ~/stack
$ docker compose up -d
$ docker rm -f stack-web-1
$ docker compose ps

web が消えたまま、何も起きません。 誰も起こしません。手で docker compose up -d を打つまで、サイトは落ちています。

restart: always を書けばいいのでは、と思った人へ。 それでも「Docker が動いているVM自体が落ちたら終わり」です。復旧の主体がその1台の中にいる限り、その1台の故障は救えません。

② 台数を増やせない

compose.yaml の web を3つに増やしたいとします。同じVMの中に3つ作っても、

  • 全部が同じ 8080番を掴もうとして衝突します(前回の port is already allocated)
  • そもそも同じVMなので、VMが落ちたら3つとも落ちます。 増やした意味がありません

③ 別のマシンに広げられない

Compose は 「このマシンの中」しか知りません。 2台目のVMを用意しても、compose.yaml から向こうのマシンにコンテナを置くことはできません。

この3つをまとめると、こうなります。

Compose は「1台の中の配置図」。Kubernetes は「複数台をまたぐ運用係」。

命令と宣言は何が違うのか

ここが分かれば、この記事の8割は終わりです。

docker run は「命令」

bash
$ docker run -d -p 8080:80 --name web nginx

これは「いま、こう動かせ」という指示です。Docker は言われたとおりに1つ起動して、そこで仕事を終えます。

そのあと、そのコンテナがどうなろうと Docker は関知しません。 落ちたか、消されたか、確認する人はいません。「打った瞬間」しか存在しない指示です。

Kubernetes は「宣言」

nginx のコンテナが、常に1つ動いている状態であってほしい

Kubernetes に渡すのは、この「状態」です。 そして Kubernetes は、その状態を保ち続けようとし続けます。

【命令的】                        【宣言的】
                                
あなた ──「起動しろ」──> Docker    あなた ──「1つある状態にしろ」──> K8s
              ↓                                                      ↓
           起動した                            ┌──────────────────────┐
              ↓                                │ いまの状態を見る     │
           (終わり)                          │  ↓                   │
                                               │ 望む状態と違う?     │
   落ちても誰も気づかない                      │  ↓ 違う              │
                                               │ 直す                 │
                                               └──────┬───────────────┘
                                                      └── 永久に繰り返す

Kubernetes の中身は、この「見て、違ったら直す」ループの集まりです。これをリコンサイル(調整)ループと呼びます。

言い換えると、こうです。

誰が復旧させるか
Docker / Composeあなた(気づいて、打ち直す)
Kubernetesクラスタ自身(望む状態と違うことに気づいて、勝手に直す)

この記事では、実際にコンテナを手で消して、勝手に復活するところを見ます。 文章で読むより、そこを見たほうが早いです。

注意:宣言的だから優れている、という話ではありません。 宣言的なやり方は、「いま何が起きているか」が追いにくいという代償があります。自分が打ったコマンドではなく、クラスタが自分の判断で動くからです。 Compose で足りる規模に Kubernetes を持ち込むと、確実に損をします。 「どちらを使うか」は規模の判断です。

Pod / Service / Deployment

読者は Compose を知っているので、そこから橋を架けます。

Kubernetesだいたい Compose の何か役割
Podservices: の1サービスの実体1つ実際に動いているコンテナの入れ物。使い捨て
Deploymentcompose.yaml のサービス定義+「何個動かすか」「Pod を◯個保て」と宣言する係
ServiceCompose のサービス名での名前解決+ports:入れ替わる Pod への、変わらない入口

上から順に、なぜ必要かを見ます。

Pod はコンテナではない

ここは最初に必ず誤解します。

❌ 「Pod = コンテナの別名」

違います。Pod は「1つ以上のコンテナをまとめた、最小の配置単位」です。

┌─ Pod ────────────────────────────┐
│   IPアドレス: 10.244.0.5          │  ← Pod に1つ付く
│                                   │
│  ┌───────────┐  ┌──────────────┐ │
│  │ nginx     │  │ ログ収集     │ │  ← 中のコンテナは
│  │ :80       │  │              │ │     このIPを共有する
│  └───────────┘  └──────────────┘ │
│         localhost で互いに繋がる  │
└───────────────────────────────────┘

Pod の中のコンテナは、IPアドレスを共有します。 つまりお互いを localhost で呼べます。

Compose との違いが、ここで出ます。

名前解決の相手
Compose別サービスは db のようにサービス名で呼ぶ(前回の getent hosts db)
Pod の中同じ Pod の中なら localhost:3306 で呼べる

では、いつ Pod に2つ入れるのか。 「絶対に同じマシンに居ないと困るもの」だけです。ログを吸い出す係、設定を取ってくる係など。 Webサーバーとデータベースは、別の Pod にします。 一緒に置くと、片方を増やしたいときにもう片方も増えてしまいます。

最初のうちは「Pod の中のコンテナは1つ」で構いません。 ただし「Pod とコンテナは同じもの」と覚えるのはやめてください。 後で必ず詰まります。

そしてもう1つ、重要な性質があります。

Pod は使い捨てです。 落ちたら同じものが復活するのではなく、新しい Pod が作られます。 名前もIPアドレスも変わります。 だから Pod のIPを設定ファイルに書いてはいけません。

Deployment は「何個保つか」を宣言する

Pod を直接作ることもできますが、そうすると Compose と同じで、落ちたら終わりです。

Deployment は「この Pod を◯個、常に保て」という宣言です。

Deployment「nginx の Pod を 3個保て」
      │
      ├─ Pod (nginx) ← 落ちた
      ├─ Pod (nginx)
      └─ Pod (nginx)
            ↓ Deployment が気づく
      ├─ Pod (nginx) ← 新しく作られる(名前もIPも別物)
      ├─ Pod (nginx)
      └─ Pod (nginx)

「3個」という数字が、望む状態です。 現実が2個になったら、Deployment が3個に戻します。これがさっきのリコンサイルループの実物です。

Service は「変わらない入口」

Pod は入れ替わり、IPも変わります。 では、どこに繋げばいいのか。

Service は「Pod がどう入れ替わっても変わらない、名前とIP」です。

     アクセス
        ↓
  ┌─ Service (web) ─┐   ← ここは変わらない
  │  10.96.x.x       │
  └────┬─────────────┘
       │ 振り分ける
   ┌───┴───┬───────┐
  Pod     Pod     Pod    ← ここは入れ替わる

Compose では、サービス名 db が同じ役割をしていました。 Kubernetes ではそれが Service という独立した部品になっていて、振り分け(ロードバランス)まで担当します。

入れる

minikube は Docker の上に「クラスタのふりをしたコンテナ」を1つ作ります。 前回入れた Docker がそのまま土台になります。

① Docker が動いているか確認する

bash
$ docker ps
$ docker compose ls

前回の stack が動いているなら、先に止めてください。 メモリを取り合います。

bash
$ cd ~/stack
$ docker compose down

down -v にしないでください。 -v を付けるとMySQLのデータが消えます(前回)。

② minikube を入れる

apt には入っていません。 公式が配っているバイナリを取ってきます。

bash
$ cd ~
$ curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
$ sudo install minikube-linux-amd64 /usr/local/bin/minikube
$ rm minikube-linux-amd64
部分意味
curl -LOリダイレクトを追って(-L)、元のファイル名で保存(-O)
sudo install ...コピーして、同時に実行権限を付ける。cp + chmod 755 を1回で
/usr/local/bin自分で入れたコマンドを置く場所(ディレクトリの回)
bash
$ minikube version

バージョン番号が返れば入っています。 数字はこの記事と違って構いません(latest を取っているので、読む時期で変わります)。

③ kubectl を入れる

minikube とは別物です。 minikube が「クラスタを作る係」、kubectl が「クラスタに命令する係」です。

bash
$ curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
$ sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
$ rm kubectl

$( ) の中で、最新の安定版番号を取ってきて、URLに埋めています。 シェルスクリプトの回で見たコマンド置換です。

bash
$ kubectl version --client

クライアント側のバージョンが出れば成功です。 --client を付けないと、まだクラスタが無いので接続エラーが出ます。

起動する

bash
$ minikube start --driver=docker

--driver=docker は「クラスタの本体を、Docker のコンテナとして作れ」という指定です。VMの中でさらにVMを作らせないために、明示します。

初回は数分かかります。 イメージのダウンロードがあるためです。

😄  minikube v1.3x.x on Ubuntu 24.04
✨  Using the docker driver based on user configuration
🐳  Preparing Kubernetes v1.3x.x on Docker ...
🏄  Done! kubectl is now configured to use "minikube" cluster

絵文字が出ますが、正常です。 minikube はこういう出力をします。

確かめます。

bash
$ kubectl get nodes
NAME       STATUS   ROLES           AGE   VERSION
minikube   Ready    control-plane   1m    v1.3x.x

ノードが1つ、Ready。これが「1台構成のクラスタ」です。

Docker 側から見ると、こう見えます。

bash
$ docker ps

kicbase という名前を含むイメージ(版によって gcr.io/k8s-minikube/kicbase:... など)の、minikube という名前のコンテナが1つ動いています。 クラスタの正体は、Docker のコンテナ1個です。ここを見ておくと、あとの「なぜ本物のクラスタが別に要るのか」が腑に落ちます。

[スクリーンショット: 01_minikube起動.png] minikube start の完了メッセージと、kubectl get nodes で Ready が出ている画面を撮ってください。

起動しなかったら

症状原因と対処
Requested memory allocation ... is less than the recommended minimumVMのメモリ不足。 VMの設定で4GBに増やす
Requested cpu count 2 is greater than the available cpusVMのCPUが1コア。 VMware側で2コアに増やす
permission denied while trying to connect to the Docker daemondocker グループの反映漏れ。 いったんSSHを切って繋ぎ直す(Dockerの回)
No space left on deviceディスク不足。 docker system prune -a で片づける

やり直すときは、いったん消してからです。

bash
$ minikube delete
$ minikube start --driver=docker

nginx を Deployment として動かす

bash
$ kubectl create deployment web --image=nginx

「nginx イメージの Pod を保て」という宣言を作りました。 個数を指定していないので 1個です。

bash
$ kubectl get deployments
$ kubectl get pods
NAME   READY   UP-TO-DATE   AVAILABLE   AGE
web    1/1     1            1           20s

NAME                   READY   STATUS    RESTARTS   AGE
web-6d8f9c7b5f-x4k2p   1/1     Running   0          20s

Pod の名前に注目してください。

web-6d8f9c7b5f-x4k2p
└┬┘ └────┬───┘ └─┬─┘
 │       │       └── ランダム(Podごと)
 │       └────────── ランダム(Deploymentの版ごと)
 └────────────────── Deployment名

この名前は、自分では決められません。 そして作り直されるたびに変わります。 「Pod は使い捨て」というのは、こういうことです。

READY 1/1 の左は「準備できたコンテナ数」、右は「Pod の中のコンテナ数」です。 Pod の中にコンテナが2つある構成なら 2/2 になります。ここも「Pod ≠ コンテナ」の現れ方の1つです。

STATUS が ContainerCreating のままなら、イメージのダウンロード中です。 少し待ってから kubectl get pods をもう一度打ってください。

実演:手で消して、勝手に復活させる

ここがこの記事の中心です。

まず、いまの Pod の名前を控えます。

bash
$ kubectl get pods

表示された名前をコピーしてください。 下の web-6d8f9c7b5f-x4k2p は例なので、自分の値に読み替えます。

では、消します。

bash
$ kubectl delete pod web-6d8f9c7b5f-x4k2p
pod "web-6d8f9c7b5f-x4k2p" deleted

すぐに、もう一度見ます。

bash
$ kubectl get pods
NAME                   READY   STATUS    RESTARTS   AGE
web-6d8f9c7b5f-q7m9v   1/1     Running   0          3s

復活しています。 そして、

  • AGE が数秒になっている
  • 名前の最後が変わっている(x4k2p → q7m9v)

同じ Pod が生き返ったのではありません。 消えたことに Deployment が気づいて、新しい Pod を作りました。

RESTARTS が 0 のままなのを見てください。 RESTARTS は「同じ Pod の中でコンテナが再起動した回数」です。今回はPod ごと作り直されたので、カウントは 0 から始まります。「再起動」ではなく「新品への置き換え」だということが、この数字に出ています。

この一連の動きは、リアルタイムでも見られます。

bash
$ kubectl get pods --watch

別のターミナルからもう一度 Pod を消すと、Terminating → Pending → ContainerCreating → Running と流れていきます。 見終わったら Ctrl + C で止めます。

これが Compose との決定的な違いです。 前回、docker rm -f stack-web-1 を打ったとき、何も起きませんでした。 Kubernetes では、「1個保て」という宣言があるので、現実がそれと違った瞬間に直されます。 あなたは復旧を頼んでいません。宣言しただけです。

[スクリーンショット: 02_pod復活.png] kubectl delete pod の直後に kubectl get pods を打ち、名前が変わった Pod が Running になっている画面を撮ってください。

台数も宣言で変える

bash
$ kubectl scale deployment web --replicas=3
$ kubectl get pods
NAME                   READY   STATUS    RESTARTS   AGE
web-6d8f9c7b5f-q7m9v   1/1     Running   0          2m
web-6d8f9c7b5f-h2n8t   1/1     Running   0          5s
web-6d8f9c7b5f-b9w3r   1/1     Running   0          5s

3つになりました。 Compose で3つに増やそうとしてポート衝突した話を思い出してください。ここでは何も衝突していません。 Pod ごとに別のIPを持っているからです。

ただし、これは全部 1台のVMの中です。 3つに増えても、このVMが落ちたら3つとも落ちます。 「台数を増やせば安全」ではありません。 その話は記事の最後でします。

1つに戻しておきます。

bash
$ kubectl scale deployment web --replicas=1

Service で外に出す

いまの Pod は、クラスタの外からは見えません。 Compose で ports: を書かなかった db と同じ状態です。

bash
$ kubectl expose deployment web --type=NodePort --port=80
$ kubectl get services
NAME         TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)        AGE
kubernetes   ClusterIP   10.96.0.1       <none>        443/TCP        10m
web          NodePort    10.96.140.22    <none>        80:31234/TCP   5s
TYPE意味
ClusterIP(既定)クラスタの中からだけ見える。Compose で ports: を書かないのと同じ
NodePortノードのポートを1つ開けて外から入れるようにする
LoadBalancerクラウドのロードバランサを使う。minikube では本来の形では動きません

80:31234/TCP の右の数字(30000〜32767 のどれか)は、毎回変わります。自分の値を見てください。

VMの中からなら、これで開けます。

bash
$ minikube service web --url
http://192.168.49.2:31234
bash
$ curl -s $(minikube service web --url) | head -n 5
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>

192.168.49.2 は、VMのIPではありません。 minikube が Docker の中に作ったネットワークのIPです。 ホストのWindowsからこのIPに繋ごうとしても、届きません。 VMの中にしか存在しないアドレスだからです。

ホストのブラウザから見る — ここで ufw の話が戻ってくる

VMの中の curl で終わらせない、というのはnginx の回からずっと同じです。ホストのブラウザで確かめます。

そのために、VMのポートとクラスタの Service を繋ぎます。

bash
$ sudo ufw allow 8080/tcp
$ kubectl port-forward --address 0.0.0.0 service/web 8080:80
Forwarding from 0.0.0.0:8080 -> 80

このコマンドは動いたまま止まりません。 前面で待ち受け続けます。別のターミナルを開いて作業を続けるか、確認が済んだら Ctrl + C で止めてください。

ホストの Windows のブラウザで開きます。

http://192.168.226.50:8080/

IPは自分のVMの値に読み替えてください。 VMの中で ip a を打つと確認できます(ネットワークの回)。

「Welcome to nginx!」が出れば成功です。

[スクリーンショット: 03_ブラウザ表示.png] kubectl port-forward が動いている画面と、ホストのWindowsのブラウザで nginx が表示されている画面を並べて撮ってください。

なぜ今回は ufw を開ける必要があったのか

Dockerの回で、こう書きました。

-p で開けたポートは ufw を素通りする。

今回は素通りしていません。 sudo ufw allow 8080/tcp を消して試すと、ホストのブラウザから繋がりません。

理由は、やっていることが違うからです。

何をしているかufw は効くか
docker run -p 8080:80iptables の nat/FORWARD にルールを入れて、宛先を書き換える効かない(ufw が見ている INPUT を通らない)
kubectl port-forwardkubectl というプログラムが、自分で 8080番を待ち受ける効く(普通のプロセスなので INPUT を通る)

確かめられます。

bash
$ sudo ss -tlnp | grep 8080

users:(("kubectl",...)) と出ます。 docker-proxy ではありません。待ち受けているのは kubectl 本人です。

「コンテナ関連だから ufw は効かない」ではありません。 効くかどうかは、パケットが INPUT を通るかどうかで決まります。 これはネットワークの回とDockerの回で見た話が、そのまま繋がっています。 仕組みで覚えていれば予測でき、道具の名前で覚えていると毎回当たりません。

確認が済んだら、ポートは閉じておきます。

bash
$ sudo ufw delete allow 8080/tcp
$ sudo ufw status

宣言を、ファイルに書く

ここまで kubectl create と kubectl expose をコマンドで打ちました。実務ではこうしません。

「望む状態」はファイルに書いて、Gitに入れる。

compose.yaml と同じ発想です。 マニフェスト(YAML)を書きます。

bash
$ mkdir -p ~/k8s
$ nano ~/k8s/web.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
spec:
  replicas: 2
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: nginx
          image: nginx:1.27
          ports:
            - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: web
spec:
  type: NodePort
  selector:
    app: web
  ports:
    - port: 80
      targetPort: 80

Compose の YAML より、はっきり冗長です。 ただし書いてあることは3つだけです。

部分意味
kind:何を宣言しているか(Deployment / Service)
replicas: 2Pod を2個保て
template:作る Pod の中身(ここが Compose の1サービスに相当)
labels: app: webPod に貼る名札
selector:その名札が付いた Pod を対象にする
---1ファイルに複数の宣言を書くときの区切り

selector と labels が Kubernetes の繋ぎ方の中心です。 Service は「web という Deployment に繋ぐ」とは書いていません。「app: web という名札が付いた Pod、全部」と書いています。 名前ではなく名札で繋ぐので、Deployment を作り替えても Service 側を直さずに済みます。

Compose と同じで、適用する前に検査できます。

bash
$ kubectl apply -f ~/k8s/web.yaml --dry-run=client

--dry-run=client は、クラスタに送らずに形だけ見る指定です。Compose の docker compose config や nginx の nginx -t と同じ、壊す前に確かめる手順です。

適用します。

bash
$ kubectl apply -f ~/k8s/web.yaml
$ kubectl get pods
deployment.apps/web configured
service/web configured

created ではなく configured と出ます。 同じ名前のものが既にあるので、「作った」ではなく「宣言に合わせて直した」という意味です。

apply は何度打っても同じ結果になります。 これが宣言的なやり方の実利です。 「もう作ってあったっけ?」を気にしなくていい。 打てば、書いてある状態に寄ります。

片づけるときも、ファイル単位です。

bash
$ kubectl delete -f ~/k8s/web.yaml
$ kubectl get all

つまずいたところ

kubectl を入れずに minikube start した

minikube start の最後に「kubectl is now configured」と出るので、入っていると思い込みました。 実際は kubectl コマンドが無く、command not found になります。

minikube にも minikube kubectl -- get pods という呼び方はありますが、-- を毎回書くのが面倒なので、素直に kubectl を入れました。

Pod の名前をコピーし間違えて NotFound

Error from server (NotFound): pods "web-6d8f9c7b5f-x4k2q" not found

Pod名の末尾はランダムな文字列で、p と q、0 と o を読み違えます。 記事の例をそのまま打っても必ず失敗します。

確実なのは、名前を打たないやり方です。

bash
$ kubectl delete pod -l app=web

「app: web の名札が付いた Pod」を指定しています。 名札で指定する練習にもなります。

192.168.49.2 にホストのブラウザから繋ごうとした

minikube service web --url が返すURLをそのままホストのブラウザに貼って、繋がらずに30分溶かしました。

あのIPはVMの中にしかありません。 VMの外から見えるのはVMのIP(192.168.226.50)だけです。

「VMの中で見えている ≠ 外から見える」は、nginx の回から毎回同じ形で出てきます。 層が1つ増えるたびに、また踏みます。

minikube stop したのにメモリが戻らない気がした

minikube stop はクラスタを止めますが、イメージやディスクは残ります。 ディスクを空けたいなら minikube delete です。後片づけの節でやります。

なぜ「本物のクラスタ」が別に必要なのか

ここまでで、Kubernetes は「落ちたら勝手に復旧する」ことを見ました。 では、minikube で十分でしょうか。

十分ではありません。理由は1つです。

minikube は1台です。落ちたら、全部落ちます。

bash
$ docker ps

さっき見たとおり、クラスタの正体は Docker のコンテナ1個でした。

つまり、いまの構成はこうなっています。

Windows(ホスト)
  └─ VMware の Ubuntu VM 1台         ← ここが落ちたら
       └─ Docker
            └─ minikube のコンテナ    ← ここが落ちたら
                 └─ Pod × 3          ← 全部落ちる

Pod を3つに増やしても、置き場所は1つしかありません。 「復旧してくれる誰か」が、故障するその1台の中にいるからです。

Kubernetes が本当に効くのは、ノードが複数あるときです。

      ┌─ ノードA ── Pod  ← ノードAが落ちる
K8s ──┼─ ノードB ── Pod
      └─ ノードC ── Pod
            ↓
      ノードB・C に Pod を作り直す   ← 別のマシンに逃がせる

「別のマシンに逃がす」は、マシンが2台以上ないとできません。 minikube にはそれができません。

minikube は「Kubernetes の文法を覚える場所」です。「落ちても止まらない」を体験する場所ではありません。 ここを混同すると、「minikube で動いたから本番でも大丈夫」という一番危ない勘違いをします。

次の回で、VMを3台立てて本物のクラスタを組みます。 VMware に Ubuntu Server を入れる回でやったことを、あと2回繰り返すところから始まります。そこで初めて「ノードを1台落としても止まらない」が試せます。

minikube は 1 台の中で完結するので、「別のマシンに広げる」部分だけは手元では試せません。2 台以上を実際に繋いでみたいなら、クラウド VPS byGMOのように複数台をローカル接続で組める VPS を借りて、1 台を control plane、もう 1 台を worker にする構成があります。2026年11月時点では 1GB(仮想2コア・50GB)が 12 ヶ月契約で月 858 円(税込)ですが、表示月額とは別にサーチャージ費が毎月かかり、15 日間の無料お試しは初回申し込みの 1GB/2GB/4GB プランに限られます。

後片づけ

minikube は数GB使います。放置しないでください。

使用量を先に見ます。

bash
$ minikube status
$ docker system df
$ df -h /

① しばらく使わないだけなら「止める」

bash
$ minikube stop

メモリは解放されますが、ディスクはそのままです。 minikube start で続きから使えます。

② 完全に消す

bash
$ minikube delete
🔥  Deleting "minikube" in docker ...
💀  Removed all traces of the "minikube" cluster.

クラスタのコンテナごと消えます。 作った Deployment も Service も消えます。

それでもイメージは残っています。

bash
$ docker system df
$ docker system prune -a
$ df -h /

prune -a は、動いていないコンテナが使っていないイメージを全部消します。 Dockerの回と同じで、docker system df で何が消えるか見てから打ってください。

minikube のコマンド自体も消したいなら、

bash
$ sudo rm /usr/local/bin/minikube /usr/local/bin/kubectl

~/.minikube と ~/.kube に設定が残ります。 minikube delete を先にやってあれば、残るのはごく小さい設定ファイルだけです。

bash
$ du -sh ~/.minikube ~/.kube 2>/dev/null

次の回で3台構成に進むなら、minikube stop までで止めておいて構いません。 しばらく間が空くなら minikube delete してディスクを返してください。

まとめ

  • Compose の限界は3つ。 落ちても誰も直さない / 台数を増やせない / 別のマシンに広げられない
  • docker run は「こう動かせ」という命令、Kubernetes は「この状態であれ」という宣言
  • Kubernetes の中身は「見て、違ったら直す」ループ。復旧の主体があなたからクラスタに移る
  • 宣言的が常に優れているわけではない。 「いま何が起きているか」は追いにくくなる。Compose で足りる規模に持ち込むと損をする
  • Pod はコンテナではない。 1つ以上のコンテナをまとめた最小の配置単位で、中のコンテナはIPを共有し localhost で繋がる
  • Pod は使い捨て。 落ちたら同じものは戻らず、名前もIPも違う新品が作られる。Pod のIPを設定に書かない
  • Deployment =「Pod を◯個保て」という宣言、Service =「入れ替わる Pod への変わらない入口」
  • Service は名前ではなく名札(label)で Pod を選ぶ
  • minikube の正体は Docker のコンテナ1個。 docker ps で見える
  • minikube service --url が返す 192.168.49.2 は、VMの外からは届かない
  • kubectl port-forward は ufw が効く。 docker run -p は効かなかった。違いは「INPUT を通るか」で、道具の名前では決まらない
  • マニフェスト(YAML)に書いて kubectl apply。 何度打っても同じ状態に寄る
  • --dry-run=client で、当てる前に検査する(nginx -t / docker compose config と同じ習慣)
  • minikube は1台。落ちたら全部落ちる。 replicas を増やしても置き場所は1つ
  • 後片づけは minikube stop(メモリだけ返す)か minikube delete(ディスクも返す)

参考リンク


次に読む

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

記事
← 前の記事1コマンドで環境が丸ごと立つ — Dockerの到達作品
→ 次の記事1台落としてもPodは移る — kubeadmで組む3台クラスタ

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

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

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

コメント

コメントする

目次