Установка Minikube на Debian 11

О чём эта инструкция

Краткое руководство по развёртыванию Minikube на Debian 11: подготовка окружения, установка зависимостей, запуск кластера, доступ к дашборду и рекомендации по отладке и безопасности. Подойдёт для разработчиков и системных администраторов, которые хотят поднять локальный Kubernetes для тестов.

Требования

• Свежая установка Debian 11.
• Установлен root-пароль или доступ к sudo для установки пакетов.
• Рекомендуется минимум 2 CPU и ~2–4 ГБ оперативной памяти для виртуальной машины/контейнера Minikube.

Важно: Minikube можно запускать как в виде VM, так и с драйвером Docker или в режиме “none” (на хосте). Прочитайте раздел «Альтернативные драйверы» перед выбором.

Шаг 1. Установка Docker

Перед Minikube требуется Docker (если вы планируете запуск с docker-драйвером).

Выполните:

apt install docker.io -y

Проверьте версию:

docker --version

Ожидаемый пример вывода:

Docker version 20.10.5+dfsg1, build 55c4c88

Примечание: если вы запускаете minikube от root-а, Docker-драйвер может выдавать предупреждение. Лучше создать непривилегированного пользователя и добавить его в группу docker:

usermod -aG docker <ваш_пользователь>
newgrp docker

Шаг 2. Установка kubectl

kubectl — CLI для управления кластером Kubernetes. В Debian 11 его удобно установить через snap.

Установите snapd:

apt install snapd -y

Создайте символьную ссылку для snap и добавьте путь в профиль:

ln -s /var/lib/snapd/snap /snap
echo 'export PATH=$PATH:/var/lib/snapd/snap/bin' | tee -a /etc/profile.d/snap.sh
systemctl enable --now snapd.service snapd.socket

Установите kubectl и создайте удобную ссылку:

snap install kubectl --classic
ln -s /snap/kubectl/current/kubectl /usr/bin/

Проверьте:

kubectl version -o yaml

Пример вывода клиента (clientVersion) присутствует в оригинале и показывает совместимую версию kubectl.

Шаг 3. Установка Minikube

Minikube поставляется в виде бинарного файла; скачайте и установите его в системный путь:

wget https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 -O minikube
cp minikube /usr/local/bin/
chmod +x /usr/local/bin/minikube

Проверьте:

minikube version

Пример вывода в инструкции: minikube version: v1.28.0

Шаг 4. Запуск Minikube

Запустите кластер (в примере используется принудительный запуск):

minikube start --force

Этот шаг загрузит образы и создаст контрол-плейн. В выводе вы можете увидеть сообщения о выборе драйвера (Docker, none, ssh и т.д.) и предупреждения, если запущено от root.

Пример фрагмента вывода (сокращённо):

minikube v1.28.0 on Debian 11.6 (kvm/amd64)
Automatically selected the docker driver. Other choices: none, ssh
Using Docker driver with root privileges
Starting control plane node minikube in cluster minikube
Pulling base image ...
Creating docker container (CPUs=2, Memory=2200MB) ...
Preparing Kubernetes v1.25.3 on Docker 20.10.20 ...
Enabled addons: default-storageclass, storage-provisioner
Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default

После старта проверьте статус кластера:

kubectl cluster-info
kubectl get nodes

Ожидаемый пример вывода:

Kubernetes control plane is running at https://192.168.49.2:8443
NAME       STATUS   ROLES           AGE   VERSION
minikube   Ready    control-plane   67s   v1.25.3

Доступ в контейнер Minikube

Чтобы попасть внутрь контейнера/VM minikube:

minikube ssh

Выход из shell контейнера:

exit

Остановка и удаление кластера

minikube stop
minikube delete

Проверить статус:

minikube status

Ожидаемый вывод:

minikube
type: Control Plane
host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured

Доступ к дашборду Kubernetes

Minikube поставляется с веб-дашбордом. Сначала посмотрите список аддонов:

minikube addons list

Чтобы увидеть запущенные поды во всех неймспейсах:

kubectl get pods --all-namespaces

Откройте URL дашборда:

minikube dashboard --url

Пример вывода даёт локальный адрес типа http://127.0.0.1:45627/… — по умолчанию доступен только с локальной машины.

Если нужно открыть дашборд с внешнего хоста, запустите прокси API-сервера:

kubectl proxy --address='0.0.0.0' --disable-filter=true

Затем откройте в браузере:

http://вашегосервера>:8001/api/v1/namespaces/kubernetes-dashboard/services/http:kubernetes-dashboard:/proxy

Полезные аддоны и управление

Для полноты функционала включите метрики:

minikube addons enable metrics-server

Список часто используемых аддонов: dashboard, metrics-server, ingress, registry, storage-provisioner.

Проверка работоспособности и контрольные пункты

Критерии приёмки

• kubectl успешно возвращает информацию о кластере (kubectl cluster-info).
• Сервис control plane доступен по HTTPS (пример вывода с IP и портом).
• Поды kube-system в статусе Running.
• Дашборд доступен локально или через kubectl proxy.

Роль-based чек-листы

• Администратор:

  • Проверил версии Docker, kubectl и minikube.
  • Убедился в доступности портов и наличии ресурсов.
  • Произвёл настройку бэкапов и логирования.

• Разработчик:

  • Развернул тестовую workload и проверил доступ к сервисам.
  • Использовал kubectl port-forward или сервисы типа NodePort для доступа.

Быстрый набор команд (cheat sheet)

• Установить Docker: apt install docker.io -y
• Установить kubectl: snap install kubectl –classic
• Установить minikube: скачать бинарник и cp /usr/local/bin
• Запустить кластер: minikube start
• Остановить: minikube stop
• Удалить: minikube delete
• Дашборд: minikube dashboard –url
• Список подов: kubectl get pods –all-namespaces
• SSH в minikube: minikube ssh

Альтернативные подходы и драйверы

• Docker driver (по умолчанию в инструкции) — быстрый запуск, подходит для большинства dev-машин.
• none driver — запускает компоненты на хосте (требует systemd, root права), полезен для bare-metal или CI.
• kvm2/virtualbox — полноценная VM с изоляцией, полезно для тестов, где нужен отдельный хост.

Выбор: если вы хотите меньшую изоляцию и быстрый цикл разработки — используйте docker; если нужна изоляция — kvm2/virtualbox.

Типовые проблемы и решения

• “The ‘docker’ driver should not be used with root privileges” — запустите minikube не от root или используйте флаг –driver=none с осторожностью. Лучше добавить пользователя в группу docker.

• Сеть и порты: если дашборд недоступен извне, убедитесь, что kubectl proxy запущен с –address=0.0.0.0 и на уровне брандмауэра (iptables/ufw) открыт порт 8001.

• Недостающие ресурсы: если контейнер minikube падает на старте, выделите больше памяти/CPU: minikube start –memory=4096 –cpus=2

• Проблемы с образами: можно принудительно очистить и скачать образы заново: minikube image rm или minikube cache delete

Безопасность и рекомендации

• Не запускайте minikube в production — это инструмент для разработки и тестирования.
• Для безопасности доступа к дашборду используйте локальный доступ через SSH-туннель или защищённый прокси.
• Удаляйте неиспользуемые аддоны и ограничьте права (RBAC) для сервисных аккаунтов.

Факты и версии

• Пример minikube в статье: v1.28.0
• Пример Kubernetes в выводах: v1.25.3
• Пример Docker: 20.10.x

Решение проблем: краткий план действий

1. Проверить логи minikube: minikube logs
2. Проверить статусы подов: kubectl get pods -n kube-system
3. Перезапустить кластер: minikube stop && minikube start
4. Удалить и восстановить кластер: minikube delete && minikube start

Мини-плейбук для ежедневной работы

• Утро: minikube status; kubectl get pods –all-namespaces
• Перед тестом: minikube start (если остановлен); проверить ресурсы
• После теста: удалить временные namespace и объекты; minikube stop

Вывод

Minikube — удобный инструмент для локальной разработки Kubernetes. На Debian 11 его установка сводится к установке Docker, kubectl и самого бинарного файла minikube. В статье приведён рабочий набор команд, критерии приёмки, типичные проблемы и рекомендации по безопасности.

Если нужна помощь с конкретной ошибкой или вы хотите настроить ingress/registry/постоянное хранилище — напишите, и я помогу с конфигурацией.