mac 安装 minikube

一、mac m1 安装 minikube

在 macOS 上安装 Minikube 的步骤如下,适用于基于 Intel 或 Apple Silicon(M1/M2/M3)芯片的机器。

✅ 1. 前提条件

brew install kubectl

✅ 2. 安装 Minikube

使用 Homebrew 安装:

brew install minikube

安装完成后,验证版本:

minikube version

✅ 3. 安装驱动程序(推荐 HyperKit 或 Docker)

Minikube 运行需要虚拟化驱动,推荐两种:

选项 A: 使用 Docker(推荐)

如果你已安装 Docker Desktop,可以直接使用它:

minikube start --driver=docker

如果未安装 Docker Desktop,可以通过 Homebrew 安装:

brew install --cask docker
open /Applications/Docker.app

选项 B: 使用 HyperKit(更轻量)

brew install hyperkit
brew install --cask minikube
minikube start --driver=hyperkit

注:首次运行 HyperKit 驱动时可能需要额外权限或安装 helper。


✅ 4. 启动 Minikube

示例命令(默认使用 docker 驱动):

minikube start --driver=docker

你可以指定资源:

minikube start --driver=docker --cpus=4 --memory=6g

✅ 5. 验证集群状态

kubectl get nodes

应看到状态为 Ready 的节点。


✅ 6. 常用命令

minikube stop            # 停止集群
minikube delete          # 删除集群
minikube dashboard       # 启动 Web UI 仪表盘
minikube status          # 查看状态
minikube ssh             # 登录虚拟机内部

🧠 补充:Apple Silicon 用户注意

  • Minikube 和 Docker 均支持 Apple Silicon,但镜像可能需使用 ARM 架构(或设置镜像策略)

  • 启动失败可添加调试参数:

minikube start --driver=docker --container-runtime=containerd --output=go

如果你有安装失败、网络问题、镜像拉取慢的问题,我可以帮你配置国内镜像源或者使用 Aliyun 镜像加速,随时说一声。需要我继续帮你搭一个 demo 应用跑在 Minikube 上吗?

二、mac M1 系统上运行 amd64 二进制文件报错

(base) changyou@192 ~ % minikube start --driver=docker --container-runtime=containerd --output=go
╭────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                        │
│    你正在尝试在 M1 系统上运行 amd64 二进制文件。                                                       │
│    请考虑改用 darwin/arm64 二进制文件。                                                                │
│    下载地址:https://github.com/kubernetes/minikube/releases/download/v1.36.0/minikube-darwin-arm64    │
│                                                                                                        │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────╯
😄  Darwin 15.5 上的 minikube v1.36.0
✨  根据用户配置使用 docker 驱动程序

💣  因 PROVIDER_DOCKER_INCORRECT_ARCH 错误而退出:Cannot use amd64 minikube binary to start minikube cluster with Docker driver on arm64 machine
💡  建议:Download and use arm64 version of the minikube binary
📘  文档:https://minikube.sigs.k8s.io/docs/start/

解解方法:

下载minikube-darwin-arm64,这是适用于 macOS M 系列(ARM 架构)的 Minikube 可执行文件。下面是手动安装到系统的标准流程:

✅ 安装步骤(终端操作)

1️⃣ 赋予执行权限

假设你下载的文件在 Downloads 目录:

chmod +x ~/Downloads/minikube-darwin-arm64

2️⃣ 移动到系统路径(安装)

sudo mv ~/Downloads/minikube-darwin-arm64 /usr/local/bin/minikube

/usr/local/bin 是 macOS 下的系统可执行路径,放进去后全局可用。

✅ 验证安装

minikube version

应该输出类似:

minikube version: v1.36.0
commit: ...

🧠 补充建议(可选)

🔁 如果之前通过 brew 安装过 x86_64 版本,请先卸载

brew uninstall minikube

然后再执行上述手动安装流程,避免路径冲突。

✅ 后续:启动 Minikube

确保 Docker Desktop 已经启动(并解决了 docker CLI 的路径问题),然后你可以启动:

minikube start --driver=docker

也可以指定资源或容器运行时:

minikube start --driver=docker --container-runtime=containerd --cpus=4 --memory=6g
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容