Ошибка 'driver not supported' в Minikube на Linux: решение

Что означает ошибка "driver not supported" в Minikube

Ошибка minikube driver not supported (или более полный текст The specified driver is not supported on this platform) возникает, когда Minikube не может найти, инициализировать или использовать выбранный драйвер для создания виртуальной машины или контейнера, в котором будут работать компоненты Kubernetes.

Типичный сценарий появления: Вы выполняете команду minikube start --driver=docker (или с другим драйвером) и получаете вывод, указывающий, что драйвер не поддерживается, недоступен или не может быть инициализирован. Это происходит на этапе проверки окружения перед созданием кластера.

Причины возникновения

1. Драйвер не установлен. Minikube обнаружил в системе наличие драйвера (например, docker), но сам бинарный файл или его служба не найдены.
2. Служба драйвера не запущена. Драйвер (Docker, Podman, VirtualBox) установлен, но его фоновый процесс (демон) не активен.
3. Отсутствие прав доступа. Текущий пользователь не имеет прав на взаимодействие с сокетом драйвера (например, /var/run/docker.sock для Docker).
4. Несовместимость версий. Установлена устаревшая или слишком новая версия драйвера, несовместимая с текущей версией Minikube.
5. Драйвер не поддерживается на данной платформе. Например, попытка использовать hyperv на Linux или virtualbox без установленных kernel-модулей.
6. Конфликт с SELinux/AppArmor. Политики безопасности могут блокировать доступ Minikube к ресурсам драйвера.

Способы решения

Способ 1: Проверка и запуск службы драйвера (для Docker/Podman)

Наиболее частая причина — остановленная служба контейнерного движка.

1. Проверьте статус службы Docker:

   sudo systemctl status docker
   

   
   Если служба неактивна (inactive), запустите её:

   sudo systemctl start docker
   sudo systemctl enable docker # Для автозапуска при загрузке
   

   
   Для Podman замените docker на podman.
2. Перезапустите Minikube с явным указанием драйвера:

   minikube start --driver=docker
   

Способ 2: Настройка прав доступа (группа docker/podman)

Если служба работает, но Minikube всё равно не может подключиться, проблема, скорее всего, в правах.

1. Проверьте, в каких группах состоит ваш пользователь:

   groups
   

   
   В выводе должна быть группа docker (или podman).
2. Если группы нет, добавьте текущего пользователя в неё:

   sudo usermod -aG docker $USER
   

   
   Важно: Изменения вступают в силу после выхода из системы и повторного входа (или перезагрузки). Недостаточно просто открыть новый терминал.
3. После повторного входа проверьте доступ:

   docker ps # Должен показать список контейнеров без ошибок 'permission denied'
   

   
   Теперь команда minikube start --driver=docker должна сработать.

Способ 3: Использование альтернативного драйвера

Если настройка Docker/Podman нежелательна или невозможна, используйте другие драйверы.

• Драйвер podman: Полная замена Docker. Убедитесь, что Podman установлен (sudo apt install podman), служба запущена (sudo systemctl start podman) и пользователь в группе podman.

  minikube start --driver=podman
  

• Драйвер none (без виртуализации): Запускает Kubernetes-компоненты напрямую на хостовой системе. Требует ручной настройки cgroups и сетевых пространств имён. Подходит для продвинутых сценариев или CI.

  sudo minikube start --driver=none
  

  
  Внимание: Для работы none-драйвера необходимо активировать cgroups v2. Инструкция ниже.

Способ 4: Активация cgroups v2 для драйвера none

Ошибка driver not supported при использовании --driver=none часто вызвана неактивированными cgroups версии 2.

1. Отредактируйте конфигурацию GRUB:

   sudo nano /etc/default/grub
   

2. Найдите строку GRUB_CMDLINE_LINUX и добавьте параметр systemd.unified_cgroup_hierarchy=1. Пример:

   GRUB_CMDLINE_LINUX="... systemd.unified_cgroup_hierarchy=1"
   

3. Обновите конфигурацию GRUB и перезагрузитесь:

   sudo update-grub
   sudo reboot
   

4. После перезагрузки проверьте активацию cgroups v2:

   mount -t cgroup2 none /sys/fs/cgroup  # Должен смонтироваться без ошибок
   

   Теперь minikube start --driver=none должен пройти проверку драйвера.

Способ 5: Переустановка/обновление Minikube и драйвера

Проблема может быть в несовместимости версий.

1. Обновите Minikube до последней стабильной версии:

   sudo apt remove minikube # Если установлен через apt
   curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
   sudo install minikube-linux-amd64 /usr/local/bin/minikube
   

2. Переустановите драйвер (например, Docker):

   sudo apt purge docker.io docker-ce containerd
   sudo apt update
   sudo apt install docker.io
   sudo systemctl start docker
   sudo systemctl enable docker
   

3. Повторите попытку запуска Minikube.

Профилактика

• Всегда добавляйте пользователя в группу драйвера (docker/podman) сразу после установки движка.
• Используйте стабильные версии ПО. Регулярно обновляйте Minikube, Docker/Podman и ядро системы.
• Для драйвера none заранее активируйте cgroups v2 в параметрах ядра, если планируете его использовать.
• Перед запуском Minikube проверяйте статус службы драйвера командой systemctl status <driver>.
• Читайте вывод команды minikube driver ls. Она даёт точную информацию о том, какие драйверы доступны и почему конкретный может быть недоступен.