Macでminikubeの基本的な使い方【2026年版】
はじめに
この記事は、2022年に書いた「Macでminikubeの基本的な使い方」を全面的に書き直したものです。
当時は Intel Mac + hyperkit ドライバーが前提でしたが、4年でまわりの前提がまるごと入れ替わりました。
| 2022年版 | 今回(2026年版) | |
|---|---|---|
| Mac | Intel Core i5 | Apple Silicon(arm64) |
| minikube | v1.25.2 | v1.39.0 |
| Kubernetes | v1.23.3 | v1.37.0 |
| ドライバー | hyperkit | docker |
| コンテナランタイム | Docker | containerd |
特に大きいのが次の2点です。
-
hyperkit ドライバーは無くなりました。Apple Silicon では動かず、
minikube start --helpのドライバー一覧からも消えています -
クラスタ内のコンテナランタイムは containerd が既定になりました。
eval $(minikube docker-env)を前提にした手順はそのままでは通用しません
本記事では、いま Mac で minikube を使うならどうするか、を実際のコマンド出力付きでまとめ直します。
動作環境
| 項目 | バージョン |
|---|---|
| Mac | Apple Silicon(arm64) |
| OS | macOS 27.0 |
| minikube | v1.39.0 |
| kubectl | v1.37.1 |
| Docker Desktop | 29.8.0 |
| Kubernetes(クラスタ内) | v1.37.0 |
| コンテナランタイム(クラスタ内) | containerd 2.3.4 |
minikubeとは
minikube はローカルに使い捨ての Kubernetes クラスタを1コマンドで立てるツールです。
昔は「仮想マシンを作ってその中で Kubernetes を動かすツール」でしたが、いまの既定構成はもう少し軽くて、 Docker
コンテナを1台のノードに見立てて、その中で Kubernetes を動かします。
macOS からクラスタの中身がどう見えるかは、このネストを意識しておくとハマりにくくなります(後述の「macOS + docker ドライバーでは
NodePort に直接つながらない」)。
Docker Desktop の Kubernetes や kind との使い分け
| minikube | Docker Desktop の Kubernetes | kind | |
|---|---|---|---|
| 起動 | minikube start |
設定画面のチェックボックス | kind create cluster |
| 複数クラスタ | プロファイルで何個でも | 1つだけ | 何個でも |
| Kubernetes バージョン指定 |
--kubernetes-version で自由 |
Docker Desktop 依存 | イメージタグで指定 |
| アドオン | ingress / metrics-server / dashboard などを1コマンドで | なし | 自分で入れる |
| ドライバー | docker 以外に VM 系も選べる | Docker 固定 | Docker 固定 |
「アドオンで ingress や metrics-server をさっと足したい」「Kubernetes のバージョンを切り替えて試したい」「クラスタを複数持ちたい」なら
minikube が一番ラクです。
インストール
brew install minikube kubernetes-cli
$ minikube version
minikube version: v1.39.0
commit: 7a9f6a841470a207de8cf4bafcccee0969d8ba10
$ kubectl version --client
Client Version: v1.37.1
Kustomize Version: v5.8.1
ドライバーを選ぶ
https://minikube.sigs.k8s.io/docs/drivers/#macos
いま選べるドライバーは minikube start --help で確認できます。
$ minikube start --help | grep "Driver is one of"
Driver is one of: qemu2, vfkit, krunkit (experimental), parallels, virtualbox, docker, podman (experimental), ssh (defaults to auto-detect)
| ドライバー | 方式 | コメント |
|---|---|---|
docker |
コンテナ | 既定・おすすめ。Docker Desktop が動いていればそのまま使える。起動が速い |
vfkit |
VM | Apple の Virtualization.framework。hyperkit の後継。Docker を入れたくない場合に |
krunkit |
VM | libkrun ベース。GPU 用途向けで実験的 |
qemu2 |
VM | QEMU。ネットワークに socket_vmnet が別途必要 |
parallels |
VM | Parallels Desktop を持っているなら |
virtualbox |
VM | Apple Silicon では実質選べない |
podman |
コンテナ | 実験的 |
ssh |
リモート | 別マシンの Linux をノードとして使う |
とくに理由がなければ docker で問題ありません。指定しなければ自動で選ばれます。
クラスタを起動する
$ minikube start --cpus 2 --memory 4096
😄 Darwin 27.0 (arm64) 上の [minikube] minikube v1.39.0
✨ docker ドライバーが自動的に選択されました
📌 root 権限を持つ Docker Desktop ドライバーを使用
👍 Starting "minikube" primary control-plane node in "minikube" cluster
🚜 Pulling base image v0.0.51 ...
🔥 Creating docker container (CPUs=2, Memory=4096MB) ...
📦 containerd 2.3.4 で Kubernetes v1.37.0 を準備しています...
▪ 証明書と鍵を作成しています...
▪ コントロールプレーンを起動しています...
▪ RBAC のルールを設定中です...
🔗 CNI (コンテナーネットワークインターフェース) を設定中です...
🔎 Kubernetes コンポーネントを検証しています...
▪ gcr.io/k8s-minikube/storage-provisioner:v5 イメージを使用しています
🌟 有効なアドオン: storage-provisioner, default-storageclass
🏄 終了しました!kubectl がデフォルトで「minikube」クラスターと「default」ネームスペースを使用するよう設定されました
2022年版の出力と比べると、hyperkit VM を作成 が Creating docker container に、Docker 20.10.12 で Kubernetes を準備 が
containerd 2.3.4 で Kubernetes を準備 に変わっているのが分かります。
よく使う起動オプションはこのあたりです。
| オプション | 説明 |
|---|---|
--cpus int |
割り当てる CPU 数。max で上限まで |
--memory |
割り当てメモリ。4096 や 4g、max も可 |
--kubernetes-version |
v1.34.0 のような固定指定。既定は stable
|
--driver |
上表のドライバーを明示指定 |
--container-runtime |
containerd(既定)/ docker / cri-o
|
--nodes int |
起動時に作るノード数。既定は 1 |
-p, --profile |
クラスタに名前を付ける。既定は minikube
|
--addons |
起動と同時に有効化するアドオン |
状態を確認する
minikube status
$ minikube status
minikube
type: Control Plane
host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured
kubectl から見る
$ kubectl get nodes -o wide
NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME
minikube Ready control-plane 125m v1.37.0 192.168.49.2 <none> Debian GNU/Linux 12 (bookworm) 7.0.12-linuxkit (arm64) containerd://2.3.4
CONTAINER-RUNTIME が containerd://2.3.4 になっている点が、昔との一番の違いです。
プロファイル一覧
$ minikube profile list
┌───────────┬────────┬────────────┬──────────────┬─────────┬────────┬───────┬────────────────┬────────────────────┐
│ PROFILE │ DRIVER │ RUNTIME │ IP │ VERSION │ STATUS │ NODES │ ACTIVE PROFILE │ ACTIVE KUBECONTEXT │
├───────────┼────────┼────────────┼──────────────┼─────────┼────────┼───────┼────────────────┼────────────────────┤
│ minikube │ docker │ containerd │ 192.168.49.2 │ v1.37.0 │ OK │ 1 │ * │ │
│ zenn-demo │ docker │ containerd │ 192.168.58.2 │ v1.37.0 │ OK │ 1 │ │ * │
└───────────┴────────┴────────────┴──────────────┴─────────┴────────┴───────┴────────────────┴────────────────────┘
ACTIVE PROFILE(minikube コマンドの既定の対象)と ACTIVE KUBECONTEXT(kubectl の向き先)は 別物
で、上のようにズレることがあります。ズレたら次のどちらかで揃えます。
minikube profile zenn-demo # minikube 側を合わせる
kubectl config use-context minikube # kubectl 側を合わせる
アプリを動かしてみる
$ kubectl create deployment hello --image=kicbase/echo-server:1.0
deployment.apps/hello created
$ kubectl expose deployment hello --type=NodePort --port=8080
service/hello exposed
$ kubectl get deploy,svc,pod -o wide
NAME READY UP-TO-DATE AVAILABLE AGE CONTAINERS IMAGES SELECTOR
deployment.apps/hello 1/1 1 1 4s echo-server kicbase/echo-server:1.0 app=hello
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE SELECTOR
service/hello NodePort 10.106.86.49 <none> 8080:31259/TCP 4s app=hello
service/kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 33s <none>
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES
pod/hello-9758c5486-m82xj 1/1 Running 0 4s 10.244.0.3 zenn-demo <none> <none>
macOS + docker ドライバーでは NodePort に直接つながらない
ここが最大のハマりどころです。minikube ip で出てくるアドレスに素直にアクセスしても、 タイムアウトします。
$ minikube ip
192.168.58.2
$ curl -m 5 http://192.168.58.2:31259/
curl: (28) Connection timed out after 5002 milliseconds
このアドレスは Docker Desktop の Linux VM の中のネットワークで、macOS からは経路がないためです。Linux で docker
ドライバーを使っている場合は素直につながるので、「Linux の記事どおりにやったのに動かない」となりがちです。
解決策は3つあります。
1. minikube service --url
minikube がローカルポートへのトンネルを張ってくれます。
$ minikube service hello --url
http://127.0.0.1:54696
❗ Docker ドライバーを darwin 上で使用しているため、実行するにはターミナルを開く必要があります。
$ curl http://127.0.0.1:54696
Request served by hello-9758c5486-m82xj
HTTP/1.1 GET /
Host: 127.0.0.1:54696
Accept: */*
User-Agent: curl/8.7.1
メッセージのとおり、 このコマンドを実行したターミナルを開いたままにする必要があります。閉じるとトンネルも切れます。
--url を付けずに minikube service hello とすると、そのままブラウザが開きます。
Service 一覧は minikube service list で見られます。
$ minikube service list
┌─────────────┬────────────┬──────────────┬─────┐
│ NAMESPACE │ NAME │ TARGET PORT │ URL │
├─────────────┼────────────┼──────────────┼─────┤
│ default │ hello │ 8080 │ │
│ default │ kubernetes │ No node port │ │
│ kube-system │ kube-dns │ No node port │ │
└─────────────┴────────────┴──────────────┴─────┘
2. kubectl port-forward
Service の種類に関係なく使えて、ポート番号を自分で決められます。
kubectl port-forward svc/hello 8080:8080
3. minikube tunnel
LoadBalancer タイプの Service に EXTERNAL-IP を割り当てたり、Ingress を 127.0.0.1 で受けたりする場合に使います。特権ポート(80/443)を使うため
sudo のパスワードを聞かれます。こちらも実行しっぱなしにするコマンドです。
minikube tunnel
ローカルでビルドしたイメージを使う
昔の定番は eval $(minikube docker-env) でしたが、 既定のランタイムが containerd
になったため、この方法は実験的な位置づけになりました。実際、実行すると警告が出ます。
$ minikube docker-env
❗ Using the docker-env command with the containerd runtime is a highly experimental feature, please provide feedback or contribute to make it better
...
いまは次の2つを使うのが素直です。
minikube image build:クラスタの中でビルドする
$ cat app/Dockerfile
FROM nginx:alpine
RUN echo "<h1>hello minikube</h1>" > /usr/share/nginx/html/index.html
$ minikube image build -t my-web:v1 ./app
...
#6 exporting to image
#6 naming to docker.io/library/my-web:v1 done
#6 DONE 0.0s
$ minikube image ls | grep my-web
docker.io/library/my-web:v1
minikube image load:Mac 側の Docker からコピーする
$ docker images busybox:1.37
IMAGE ID DISK USAGE CONTENT SIZE EXTRA
busybox:1.37 bdf57e528e45 6.14MB 1.9MB
$ minikube image load busybox:1.37
$ minikube image ls | grep busybox
docker.io/library/busybox:1.37
imagePullPolicy に注意
ローカルにしか無いイメージをそのまま使うと、タグによっては外部レジストリを見に行って ErrImagePull になります。
imagePullPolicy: Never(または IfNotPresent)を指定します。
$ kubectl create deployment my-web --image=my-web:v1
$ kubectl patch deployment my-web \
-p '{"spec":{"template":{"spec":{"containers":[{"name":"my-web","imagePullPolicy":"Never"}]}}}}'
$ kubectl get pods -l app=my-web
NAME READY STATUS RESTARTS AGE
my-web-6448d7f78c-2pf4q 1/1 Running 0 10s
アドオンを使う
minikube の強みはここです。一覧は minikube addons list で確認できます。
metrics-server
kubectl top を使えるようにします。
$ minikube addons enable metrics-server
▪ registry.k8s.io/metrics-server/metrics-server:v0.9.0 イメージを使用しています
🌟 'metrics-server' アドオンが有効です
メトリクスが溜まるまで1分ほどかかります(その間は error: Metrics API not available になります)。
$ kubectl top nodes
NAME CPU(cores) CPU(%) MEMORY(bytes) MEMORY(%)
zenn-demo 166m 0% 827Mi 10%
$ kubectl top pods
NAME CPU(cores) MEMORY(bytes)
hello-9758c5486-m82xj 1m 3Mi
my-web-6448d7f78c-2pf4q 0m 17Mi
ingress
$ minikube addons enable ingress
💡 アドオンを有効にした後、「minikube tunnel」を実行することで、ingress リソースが「127.0.0.1」で利用可能になります
▪ registry.k8s.io/ingress-nginx/controller:v1.15.1 イメージを使用しています
🔎 ingress アドオンを検証しています...
🌟 'ingress' アドオンが有効です
有効化のメッセージ自体が「minikube tunnel を実行してください」と言ってくれます。macOS では必須なので、Ingress
を試すときは別ターミナルで minikube tunnel を動かしたままにしてください。
dashboard
$ minikube dashboard --url
🔌 ダッシュボードを有効化しています...
▪ docker.io/kubernetesui/dashboard:v2.7.0 イメージを使用しています
▪ docker.io/kubernetesui/metrics-scraper:v1.0.8 イメージを使用しています
🤔 ダッシュボードの状態を検証しています...
🚀 プロキシーを起動しています...
🤔 プロキシーの状態を検証しています...
http://127.0.0.1:54822/api/v1/namespaces/kubernetes-dashboard/services/http:kubernetes-dashboard:/proxy/
--url を付けると URL を出すだけ、付けなければブラウザが開きます。これも実行しっぱなしにするコマンドです。
複数ノードにする
1コマンドでワーカーノードを追加できます。
$ minikube node add
😄 Adding node m02 to cluster zenn-demo as [worker]
👍 Starting "zenn-demo-m02" worker node in "zenn-demo" cluster
🚜 Pulling base image v0.0.51 ...
🔥 Creating docker container (CPUs=2, Memory=7883MB) ...
📦 containerd 2.3.4 で Kubernetes v1.37.0 を準備しています...
🔎 Kubernetes コンポーネントを検証しています...
🏄 zenn-demo への m02 追加に成功しました!
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
zenn-demo Ready control-plane 3m49s v1.37.0
zenn-demo-m02 Ready <none> 40s v1.37.0
最初から複数ノードで作るなら minikube start --nodes 2 です。Pod の分散や nodeSelector、DaemonSet の挙動を試したいときに便利です。
プロファイルでクラスタを使い分ける
-p(--profile)を付けると、独立したクラスタをいくつでも持てます。「Kubernetes 1.34 と 1.37 を並べて検証する」といった使い方ができます。
minikube start -p k8s-134 --kubernetes-version v1.34.0
minikube start -p k8s-137 --kubernetes-version v1.37.0
minikube profile list
minikube -p k8s-134 status
kubectl config use-context k8s-134
中を覗く・止める・消す
ノードに入る
$ minikube ssh -- "uname -a; cat /etc/os-release | head -2"
Linux zenn-demo 7.0.12-linuxkit #1 SMP PREEMPT Thu Aug 27 14:02:21 UTC 2026 aarch64 GNU/Linux
PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
NAME="Debian GNU/Linux"
停止
$ minikube stop
✋ 「zenn-demo-m02」ノードを停止しています...
🛑 SSH 経由で「zenn-demo-m02」の電源をオフにしています...
✋ 「zenn-demo」ノードを停止しています...
🛑 SSH 経由で「zenn-demo」の電源をオフにしています...
🛑 2 台のノードが停止しました。
minikube pause なら Kubernetes のコントロールプレーンだけ止めて CPU を空けられます(minikube unpause で復帰)。
削除
$ minikube delete
🔥 docker の「zenn-demo」を削除しています...
🔥 コンテナー「zenn-demo」を削除しています...
🔥 コンテナー「zenn-demo-m02」を削除しています...
🔥 /Users/gekal/.minikube/machines/zenn-demo を削除しています...
💀 クラスター「zenn-demo」の全てのトレースを削除しました。
全プロファイルとキャッシュまで消すなら次のとおりです。
minikube delete --all --purge
よく使うコマンドまとめ
| コマンド | 用途 |
|---|---|
minikube start |
クラスタを作成・起動 |
minikube status |
クラスタの状態確認 |
minikube profile list |
プロファイル(クラスタ)一覧 |
minikube ip |
ノードの IP(macOS からは直接つながらない点に注意) |
minikube service <svc> --url |
Service へのトンネルを張って URL を表示 |
minikube tunnel |
LoadBalancer / Ingress を 127.0.0.1 で受ける |
minikube image build / image load
|
ローカルイメージをクラスタに入れる |
minikube addons enable <name> |
アドオンを有効化 |
minikube dashboard |
Web ダッシュボードを開く |
minikube node add |
ワーカーノードを追加 |
minikube ssh |
ノードにログイン |
minikube logs |
起動失敗時の調査 |
minikube pause / unpause
|
一時停止 / 再開 |
minikube stop / delete
|
停止 / 削除 |
つまずきポイントまとめ
-
--driver hyperkitはもう使えない — 既定のdockerを使う。VM が必要ならvfkit -
minikube ipの NodePort に macOS から直接アクセスできない —minikube service --url/kubectl port-forward/
minikube tunnelを使う -
eval $(minikube docker-env)は containerd では実験的 —minikube image build/minikube image loadに置き換える -
ローカルイメージは
imagePullPolicy: Neverを付けないとErrImagePullになる -
Apple Silicon では arm64 対応イメージが必要 —
linux/amd64のみのイメージは動かない -
--cpus/--memoryは作成時のみ有効 — 変えたいなら作り直す -
ACTIVE PROFILEとACTIVE KUBECONTEXTはズレる —minikube profile listで確認する
まとめ
ドライバーもコンテナランタイムも入れ替わりましたが、「ローカルで気軽に Kubernetes を触る」用途で minikube
が一番使いやすい、という結論は4年前と変わりませんでした。
むしろ、アドオン1コマンドで ingress や metrics-server が入り、プロファイルで Kubernetes のバージョン違いを並べて検証できる点は、kind
や Docker Desktop の Kubernetes には無い強みです。
macOS 特有のネットワークのクセ(NodePort に直接つながらない)さえ押さえておけば、あとは素直に使えます。
Discussion