@Minikube 部署与配置

Minikube 在 Ubuntu 系统上的安装、配置和应用部署

---

Minikube 在 Ubuntu 上的安装、配置与部署 SOP

1. 系统要求

• 操作系统：Ubuntu 20.04 LTS 或更高版本（推荐）。
• 硬件：
  • 至少 2核 CPU、2GB 内存、20GB 磁盘空间。
  • 虚拟化支持（通过 kvm 或 virtualbox 驱动）。
• 网络：需访问互联网以下载依赖。

---

2. 安装前准备

2.1 更新系统

sudo apt update && sudo apt upgrade -y

2.2 安装依赖工具

sudo apt install -y curl wget apt-transport-https

2.3 启用虚拟化支持

• 检查是否支持虚拟化：

  egrep -q 'vmx|svm' /proc/cpuinfo && echo "VT-x/AMD-V 支持" || echo "虚拟化不支持"
  

• 安装 KVM（推荐）：

  sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils
  sudo adduser $USER libvirt
  newgrp libvirt
  

2.3 启用Docker支持

• 配置docker

  # 卸载旧版本（如果有）
  sudo apt-get remove docker docker-engine docker.io containerd runc# 更新软件包索引并安装依赖
  sudo apt-get update
  sudo apt-get install -y apt-transport-https ca-certificates curl gnupg lsb-release# 添加 Docker 官方 GPG 密钥
  curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg# 添加 Docker 软件源
  echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.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-get update
  sudo apt-get install -y docker-ce docker-ce-cli containerd.io# 可以验证 Docker 是否安装成功
  sudo docker run hello-world
  

---

3. 安装 Minikube

3.1 安装 kubectl

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
kubectl version --client

3.2 安装 Minikube

# 官方minikube
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube
minikube version# 由于官方 Minikube 可能下载较慢，建议使用 阿里云镜像：
curl -Lo minikube https://kubernetes.oss-cn-hangzhou.aliyuncs.com/minikube/releases/v1.23.0/minikube-linux-amd64
chmod +x minikube
sudo mv minikube /usr/local/bin/
minikube version

---

4. 启动 Minikube

4.1 使用 KVM 或 Docker 驱动启动

• 使用kvm驱动

  minikube start --driver=kvm2
  

• 使用其他驱动选项（如 Docker 或 VirtualBox）：

  minikube start --driver=docker  # 需提前安装 Docker# 旧缓存可能导致冲突，删除后重新启动
  minikube delete
  rm -rf ~/.minikube
  minikube start --driver=docker --kubernetes-version=v1.23.0
  

4.2 验证集群状态

minikube status
kubectl get nodes
kubectl get pods -A

4.3 配置别名（可选）

alias kubectl="minikube kubectl --"

---

5. 部署示例应用

5.1 创建 Deployment

kubectl create deployment hello-minikube --image=k8s.gcr.io/echoserver:1.4

5.2 暴露 Service

kubectl expose deployment hello-minikube --type=NodePort --port=8080

5.3 访问应用

minikube service hello-minikube

• 或手动获取 URL：

  kubectl get svc hello-minikube
  curl $(minikube ip):<NodePort>
  

---

6. 管理 Minikube

6.1 暂停/恢复集群

minikube pause
minikube unpause

6.2 停止/删除集群

minikube stop
minikube delete --all

6.3 启用插件（如 Dashboard）

minikube addons enable dashboard
minikube dashboard

---

7. 故障排查

• 查看日志：

  minikube logs
  

• 重置 Minikube：

  minikube delete && minikube start
  

• 驱动问题：
  • 确保用户已加入 libvirt 组并重启会话。
  • 检查 KVM 状态：

    sudo systemctl status libvirtd
    

---

8. 进阶配置

8.1 自定义资源分配

minikube start --driver=kvm2 --cpus=4 --memory=8g --disk-size=50g

8.2 使用本地镜像

eval $(minikube docker-env)
docker build -t my-app .
kubectl run my-app --image=my-app

---

附录

• Minikube 文档：https://minikube.sigs.k8s.io/docs/
• Kubernetes 文档：https://kubernetes.io/docs/

---

通过此文档，您可以在 Ubuntu 系统上完成 Minikube 的完整安装、配置及应用部署流程。根据实际需求调整参数（如驱动、资源限制等）。