# Установка Minikube

LLMS index: [llms.txt](/llms.txt)

---

<!-- overview -->

На этой странице рассказано, как установить [Minikube](/ru/docs/tutorials/hello-minikube), инструмент для запуска одноузлового кластера Kubernetes на виртуальной машине в персональном компьютере.



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


<ul class="nav nav-tabs" id="tabs-minikube-before-you-begin" role="tablist"><li class="nav-item"><a data-bs-toggle="tab" class="nav-link active" href="#tabs-minikube-before-you-begin-0" role="tab" aria-controls="tabs-minikube-before-you-begin-0" aria-selected="true">Linux</a></li>
	  
		<li class="nav-item"><a data-bs-toggle="tab" class="nav-link" href="#tabs-minikube-before-you-begin-1" role="tab" aria-controls="tabs-minikube-before-you-begin-1">macOS</a></li>
		<li class="nav-item"><a data-bs-toggle="tab" class="nav-link" href="#tabs-minikube-before-you-begin-2" role="tab" aria-controls="tabs-minikube-before-you-begin-2">Windows</a></li></ul>

<div class="tab-content" id="tabs-minikube-before-you-begin-content"><div class="tab-body tab-pane fadeshow active"
        id="tabs-minikube-before-you-begin-0" role="tabpanel" aria-labelledby="tabs-minikube-before-you-begin-0-tab" tabindex="minikube-before-you-begin"><p>Чтобы проверить, поддерживается ли виртуализация в Linux, выполните следующую команду и проверьте, что вывод не пустой:</p>
<pre tabindex="0"><code>grep -E --color &#39;vmx|svm&#39; /proc/cpuinfo
</code></pre></div><div class="tab-body tab-pane fade"
        id="tabs-minikube-before-you-begin-1" role="tabpanel" aria-labelledby="tabs-minikube-before-you-begin-1-tab" tabindex="minikube-before-you-begin"><p>Чтобы проверить, поддерживается ли виртуализация в macOS, выполните следующую команду в терминале:</p>
<pre tabindex="0"><code>sysctl -a | grep -E --color &#39;machdep.cpu.features|VMX&#39;
</code></pre><p>Если вы видите <code>VMX</code> в выводе (должен быть окрашенным), значит в вашем компьютере поддерживается виртуализация VT-x.</p>
</div><div class="tab-body tab-pane fade"
        id="tabs-minikube-before-you-begin-2" role="tabpanel" aria-labelledby="tabs-minikube-before-you-begin-2-tab" tabindex="minikube-before-you-begin"><p>Чтобы проверить, поддерживается ли виртуализация в Windows 8 и выше, выполните следующую команду в Windows Terminal или в командной строке.</p>
<pre tabindex="0"><code>systeminfo
</code></pre><p>Если вы видите следующий вывод, значит виртуализация поддерживается в Windows.</p>
<pre tabindex="0"><code>Hyper-V Requirements:     VM Monitor Mode Extensions: Yes
                          Virtualization Enabled In Firmware: Yes
                          Second Level Address Translation: Yes
                          Data Execution Prevention Available: Yes
</code></pre><p>Если вы видите следующий вывод, значит системе уже установлен гипервизор, значит вы можете пропустить следующий шаг установке гипервизора.</p>
<pre tabindex="0"><code>Hyper-V Requirements:     A hypervisor has been detected. Features required for Hyper-V will not be displayed.
</code></pre></div></div>




<!-- steps -->

## Установка minikube

<ul class="nav nav-tabs" id="tabs-tab-with-md" role="tablist"><li class="nav-item"><a data-bs-toggle="tab" class="nav-link active" href="#tabs-tab-with-md-0" role="tab" aria-controls="tabs-tab-with-md-0" aria-selected="true">Linux</a></li>
	  
		<li class="nav-item"><a data-bs-toggle="tab" class="nav-link" href="#tabs-tab-with-md-1" role="tab" aria-controls="tabs-tab-with-md-1">macOS</a></li>
		<li class="nav-item"><a data-bs-toggle="tab" class="nav-link" href="#tabs-tab-with-md-2" role="tab" aria-controls="tabs-tab-with-md-2">Windows</a></li></ul>

<div class="tab-content" id="tabs-tab-with-md-content"><div class="tab-body tab-pane fadeshow active"
        id="tabs-tab-with-md-0" role="tabpanel" aria-labelledby="tabs-tab-with-md-0-tab" tabindex="tab-with-md"><h3 id="установка-kubectl">Установка kubectl<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-kubectl" aria-label="Heading self-link"></a></h3>
<p>Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе <a href="/ru/docs/tasks/tools/install-kubectl/#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-kubectl-%D0%B2-linux">Установка и настройка kubectl</a>.</p>
<h3 id="установка-hypervisor">Установка Hypervisor<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-hypervisor" aria-label="Heading self-link"></a></h3>
<p>Если у вас ещё не установлен гипервизор, установите один из них:</p>
<p>• <a href="https://www.linux-kvm.org/">KVM</a>, который также использует QEMU</p>
<p>• <a href="https://www.virtualbox.org/wiki/Downloads">VirtualBox</a></p>
<p>Minikube также поддерживает опцию <code>--vm-driver=none</code>, которая запускает компоненты Kubernetes на хосте, а не на виртуальной машине.
Для использования этого драйвера требуется только <a href="https://www.docker.com/products/docker-desktop">Docker</a> и Linux, но не гипервизор.</p>
<p>Если вы используете драйвер <code>none</code> в Debian и его производных, используйте пакеты <code>.deb</code> для Docker, а не snap-пакет, который не работает с Minikube.
Вы можете скачать <code>.deb</code>-пакеты с сайта <a href="https://www.docker.com/products/docker-desktop">Docker</a>.</p>
<div class="alert alert-caution" role="note"><h4 class="alert-heading">Внимание:</h4>Драйвера виртуальной машины <code>none</code> может привести к проблемам безопасности и потери данных. Перед использованием <code>--vm-driver=none</code> обратитесь к <a href="https://minikube.sigs.k8s.io/docs/reference/drivers/none/">этой документации</a> для получения дополнительной информации.</div>
<p>Minikube также поддерживает <code>vm-driver=podman</code>, похожий на драйвер Docker. Podman, работающий с правами суперпользователя (пользователь root) — это лучший способ гарантировать вашим контейнерам полный доступ ко всем возможностям в системе.</p>
<div class="alert alert-caution" role="note"><h4 class="alert-heading">Внимание:</h4>Драйвер <code>podman</code> должен запускать контейнеры от имени суперпользователя, поскольку у обычных аккаунтов нет полного доступа ко всем возможностям операционной системы, которые могут понадобиться контейнерам для работы.</div>
<h3 id="установка-minikube-через-пакет">Установка Minikube через пакет<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-minikube-%d1%87%d0%b5%d1%80%d0%b5%d0%b7-%d0%bf%d0%b0%d0%ba%d0%b5%d1%82" aria-label="Heading self-link"></a></h3>
<p>Доступны <em>экспериментальные</em> пакеты для Minikube; Вы можете загрузить пакеты для Linux (AMD64) со страницы <a href="https://github.com/kubernetes/minikube/releases">релизов</a> Minikube на GitHub.</p>
<p>Используйте пакетный менеджер в вашем дистрибутиве Linux для установки нужного пакета.</p>
<h3 id="установка-minikube-с-помощью-прямой-ссылки">Установка Minikube с помощью прямой ссылки<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-minikube-%d1%81-%d0%bf%d0%be%d0%bc%d0%be%d1%89%d1%8c%d1%8e-%d0%bf%d1%80%d1%8f%d0%bc%d0%be%d0%b9-%d1%81%d1%81%d1%8b%d0%bb%d0%ba%d0%b8" aria-label="Heading self-link"></a></h3>
<p>Вы также можете загрузить двоичный файл и использовать его вместо установки пакета:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 <span class="se">\
</span></span></span><span class="line"><span class="cl">  <span class="o">&amp;&amp;</span> chmod +x minikube
</span></span></code></pre></div><p>Чтобы исполняемый файл Minikube был доступен из любой директории выполните следующие команды:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">sudo mkdir -p /usr/local/bin/
</span></span><span class="line"><span class="cl">sudo install minikube /usr/local/bin/
</span></span></code></pre></div><h3 id="установка-minikube-через-homebrew">Установка Minikube через Homebrew<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-minikube-%d1%87%d0%b5%d1%80%d0%b5%d0%b7-homebrew" aria-label="Heading self-link"></a></h3>
<p>В качестве ещё одной альтернативы вы можете установить Minikube с помощью Linux <a href="https://docs.brew.sh/Homebrew-on-Linux">Homebrew</a>:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">brew install minikube
</span></span></code></pre></div></div><div class="tab-body tab-pane fade"
        id="tabs-tab-with-md-1" role="tabpanel" aria-labelledby="tabs-tab-with-md-1-tab" tabindex="tab-with-md"><h3 id="установка-kubectl">Установка kubectl<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-kubectl" aria-label="Heading self-link"></a></h3>
<p>Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе <a href="/ru/docs/tasks/tools/install-kubectl/#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-kubectl-%D0%B2-macos">Установка и настройка kubectl</a>.</p>
<h3 id="установка-hypervisor">Установка Hypervisor<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-hypervisor" aria-label="Heading self-link"></a></h3>
<p>Если у вас ещё не установлен гипервизор, установите один из них:</p>
<p>• <a href="https://github.com/moby/hyperkit">HyperKit</a></p>
<p>• <a href="https://www.virtualbox.org/wiki/Downloads">VirtualBox</a></p>
<p>• <a href="https://www.vmware.com/products/fusion">VMware Fusion</a></p>
<h3 id="установка-minikube">Установка Minikube<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-minikube" aria-label="Heading self-link"></a></h3>
<p>Простейший способ установить Minikube в macOS — использовать <a href="https://brew.sh">Homebrew</a>:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">brew install minikube
</span></span></code></pre></div><p>Вы также можете установить его в macOS, загрузив двоичный файл:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 <span class="se">\
</span></span></span><span class="line"><span class="cl">  <span class="o">&amp;&amp;</span> chmod +x minikube
</span></span></code></pre></div><p>Чтобы исполняемый файл Minikube был доступен из любой директории выполните следующие команды:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">sudo mv minikube /usr/local/bin
</span></span></code></pre></div></div><div class="tab-body tab-pane fade"
        id="tabs-tab-with-md-2" role="tabpanel" aria-labelledby="tabs-tab-with-md-2-tab" tabindex="tab-with-md"><h3 id="установка-kubectl">Установка kubectl<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-kubectl" aria-label="Heading self-link"></a></h3>
<p>Убедитесь, что у вас установлен kubectl. Вы можете установить kubectl согласно инструкциям в разделе <a href="/ru/docs/tasks/tools/install-kubectl/#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-kubectl-%D0%B2-windows">Установка и настройка kubectl</a>.</p>
<h3 id="установка-hypervisor">Установка Hypervisor<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-hypervisor" aria-label="Heading self-link"></a></h3>
<p>Если у вас ещё не установлен гипервизор, установите один из них:</p>
<p>• <a href="https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/quick_start/walkthrough_install">Hyper-V</a></p>
<p>• <a href="https://www.virtualbox.org/wiki/Downloads">VirtualBox</a></p>
<div class="alert alert-info" role="note"><h4 class="alert-heading">Примечание:</h4>Hyper-V может работать в трёх версиях Windows 10: Windows 10 Enterprise, Windows 10 Professional и Windows 10 Education.</div>
<h3 id="установка-minikube-с-помощью-chocolatey">Установка Minikube с помощью Chocolatey<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-minikube-%d1%81-%d0%bf%d0%be%d0%bc%d0%be%d1%89%d1%8c%d1%8e-chocolatey" aria-label="Heading self-link"></a></h3>
<p>Простейший способ установить Minikube в Windows — использовать <a href="https://chocolatey.org/">Chocolatey</a> (запущенный с правами администратора):</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">choco install minikube
</span></span></code></pre></div><p>После установки Minikube нужно перезапустить терминал. Minikube должен быть автоматически добавлен в директорию с исполняемыми файлами.</p>
<h3 id="установка-minikube-с-помощью-исполняемого-файла-установки">Установка Minikube с помощью исполняемого файла установки<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-minikube-%d1%81-%d0%bf%d0%be%d0%bc%d0%be%d1%89%d1%8c%d1%8e-%d0%b8%d1%81%d0%bf%d0%be%d0%bb%d0%bd%d1%8f%d0%b5%d0%bc%d0%be%d0%b3%d0%be-%d1%84%d0%b0%d0%b9%d0%bb%d0%b0-%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b8" aria-label="Heading self-link"></a></h3>
<p>Для ручной установки Minikube в Windows с помощью <a href="https://docs.microsoft.com/en-us/windows/desktop/msi/windows-installer-portal">установщика Windows</a>, загрузите и запустите установщик <a href="https://github.com/kubernetes/minikube/releases/latest/download/minikube-installer.exe"><code>minikube-installer.exe</code></a>.</p>
<h3 id="установка-minikube-с-помощью-прямой-ссылки">Установка Minikube с помощью прямой ссылки<a class="td-heading-self-link" href="#%d1%83%d1%81%d1%82%d0%b0%d0%bd%d0%be%d0%b2%d0%ba%d0%b0-minikube-%d1%81-%d0%bf%d0%be%d0%bc%d0%be%d1%89%d1%8c%d1%8e-%d0%bf%d1%80%d1%8f%d0%bc%d0%be%d0%b9-%d1%81%d1%81%d1%8b%d0%bb%d0%ba%d0%b8" aria-label="Heading self-link"></a></h3>
<p>Для ручной установки Minikube в Windows, загрузите <a href="https://github.com/kubernetes/minikube/releases/latest"><code>minikube-windows-amd64</code></a>, переименуйте его в <code>minikube.exe</code> и добавьте его в директорию исполняемых файлов.</p>
</div></div>



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

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


<div class="alert alert-info" role="note"><h4 class="alert-heading">Примечание:</h4>Для использования опции <code>--vm-driver</code> с командой <code>minikube start</code> укажите имя установленного вами гипервизора в нижнем регистре в заполнителе <code>&lt;driver_name&gt;</code> команды ниже. Полный список значений для опции  <code>--vm-driver</code> перечислен в разделе по <a href="/ru/docs/setup/learning-environment/minikube/#%D1%83%D0%BA%D0%B0%D0%B7%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B4%D1%80%D0%B0%D0%B9%D0%B2%D0%B5%D1%80%D0%B0-%D0%B2%D0%B8%D1%80%D1%82%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B9-%D0%BC%D0%B0%D1%88%D0%B8%D0%BD%D1%8B">указанию драйвера виртуальной машины</a>.</div>


```shell
minikube start --vm-driver=<driver_name>
```

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

```shell
minikube status
```

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

```
host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured
```

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

```shell
minikube stop
```

## Очистка локального состояния {#cleanup-local-state}

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

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

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


## Что дальше


* [Локальный запуск Kubernetes при помощи Minikube](/ru/docs/setup/learning-environment/minikube/)
