⛵

Macでminikubeの基本的な使い方【2026年版】

に公開
2026/09/25

はじめに

この記事は、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 停止 / 削除

つまずきポイントまとめ

  1. --driver hyperkit はもう使えない — 既定の docker を使う。VM が必要なら vfkit
  2. minikube ip の NodePort に macOS から直接アクセスできない — minikube service --url / kubectl port-forward /
    minikube tunnel を使う
  3. eval $(minikube docker-env) は containerd では実験的 — minikube image build / minikube image load に置き換える
  4. ローカルイメージは imagePullPolicy: Never を付けないと ErrImagePull になる
  5. Apple Silicon では arm64 対応イメージが必要 — linux/amd64 のみのイメージは動かない
  6. --cpus / --memory は作成時のみ有効 — 変えたいなら作り直す
  7. ACTIVE PROFILE と ACTIVE KUBECONTEXT はズレる — minikube profile list で確認する

まとめ

ドライバーもコンテナランタイムも入れ替わりましたが、「ローカルで気軽に Kubernetes を触る」用途で minikube
が一番使いやすい、という結論は4年前と変わりませんでした。

むしろ、アドオン1コマンドで ingress や metrics-server が入り、プロファイルで Kubernetes のバージョン違いを並べて検証できる点は、kind
や Docker Desktop の Kubernetes には無い強みです。

macOS 特有のネットワークのクセ(NodePort に直接つながらない)さえ押さえておけば、あとは素直に使えます。

参照

  1. minikube - GitHub
  2. minikube start
  3. Drivers - macOS
  4. Pushing images into minikube
  5. Accessing apps
  6. WindowsのHyper-Vでminikubeの基本的な使い方

Discussion