minikube的安装和测试

在 Ubuntu 22.04 上安装 Minikube 主要分为三个步骤：安装容器运行时（推荐 Docker）、下载并安装 Minikube 二进制文件、以及启动集群。考虑到国内网络环境，建议配置镜像加速以提升下载速度。

以下是详细的安装指南：

1. 前置准备：安装 Docker

Minikube 需要容器运行时来运行 Kubernetes 节点，Docker 是最常用且兼容性最好的选择。

# ‌更新系统包索引‌：

sudo apt update

sudo apt install -y curl wget apt-transport-https ca-certificates gnupg lsb-release

2. ‌安装 Docker CE‌：

为了方便，可以直接使用官方脚本或添加阿里云/清华源进行安装。以下以添加 Docker 官方源为例（若网络不佳，可替换为阿里云源）：

# 添加 Docker GPG key

sudo mkdir -p /etc/apt/keyrings

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

 

# 添加 Docker 仓库

echo \

  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \

  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

 

# 安装 Docker

sudo apt update

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

3. ‌配置用户权限与开机自启‌：

 # 将当前用户加入 docker 组，避免每次使用 sudo

sudo usermod -aG docker $USER

newgrp docker

 

# 启动并设置开机自启

sudo systemctl enable --now docker

4. ‌（可选）配置国内镜像加速‌：

如果拉取镜像速度慢，可以配置阿里云或其他国内加速器。编辑 /etc/docker/daemon.json：

json

{

  "registry-mirrors": [

    "https://docker.m.daocloud.io",

    "https://huecker.io",

    "https://dockerhub.timeweb.cloud"

  ]

}

 

配置后重启 Docker：sudo systemctl restart docker。

2. 安装 Minikube

你可以直接下载最新的 Linux amd64 二进制文件。

1. ‌下载 Minikube‌：

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64

注：如果上述链接访问缓慢，可以使用阿里云镜像源：

curl -LO https://kubernetes.oss-cn-hangzhou.aliyuncs.com/minikube/releases/latest/minikube-linux-amd64

2. ‌安装到系统路径‌：

sudo install minikube-linux-amd64 /usr/local/bin/minikube

rm minikube-linux-amd64

3. ‌验证安装‌：

minikube version

3. 安装 kubectl (Kubernetes 命令行工具)

为了管理集群，你需要安装 kubectl。

# 下载最新稳定版 kubectl

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"

# 赋予执行权限并移动

chmod +x ./kubectl

sudo mv ./kubectl /usr/local/bin/kubectl

# 验证版本

kubectl version --client

4. 启动 Minikube 集群

在 Ubuntu 22.04 上，推荐使用 docker 作为驱动程序。

1. ‌启动集群‌：

minikube start --driver=docker

 

‌针对国内用户的优化启动命令‌：

如果遇到镜像拉取失败，可以指定使用国内镜像仓库：

minikube start --driver=docker --image-mirror-country='cn' --image-repository='registry.cn-hangzhou.aliyuncs.com/google_containers'

2. ‌检查状态‌：

minikube status

kubectl get nodes

常见问题与排查

• ‌权限问题‌：不要使用 root 用户直接运行 minikube start --driver=docker，这会导致错误。请使用普通用户并确保该用户在 docker 组中。如果必须在 root 下运行，需添加 --force 参数，但不推荐。

• ‌缺少 conntrack‌：如果使用 none 驱动（即在裸机上直接运行），可能需要安装 conntrack：sudo apt install -y conntrack。

• ‌CRI-Dockerd‌：Kubernetes 1.24+ 版本移除了对 Docker Shim 的支持。如果你使用较新的 Minikube 和 Docker 驱动，Minikube 通常会自动处理或使用内置的容器运行时支持。如果遇到相关错误，可能需要安装 cri-dockerd。但在使用 minikube start --driver=docker 时，Minikube 通常会自行管理这一层，无需手动安装 cri-dockerd，除非使用 none 驱动。

完成以上步骤后，你就拥有了一个本地运行的单节点 Kubernetes 集群。可以通过 minikube dashboard 打开可视化管理界面。