Docker中Jenkins启动Minikube失败：Docker驱动不可用root权限运行

问题背景 #

运行在Docker容器内的Jenkins执行流水线时，启动Minikube触发如下错误：

+ minikube start
* minikube v1.35.0 on Debian 12.8 (docker/amd64)
* Automatically selected the docker driver. Other choices: none, ssh
* The "docker" driver should not be used with root privileges. If you wish to continue as root, use --force.
* If you are running minikube within a VM, consider using --driver=none:

X Exiting due to DRV_AS_ROOT: The "docker" driver should not be used with root privileges.

核心原因是Jenkins容器以root用户运行，而Minikube的docker驱动默认禁止root用户启动。

解决方案 #

方法1：临时绕过root权限限制（快速修复） #

直接在Minikube启动命令中添加--force参数，强制允许root用户使用docker驱动。修改Jenkinsfile中Deploy to Minikube阶段的代码：

stage('Deploy to Minikube') {
    agent any
    steps {
        script {
            // 启动Minikube时添加--force参数
            sh "minikube start --force"

            sh "minikube dashboard &"
            sh "kubectl apply -f k8s"
            sh "kubectl get pods -A"
        }
    }
}

方法2：以非root用户运行Jenkins容器（推荐，更安全） #

避免以root用户运行Jenkins容器，调整配置确保jenkins用户具备必要权限：

1. 修改docker-compose.yml，移除user: root配置：

version: '3.9'

services:
  jenkins:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: jenkins-server
    ports:
      - "8080:8080"    
      - "50000:50000"  
    volumes:
      - jenkins_home:/var/jenkins_home   
      - /var/run/docker.sock:/var/run/docker.sock 
      - ../k8s:/var/jenkins_home/k8s 
      - ./init.groovy.d:/var/jenkins_home/init.groovy.d 
    environment:
      JAVA_OPTS: "-Djenkins.install.runSetupWizard=false"
    # 移除 user: root 配置

volumes:
  jenkins_home:

2. 修改Dockerfile，安装依赖后切换回jenkins用户，并将其加入docker组：

FROM jenkins/jenkins:lts

# 安装插件
COPY plugins.txt /usr/share/jenkins/ref/plugins.txt
RUN jenkins-plugin-cli --plugin-file /usr/share/jenkins/ref/plugins.txt

# 复制初始化脚本
COPY init.groovy.d/ /var/jenkins_home/init.groovy.d/

# 切换到root安装依赖
USER root
RUN apt-get update && apt-get install -y docker.io

# 将jenkins用户加入docker组，获取Docker socket访问权限
RUN usermod -aG docker jenkins

# 安装kubectl
RUN curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" \
    && chmod +x kubectl \
    && mv kubectl /usr/local/bin/

# 安装Minikube
RUN curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
    && chmod +x minikube-linux-amd64 \
    && mv minikube-linux-amd64 /usr/local/bin/minikube

# 切换回jenkins用户运行Jenkins
USER jenkins

修改完成后重新构建镜像并启动容器，此时Jenkins以非root用户运行，Minikube可正常启动无需额外参数。

方法3：使用Minikube的none驱动（特定场景适用） #

如果不需要在Minikube中嵌套运行Docker容器，可切换到none驱动，直接使用宿主机内核：
修改Jenkinsfile中的启动命令：

sh "minikube start --driver=none"

注意：该驱动需要宿主机提前安装containerd、kubelet等依赖，且需确保宿主机权限足够。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu