在GitLab CI中用Minikube测试Helm chart遇执行错误求助

我正在开发Helm Chart，想用GitLab CI部署并测试它。已经配置了使用Docker执行器的自托管Runner，作业采用包含kubectl、helm、ct等工具的自定义镜像，但Minikube始终无法正常工作。

我的目标是在Docker执行器中运行Minikube集群，测试需求较轻，无需持久化或高性能。但无论尝试何种方式，都会触发报错：

/usr/bin/minikube: cannot execute: required file not found

已尝试的操作 #

• 在自定义镜像中安装Minikube：最初使用基于Ubuntu的dind镜像，因systemd和cgroups问题切换为基础docker镜像，按文档直接从二进制安装Minikube；
• 在流水线中安装Minikube，将curl和install命令作为作业步骤；
• 在作业中使用docker:dind作为服务，尝试设置和不设置DOCKER_HOST: tcp://docker:2375变量，还尝试将DOCKER_HOST设为unix:///var/run/docker.sock以在主机上运行Minikube容器。

解决思路与步骤 #

这个报错通常由Minikube二进制权限不足、架构不匹配，或是Docker执行器环境缺少必要权限/依赖导致，以下是针对性的解决方法：

1. 确保Minikube二进制权限与架构匹配 #

• 安装后必须给二进制文件添加可执行权限：

  chmod +x /usr/bin/minikube
  

• 检查镜像架构（如x86_64/arm64）与Minikube二进制是否一致，下载对应版本：

  # 示例：x86_64架构下载命令
  curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
  install minikube-linux-amd64 /usr/bin/minikube
  chmod +x /usr/bin/minikube
  

2. 开启Runner的特权模式 #

Docker执行器默认是无特权容器，Minikube需要特权权限才能正常运行：

• 编辑GitLab Runner的config.toml配置文件，在[[runners]]区块下添加：

  privileged = true
  

• 重启GitLab Runner服务使配置生效。

3. 适配CI环境的Minikube启动参数 #

在CI作业中启动Minikube时，使用轻量且适配环境的参数：

minikube start --driver=docker --no-vtx-check --cpus=2 --memory=2048 --wait=all

• --driver=docker：使用Docker驱动适配当前执行器环境；
• --no-vtx-check：跳过硬件虚拟化检查，规避CI环境的限制；
• --cpus/--memory：设置轻量资源配置，满足测试需求；
• --wait=all：等待集群完全就绪后再执行后续步骤。

4. 正确配置docker:dind服务关联 #

如果使用docker:dind作为服务，需配置TLS相关环境变量，确保Minikube使用dind的Docker daemon：

test-helm-chart:
  image: your-custom-image:latest
  services:
    - name: docker:dind
      alias: docker
  variables:
    DOCKER_HOST: tcp://docker:2376
    DOCKER_TLS_CERTDIR: "/certs"
    DOCKER_TLS_VERIFY: 1
    DOCKER_CERT_PATH: "$DOCKER_TLS_CERTDIR/client"
  script:
    # 若自定义镜像未预装Minikube，执行安装步骤
    curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
    install minikube-linux-amd64 /usr/bin/minikube
    chmod +x /usr/bin/minikube
    # 启动Minikube
    minikube start --driver=docker --no-vtx-check --cpus=2 --memory=2048
    # 后续Helm chart测试步骤
    helm lint ./chart-dir
    helm install test-release ./chart-dir
    # 验证部署
    kubectl get pods

内容的提问来源于stack exchange，提问作者DaruZero