> For the complete documentation index, see [llms.txt](https://utm-1.gitbook.io/utm-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://utm-1.gitbook.io/utm-docs/dokumentaciya/utm-it/programmnoe-obespechenie/rabochie-stancii-windows/po-razrabotchika/minikube-offlain-rezhim.md).

# minikube (оффлайн-режим)

### Полная инструкция по развёртыванию Minikube на Windows 10 x64 в оффлайн‑режиме

#### 1. Подготовка системы

**Требования к оборудованию:**

* ОЗУ: минимум **8 ГБ** (рекомендуется 12 ГБ);
* CPU: поддержка аппаратной виртуализации (проверьте через `systeminfo` в PowerShell);
* Место на диске: минимум **100 ГБ**;
* Установленный **Docker Desktop** (должен быть запущен).

**Проверьте поддержку виртуализации:**

powershell

```powershell
systeminfo | Select-String "Hyper-V"
```

В выводе должны быть строки:

* `VM Monitor Mode Extensions: Yes`;
* `Virtualization Enabled In Firmware: Yes`.

#### 2. Подготовка файлов

Создайте структуру каталогов:

cmd

```cmd
C:\minikube\
├── minikube.exe
├── images\
│   ├── kube-scheduler_v1.34.0.tar
│   ├── kube-proxy_v1.34.0.tar
│   ├── kube-controller-manager_v1.34.0.tar
│   ├── kube-apiserver_v1.34.0.tar
│   ├── pause_3.10.1.tar
│   ├── coredns_v1.12.1.tar
│   ├── etcd_3.6.4-0.tar
│   └── storage-provisioner_v5.tar
└── kicbase\
    └── kicbase_v0.0.48.tar
```

#### 3. Загрузка Docker‑образов

Для каждого файла в `C:\minikube\images\` выполните:

powershell

```powershell
docker load -i "C:\minikube\images\kube-scheduler_v1.34.0.tar"
docker load -i "C:\minikube\images\kube-proxy_v1.34.0.tar"
# ... и так для всех файлов
```

Загрузите базовый образ kicbase:

powershell

```powershell
docker load -i "C:\minikube\kicbase\kicbase_v0.0.48.tar"
```

**Проверьте загрузку:**

powershell

```powershell
docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"
```

Убедитесь, что все образы присутствуют.

#### 4. Настройка окружения

Установите переменные (в PowerShell от администратора):

powershell

```powershell
$env:MINIKUBE_HOME = "C:\minikube\.minikube"
$env:MINIKUBE_LOCATION = "C:\minikube"
$env:KUBECONFIG = "$env:MINIKUBE_HOME\kubeconfig"

# Для постоянной установки:
[Environment]::SetEnvironmentVariable("MINIKUBE_HOME", "C:\minikube\.minikube", "Machine")
[Environment]::SetEnvironmentVariable("MINIKUBE_LOCATION", "C:\minikube", "Machine")
[Environment]::SetEnvironmentVariable("KUBECONFIG", "C:\minikube\.minikube\kubeconfig", "Machine")
```

Добавьте путь к `minikube.exe` в `PATH`:

powershell

```powershell
$path = [Environment]::GetEnvironmentVariable("PATH", "Machine")
if (-not $path.Contains("C:\minikube")) {
    $path = "C:\minikube;" + $path
    [Environment]::SetEnvironmentVariable("PATH", $path, "Machine")
}
```

#### 5. Запуск Minikube

Выполните в PowerShell (от администратора):

powershell

```powershell
cd C:\minikube
.\minikube.exe start `
  --driver=docker `
  --container-runtime=docker `
  --kubernetes-version=v1.34.0 `
  --base-image=gcr.io/k8s-minikube/kicbase:v0.0.48 `
  --image-repository=registry.k8s.io `
  --bootstrapper=kubeadm `
  --force `
  --skip-driver-check `
  --memory=6144 `
  --cpus=4
```

**Пояснения к параметрам:**

* `--driver=docker` — используем Docker как гипервизор;
* `--kubernetes-version` — версия Kubernetes (совпадает с вашими образами);
* `--base-image` — базовый образ узла;
* `--image-repository` — префикс репозитория для образов;
* `--memory` и `--cpus` — выделение ресурсов (минимум 6 ГБ ОЗУ, 4 CPU).

#### 6. Проверка работоспособности

1. **Статус кластера:**

   powershell

   ```powershell
   .\minikube.exe status
   ```

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

   ```
   minikube: Running
   cluster: Running
   ...
   ```
2. **Узлы Kubernetes:**

   powershell

   ```powershell
   .\minikube.exe kubectl get nodes
   ```

   Вывод:

   ```
   NAME       STATUS   ROLES           AGE   VERSION
   minikube   Ready   control-plane   XXm   v1.34.0
   ```
3. **Системные поды:**

   powershell

   ```powershell
   .\minikube.exe kubectl get pods -A
   ```

   Все поды должны быть в статусе `Running`.
4. **Проверка CoreDNS:**

   powershell

   ```powershell
   .\minikube.exe kubectl get pods -n kube-system -l k8s-app=kube-dns
   ```

#### 7. Настройка kubectl

Свяжите kubectl с Minikube:

powershell

```powershell
.\minikube.exe update-context
.\minikube.exe kubectl config use-context minikube
```

Проверьте:

powershell

```powershell
kubectl cluster-info
```

#### 8. Сохранение конфигурации

После успешного запуска Minikube создаст:

* `C:\minikube\.minikube\config\config.json` — конфигурация кластера;
* `C:\minikube\.minikube\certs\` — сертификаты;
* `C:\minikube\.minikube\profiles\` — профили.

**Рекомендации:**

* Не удаляйте каталог `.minikube`;
* Для резервного копирования копируйте всю папку `C:\minikube\.minikube`.

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

**Остановка:**

powershell

```powershell
.\minikube.exe stop
```

**Перезапуск:**

powershell

```powershell
.\minikube.exe start
```

**Удаление:**

powershell

```powershell
.\minikube.exe delete
```

#### 10. Устранение неполадок

1. **Ошибка «Image not found»**
   * Проверьте наличие образов: `docker images`;
   * Убедитесь в правильности `--image-repository`;
   * Перезагрузите образы через `docker load`.
2. **Нехватка ресурсов**\
   В Docker Desktop:
   * Memory: минимум 8 ГБ;
   * CPUs: минимум 4;
   * Disk image size: минимум 100 ГБ.
3. **Ошибки инициализации**\
   Посмотрите логи:

   powershell

   ```powershell
   .\minikube.exe logs --file=minikube.log
   ```
4. **Конфликты портов**\
   Укажите другой порт API:

   powershell

   ```powershell
   --apiserver-port=8443
   ```
5. **Проблемы с сетью**\
   Убедитесь, что Docker Desktop работает в режиме `Docker Engine`.

#### 11. Важные примечания

* **Версии:** все образы должны соответствовать `--kubernetes-version` (`v1.34.0`).
* **Оффлайн‑режим:** все зависимости должны быть загружены локально до запуска.
* **Резервное копирование:** регулярно сохраняйте `C:\minikube\.minikube`.
* **Обновление:** для смены версии Kubernetes укажите новый `--kubernetes-version` и перезапустите Minikube.
* **Логи:** при ошибках анализируйте `minikube logs`.
* **Права:** все команды выполняются от имени администратора.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://utm-1.gitbook.io/utm-docs/dokumentaciya/utm-it/programmnoe-obespechenie/rabochie-stancii-windows/po-razrabotchika/minikube-offlain-rezhim.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
