Установка Minikube

Mar 26, 2018 08:15 · 444 words · 3 minute read kubernetes minikube

Minikube — утилита командной строки для настройки и запуска однонодового кластера Kubernetes в виртуальной машине на локальном компьютере.

Данный вариант просто идеально подходит для первого знакомства с кластером под управлением Kubernetes и выполнения несложных лабораторных работ.

Прежде чем приступить к установке Minikube , нужно убедиться, что в системе поддерживается виртуализация VT-x/AMD-v. В Linux сделать это можно так (результат выполнения команды не должен быть пустым):

Для Mac OS X можно воспользоваться такой командой:

Примечание. Если вы используете Docker for Mac версии 17.12 и новее, достаточно просто переключиться на Edge channel (нестабильная, экспериментальная ветка) и вы уже получите Kubernetes (подробности).

Нам понадобятся следующие компоненты:

С VirtualBox не должно возникнуть никаких вопросов — на официальном сайте скачиваем установщик и следуем указаниям мастера установки.

Для установки Minikube достаточно перейти на страницу с последним релизом (на момент написания статьи v0.25.0) и выполнить предложенные инструкции. Например, для Linux:

или для Mac OS X:

Далее переходим к установке kubectl — утилиты командной строки для управления приложениями, развернутыми в кластере. Здесь может быть несколько вариантов, например, установка с помощью curl :

Второй вариант — установка kubectl как часть Google Cloud SDK (считаем, что SDK уже установлен):

Также можно установить kubectl используя специфический менеджер пакетов, для Linux:

Чтобы проверить корректность установки kubectl , не забудьте запустить команду:

Теперь можем приступать к работе с minikube :

Запуск пода из docker-образа hello-minikube, предназначенного для демонстрации:

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

Проверяем еще раз через несколько секунд:

Для организация доступа к поду hello-minikube извне запустим команду:

Проверим работу пода с помощью утилиты curl из командной строки:

Убираем за собой — удаляем deployment и останавливаем minikube :

trisberg / Minikube-on-Windows10.md

Setting up Minikube and Helm on Windows 10

Start with a basic Windows 10 Home or Pro installation. Some of the executables require to be on the system path. Simply create a bin folder under the home folder, add that folder to the «User variable» Path via «Environment Variables for your account» in «Windows Settings». That way any executable copied to this bin folder will automatically be on the path.

Install 7-Zip to be able to extract a variety of archive formats. After this install any typical apps needed for software development like Git and Visual Studio Code.

Also download curl and extract the package files and copy the files in the AMD64 folder to the bin folder. If, when running curl from the PowerShell command line there is a prompt saying something like «cmdlet Invoke-WebRequest . » then this is from an alias that seems to be installed by default. Remove the alias by running Remove-item alias:curl from the command line.

Minikube and kubectl

Next up is installing Minikube which runs a single node Kubernetes cluster on a local system.

There are multiple ways to get Minikube running on Windows, but for the time being, the least involved installation consists of installing «Docker Tool Box for Windows» together with Minikube.

NOTE: Minikube requires a Hypervisor. The Docker Tool Box for Windows includes VirtualBox, so this step should not be needed if following these instructions.

Install Docker Tool Box for Windows accepting all defaults including the VirtualBox install.

Next, download the latest Minikube minikube-windows-amd64 release. Rename the downloaded file to minikube.exe and place it on the system path in the bin folder.

Minikube also requires kubectl which is the Kubernetes CLI. The easiest way to install this is to download kubectl using curl. Use this curl command:

and then move this executable to the bin folder.

Start the «Docker Quickstart Terminal» and then run Minikube by just entering:

from the PowerShell command line.

In order to share the Docker environment that Minikube uses run

Установка Minikube

На этой странице рассказано, как установить Minikube, инструмент для запуска одноузлового кластера Kubernetes на виртуальной машине в персональном компьютере.

Подготовка к работе

Чтобы проверить, поддерживается ли виртуализация в Linux, выполните следующую команду и проверьте, что вывод не пустой:

Чтобы проверить, поддерживается ли виртуализация в macOS, выполните следующую команду в терминале:

Если вы видите VMX в выводе (должен быть окрашенным), значит в вашем компьютере поддерживается виртуализация VT-x.

Чтобы проверить, поддерживается ли виртуализация в Windows 8 и выше, выполните следующую команду в Windows Terminal или в командной строке.

Если вы видите следующий вывод, значит виртуализация поддерживается в Windows.

Если вы видите следующий вывод, значит системе уже установлен гипервизор, значит вы можете пропустить следующий шаг установке гипервизора.

Установка minikube

Установка kubectl

Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе Установка и настройка kubectl.

Установка Hypervisor

Если у вас ещё не установлен гипервизор, установите один из них:

• KVM, который также использует QEMU

Minikube также поддерживает опцию —vm-driver=none , которая запускает компоненты Kubernetes на хосте, а не на виртуальной машине. Для использования этого драйвера требуется только Docker и Linux, но не гипервизор.

Если вы используете драйвер none в Debian и его производных, используйте пакеты .deb для Docker, а не snap-пакет, который не работает с Minikube. Вы можете скачать .deb -пакеты с сайта Docker.

Minikube также поддерживает vm-driver=podman , похожий на драйвер Docker. Podman, работающий с правами суперпользователя (пользователь root) — это лучший способ гарантировать вашим контейнерам полный доступ ко всем возможностям в системе.

Установка Minikube через пакет

Доступны экспериментальные пакеты для Minikube; Вы можете загрузить пакеты для Linux (AMD64) со страницы релизов Minikube на GitHub.

Используйте пакетный менеджер в вашем дистрибутиве Linux для установки нужного пакета.

Установка Minikube с помощью прямой ссылки

Вы также можете загрузить двоичный файл и использовать его вместо установки пакета:

Чтобы исполняемый файл Minikube был доступен из любой директории выполните следующие команды:

Установка Minikube через Homebrew

В качестве ещё одной альтернативы вы можете установить Minikube с помощью Linux Homebrew:

Установка kubectl

Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе Установка и настройка kubectl.

Установка Hypervisor

Если у вас ещё не установлен гипервизор, установите один из них:

Установка Minikube

Простейший способ установить Minikube в macOS — использовать Homebrew:

Вы также можете установить его в macOS, загрузив двоичный файл:

Чтобы исполняемый файл Minikube был доступен из любой директории выполните следующие команды:

Установка kubectl

Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе Установка и настройка kubectl.

Установка Hypervisor

Если у вас ещё не установлен гипервизор, установите один из них:

Установка Minikube с помощью Chocolatey

Простейший способ установить Minikube в Windows — использовать Chocolatey (запущенный с правами администратора):

После установки Minikube нужно перезапустить терминал. Minikube должен быть автоматически добавлен в директорию с исполняемыми файлами.

Установка Minikube с помощью исполняемого файла установки

Для ручной установки Minikube в Windows с помощью установщика Windows, загрузите и запустите установщик minikube-installer.exe .

Установка Minikube с помощью прямой ссылки

Для ручной установки Minikube в Windows, загрузите minikube-windows-amd64 , переименуйте его в minikube.exe и добавьте его в директорию исполняемых файлов.

Проверка установки

Чтобы убедиться в том, что гипервизор и Minikube были установлены корректно, выполните следующую команду, которая запускает локальный кластер Kubernetes:

После того, как команда minikube start отработала успешно, выполните команду для проверки состояния кластера:

Если ваш кластер запущен, то в выводе команды minikube status должно быть что-то вроде этого:

Теперь, когда вы убедились, что Minikube работает с выбранным вами гипервизором, вы можете продолжить использовать Minikube или остановить кластер. Чтобы остановить кластер выполните команду ниже:

Очистка локального состояния

Если вы уже установили Minikube, то выполните следующую команду:

В таком случае команда minikube start вернёт ошибку:

Чтобы исправить это, нужно очистить локальное состояние:

Что дальше

Обратная связь

Была ли эта страница полезной?

Спасибо за отзыв! Если у вас есть конкретный вопрос об использовании Kubernetes, спрашивайте Stack Overflow. Сообщите о проблеме в репозитории GitHub, если вы хотите сообщить о проблеме или предложить улучшение.

Установка Kubernetes с помощью Minikube

Minikube — это инструмент, позволяющий легко запускать Kubernetes на локальной машине. Для тех, кто хочет попробовать Kubernetes или рассмотреть возможность его использования в повседневной разработке, Minikube станет отличным вариантом, потому что он запускает одноузловой кластер Kubernetes внутри виртуальной машины (VM) на компьютере пользователя.

Возможности Minikube

Minikube поддерживает следующие возможности Kubernetes:

• DNS
• Сервисы NodePort
• Словари конфигурации (ConfigMaps) и секреты (Secrets)
• Панель управления (Dashboard)
• Среда выполнения контейнера: Docker, CRI-O и containerd
• Поддержка CNI (Container Network Interface)
• Ingress

Установка

Краткое руководство

Эта простая демонстрация поможет запустить, использовать и удалить Minikube на локальной машине. Следуйте перечисленным ниже шагам, чтобы начать знакомство с Minikube.

Запустите Minikube и создайте кластер:

Вывод будет примерно следующим:

Дополнительную информацию о запуске кластера в определенной версии Kubernetes, виртуальной машине или среде выполнения контейнера смотрите в разделе Запуск кластера.

Теперь вы можете работать со своим кластером через CLI-инструмент kubectl. Для получения дополнительной информации смотрите раздел Работа с кластером.

Давайте создадим развёртывание (Deployment) в Kubernetes, используя существующий образ echoserver , представляющий простой HTTP-сервер, и сделаем его доступным на порту 8080 с помощью —port .

Вывод будет примерно следующим:

Чтобы получить доступ к объекту Deployment hello-minikube извне, создайте объект сервиса (Service):

Опция —type=NodePort определяет тип сервиса.

Вывод будет примерно следующим:

Под (Pod) hello-minikube теперь запущен, но нужно подождать, пока он начнёт функционировать, прежде чем обращаться к нему.

Проверьте, что под работает:

Если в столбце вывода STATUS выводится ContainerCreating , значит под все еще создается:

Если в столбце STATUS указано Running , то под теперь в рабочем состоянии:

Узнайте URL-адрес открытого (exposed) сервиса, чтобы просмотреть подробные сведения о сервисе:

Чтобы ознакомиться с подробной информацией о локальном кластере, скопируйте и откройте полученный из вывода команды на предыдущем шаге URL-адрес в браузере.

Вывод будет примерно следующим:

Если сервис и кластер вам больше не нужны, их можно удалить.

Удалите сервис hello-minikube :

Вывод будет примерно следующим:

Удалите развёртывание hello-minikube :

Вывод будет примерно следующим:

Остановите локальный кластер Minikube:

Вывод будет примерно следующим:

Подробности смотрите в разделе Остановка кластера.

Удалите локальный кластер Minikube:

Вывод будет примерно следующим:

Подробности смотрите в разделе Удаление кластера.

Управление кластером

Запуск кластера

Команда minikube start используется для запуска кластера. Эта команда создаёт и конфигурирует виртуальную машину, которая запускает одноузловой кластер Kubernetes. Эта команда также настраивает вашу установку kubectl для взаимодействия с этим кластером.

Если вы работаете из-под веб-прокси, вам нужно указать данные прокси в команде minikube start :

К сожалению, установка переменных окружения не cработает.

Minikube также создает контекст «minikube» и устанавливает его по умолчанию в kubectl. Чтобы вернуться к этому контексту, выполните следующую команду: kubectl config use-context minikube .

Указание версии Kubernetes

Вы можете указать используемую версию Kubernetes в Minikube, добавив параметр —kubernetes-version в команду minikube start . Например, чтобы запустить Minikube из-под версии v1.21.0, вам нужно выполнить следующую команду:

Указание драйвера виртуальной машины

Вы можете изменить драйвер виртуальной машины, добавив флаг —vm-driver= в команду minikube start .

Тогда команда будет выглядеть так:

Minikube поддерживает следующие драйверы:

• virtualbox
• vmwarefusion
• docker (ЭКСПЕРИМЕНТАЛЬНЫЙ)
• kvm2 (установка драйвера)
• hyperkit (установка драйвера)
• hyperv (установка драйвера) Обратите внимание, что указанный IP-адрес на этой странице является динамическим и может изменяться. Его можно получить с помощью minikube ip .
• vmware (установка драйвера) (VMware unified driver)
• parallels (установка драйвера)
• none (Запускает компоненты Kubernetes на хосте, а не на виртуальной машине. Использование этого драйвера требует использование Linux и установленного Docker.)

Запуск кластера в других средах выполнения контейнеров

Вы можете запустить Minikube в следующих средах выполнения контейнеров.

Чтобы использовать containerd в качестве среды выполнения контейнера, выполните команду ниже:

Также можете использовать расширенную вариант команды:

Чтобы использовать CRI-O в качестве среды выполнения контейнера, выполните команду ниже:

Также можете использовать расширенную вариант команды:

Использование локальных образов путём повторного использования демона Docker

При использовании одной виртуальной машины для Kubernetes легко повторно использовать демон Docker, встроенный в Minikube. В этом случае нет необходимости создавать реестр Docker на вашей хост-машине и отправлять образ туда. Вместо этого вы можете создать реестр внутри того же демона Docker, который использует Minikube, что позволит ускорить локальные запуски.

Для работы с Docker-демоном на вашем хосте под управлением Mac/Linux, запустите последнюю строку из вывода команды minikube docker-env .

Теперь вы можете использовать Docker в командной строке вашего хост-компьютера на Mac/Linux для взаимодействия с демоном Docker внутри виртуальной машины Minikube:

На Centos 7 Docker может возникнуть следующая ошибка:

Для исправления этой ошибки обновите файл /etc/sysconfig/docker , чтобы учитывались изменения в среде Minikube:

Конфигурация Kubernetes

Minikube имеет такую возможность как «конфигуратор» («configurator»), позволяющая пользователям настраивать компоненты Kubernetes произвольными значениями. Чтобы использовать эту возможность, используйте флаг —extra-config в команде minikube start .

Этот флаг можно дублировать, поэтому вы можете указать его несколько раз с несколькими разными значениями, чтобы установить несколько опций.

Этот флаг принимает строку вида component.key=value , где component — это одно из значение в приведённом ниже списка, key — ключ из структуры конфигурации, а value — значение, которое нужно установить.

Допустимые ключи можно найти в документации по componentconfigs в Kubernetes каждого компонента. Ниже вы найдете документации по каждой поддерживаемой конфигурации:

Примеры

Чтобы изменить настройку MaxPods на значение 5 в Kubelet, передайте этот флаг —extra-config=kubelet.MaxPods=5 .

Эта возможность также поддерживает вложенные структуры. Для изменения настройки LeaderElection.LeaderElect на значение true в планировщике, передайте флаг —extra-config=scheduler.LeaderElection.LeaderElect=true .

Чтобы изменить настройку AuthorizationMode в apiserver на значение RBAC , используйте флаг —extra-config=apiserver.authorization-mode=RBAC .

Остановка кластера

Команда minikube stop используется для остановки кластера. Эта команда выключает виртуальную машины Minikube, но сохраняет всё состояние кластера и данные. Повторный запуск кластера вернет его в прежнее состояние.

Удаление кластера

Команда minikube delete используется для удаления кластера. Эта команда выключает и удаляет виртуальную машину Minikube. Данные или состояние не сохраняются.

Обновление minikube

Работа с кластером

Kubectl

Команда minikube start создает контекст kubectl под именем «minikube». Этот контекст содержит конфигурацию для взаимодействия с кластером Minikube.

Minikube автоматически устанавливает этот контекст, но если вам потребуется явно использовать его в будущем, выполните команду ниже:

Либо передайте контекст при выполнении команды следующим образом: kubectl get pods —context=minikube .

Панель управления

Чтобы получить доступ к веб-панели управления Kubernetes, запустите эту команду в командной оболочке после запуска Minikube, чтобы получить адрес:

Сервисы

Чтобы получить доступ к сервису, открытой через порт узла, выполните команду в командной оболочке после запуска Minikube, чтобы получить адрес:

Организация сети

Виртуальная машина Minikube доступна только хост-системе через IP-адрес, который можно получить с помощью команды minikube ip . Вы можете использовать IP-адрес для доступа к любому сервису типа NodePort .

Чтобы определить NodePort для вашего сервиса, вы можете использовать такую команду kubectl :

Постоянные тома

Minikube поддерживает PersistentVolumes типа hostPath . Эти постоянные тома монтируются в виртуальную машину Minikube.

Виртуальная машина Minikube загружается в файловую систему tmpfs, поэтому большинство директорий не будет сохранено при перезагрузках ( minikube stop ). Однако Minikube сконфигурирован на сохранение файлов, хранящихся в перечисленных ниже директорий хоста.

Пример конфигурации PersistentVolume для сохранения данных в директории /data :

Смонтированные директории хоста

Некоторые драйверы монтируют директорию хоста в виртуальную машину, чтобы можно было легко обмениваться файлами между виртуальной машиной и хостом. В настоящее время это не настраивается и отличается от используемого драйвера и ОС.

Driver	OS	HostFolder	VM
VirtualBox	Linux	/home	/hosthome
VirtualBox	macOS	/Users	/Users
VirtualBox	Windows	C://Users	/c/Users
VMware Fusion	macOS	/Users	/mnt/hgfs/Users
Xhyve	macOS	/Users	/Users

Приватные реестры контейнеров

Для доступа к реестру приватных контейнеров, выполните шаги, описанные на этой странице.

Мы рекомендуем использовать ImagePullSecrets , но если вам нужно обратиться к нему из виртуальной машины Minikube, нужно поместить файл .dockercfg в директорию /home/docker или config.json в директорию /home/docker/.docker .

Дополнения

Для того, чтобы Minikube смог запустить или перезапустить пользовательские дополнения, поместите дополнения, которые вы хотите запускать с помощью Minikube, в директорию

/.minikube/addons . Дополнения в этой директории будут перемещены в виртуальную машину Minikube и запускаться каждый раз при запуске или перезапуске Minikube.

Использование Minikube с помощью HTTP-прокси

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

Если вы работаете через HTTP-прокси, вам нужно сконфигурировать настройки прокси для Docker. Для этого нужно передать необходимые переменные окружения в флаги перед выполнением команды minikube start .

Если адрес вашей виртуальной машины 192.168.99.100, то, скорее всего, настройки прокси помешают kubectl обратиться к ней. Чтобы прокси игнорировал этот IP-адрес, нужно скорректировать настройки no_proxy следующим образом:

Известные проблемы

Функциональность, для которой требуется несколько узлов, не будет работать в Minikube.

Реализация

Minikube использует libmachine для подготовки виртуальных машин и kubeadm для инициализации кластера Kubernetes.

Для получения дополнительной информации о Minikube посмотрите статью.

Дополнительные ссылки

• Цели: цели проекта Minikube смотрите в дорожной карте.
• Руководство по разработке: посмотрите CONTRIBUTING.md, чтобы ознакомиться с тем, как отправлять пулрексты.
• Сборка Minikube: инструкции по сборке/тестированию Minikube из исходного кода смотрите в руководстве по сборке.
• Добавление новой зависимости: инструкции по добавлению новой зависимости в Minikube смотрите в руководстве по добавлению зависимостей.
• Добавление нового дополнения: инструкции по добавлению нового дополнения для Minikube смотрите в руководстве по добавлению дополнений.
• MicroK8: пользователи Linux, которые не хотят использовать виртуальную машину, могут в качестве альтернативы посмотреть в сторону MicroK8s.

Сообщество

Помощь, вопросы и комментарии приветствуются и поощряются! Разработчики Minikube проводят время на Slack в канале #minikube (получить приглашение можно здесь). У нас также есть список рассылки kubernetes-dev на Google Groups. Если вы отправляете сообщение в список, пожалуйста, начните вашу тему с «minikube: «.

Обратная связь

Была ли эта страница полезной?

Спасибо за отзыв! Если у вас есть конкретный вопрос об использовании Kubernetes, спрашивайте Stack Overflow. Сообщите о проблеме в репозитории GitHub, если вы хотите сообщить о проблеме или предложить улучшение.