# Встановлення та налаштування kubectl у Windows
LLMS index: [llms.txt](/llms.txt)
---
## Перш ніж ви розпочнете
Вам потрібно використовувати версію kubectl, яка має мінорну версію що відрізняється не більше ніж на одиницю від мінорної версії вашого кластера. Наприклад, клієнт v1.36 може співпрацювати з панелями управління v1.35, v1.36 та v1.37. Використання останньої сумісної версії kubectl допомагає уникнути непередбачуваних проблем.
## Встановлення kubectl у Windows {#install-kubectl-on-windows}
Існують наступні методи встановлення kubectl у Windows:
- [Встановлення бінарника kubectl у Windows (за допомогою прямого завантаження або за допомогою curl)](#install-kubectl-binary-on-windows-via-direct-download-or-curl)
- [Встановлення за допомогою Chocolatey, Scoop або winget у Windows](#install-nonstandard-package-tools)
### Встановлення бінарника kubectl у Windows (за допомогою прямого завантаження або за допомогою curl) {#install-kubectl-binary-on-windows-via-direct-download-or-curl}
1. У вас є два варіанти встановлення kubectl на вашому пристрої з Windows
- Безпосереднє завантаження:
Завантажте останню версію 1.36 патчу безпосередньо для вашої архітектури, відвідавши [сторінку випуску Kubernetes](https://kubernetes.io/releases/download/#binaries). Переконайтеся, що вибрано правильний двійковий файл для вашої архітектури (наприклад, amd64, arm64 тощо).
- Використовуючи curl
Або, якщо у вас встановлено `curl`, використовуйте цю команду:
```powershell
curl.exe -LO "https://dl.k8s.io/release/v1.36.0/bin/windows/amd64/kubectl.exe"
```
2. Перевірте бінарний файл (опціонально)
Завантажте файл контрольної суми для `kubectl`:
```powershell
curl.exe -LO "https://dl.k8s.io/v1.36.0/bin/windows/amd64/kubectl.exe.sha256"
```
Перевірте бінарний файл `kubectl` за допомогою файлу контрольної суми:
- Використовуючи командний рядок для ручного порівняння виводу `CertUtil` з завантаженим файлом контрольної суми:
```cmd
CertUtil -hashfile kubectl.exe SHA256
type kubectl.exe.sha256
```
- Використовуючи PowerShell для автоматизації перевірки за допомогою оператора `-eq` для отримання результату `True` або `False`:
```powershell
$(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256)
```
3. Додайте на початок чи в кінець змінної середовища `PATH` шлях до теки з `kubectl`.
4. Перевірте, що версія `kubectl` збігається з завантаженою:
```cmd
kubectl version --client
```
Або використайте це для детального перегляду версії:
```cmd
kubectl version --client --output=yaml
```
Примітка:
Docker Desktop for Windows додає свою власну версію
kubectl до
PATH. Якщо ви вже встановили Docker Desktop раніше, можливо, вам потрібно розмістити свій шлях в
PATH перед тим, який додається інсталятором Docker Desktop, або видалити
kubectl Docker Desktop.
choco install kubernetes-cli
winget install -e --id Kubernetes.kubectl
Примітка:
Редагуйте файл конфігурації за допомогою текстового редактора на ваш вибір, наприклад, Notepad.
## Перевірка конфігурації kubectl {#verify-kubectl-configuration}
Щоб kubectl знайшов та отримав доступ до кластера Kubernetes, вам потрібен
файл kubeconfig, який створюється автоматично при створенні кластера за допомогою kube-up.sh або успішного розгортання кластера Minikube. Типово конфігурація kubectl знаходиться в ~/.kube/config.
Перевірте, що kubectl належним чином налаштований, отримавши стан кластера:
Якщо ви бачите у відповідь URL, kubectl налаштований на доступ до вашого кластера.
Якщо ви бачите повідомлення, подібне до наведеного нижче, kubectl не налаштований належним чином або не може приєднатися до кластера Kubernetes.
The connection to the server <server-name:port> was refused - did you specify the right host or port?
Наприклад, якщо ви плануєте запустити кластер Kubernetes на своєму ноутбуці (локально), вам спочатку потрібно встановити інструмент, такий як Minikube, а потім повторно виконати вказані вище команди.
Якщо kubectl cluster-info повертає у відповідь URL, але ви не можете отримати доступ до свого кластера, щоб перевірити, чи він налаштований належним чином, скористайтесь наступною командою:
kubectl cluster-info dump
Усунення несправностей повідомлення про помилку 'No Auth Provider Found'
У Kubernetes 1.26, kubectl видалив вбудовану автентифікацію для Kubernetes-кластерів керованих хмарними провайдерами. Ці провайдери випустили втулок для kubectl для надання хмарно-специфічної автентифікації. Для інструкцій див. документацію відповідного провайдера:
Також можуть бути інші причини для показу цього повідомлення про помилку, не повʼязані з цією зміною.
## Опціональні конфігурації та втулки kubectl {#optional-kubectl-configurations-and-plugins}
### Увімкнення автопідстановки оболонки {#enable-shell-autocompletion}
kubectl надає підтримку автодоповнення для оболонок Bash, Zsh, Fish та PowerShell, що може значно зекономити ваш час при введенні команд.
Нижче подані процедури для налаштування автодоповнення для PowerShell.
Скрипт автодоповнення для kubectl в PowerShell можна згенерувати командою kubectl completion powershell.
Для того, щоб це працювало у всіх сесіях вашої оболонки, додайте наступний рядок до вашого файлу $PROFILE:
kubectl completion powershell | Out-String | Invoke-Expression
Ця команда буде генерувати скрипт автодоповнення при кожному запуску PowerShell. Ви також можете додати згенерований скрипт безпосередньо до вашого файлу $PROFILE.
Щоб додати згенерований скрипт до вашого файлу $PROFILE, виконайте наступний рядок у вашому PowerShell:
kubectl completion powershell >> $PROFILE
Після перезавантаження вашої оболонки автодоповнення для kubectl має працювати.
### Налаштування kuberc {#configure-kuberc}
Дивіться [kuberc](/docs/reference/kubectl/kuberc) для отримання докладної інформації.
### Встановлення втулка `kubectl convert` {#install-kubectl-convert-plugin}
Втулок для командного рядка Kubernetes kubectl, який дозволяє конвертувати маніфести між різними версіями API. Це може бути особливо корисно для міграції маніфестів до версій API, які все ще є актуальними, на новіші випуски Kubernetes. Для отримання додаткової інформації відвідайте перехід на актуальні API.
1. Завантажте останній випуск команди:
```powershell
curl.exe -LO "https://dl.k8s.io/v1.36.0/bin/windows/amd64/kubectl-convert.exe"
```
2. Перевірте двійковий файл (опціонально).
Завантажте файл контрольної суми для `kubectl-convert`:
```powershell
curl.exe -LO "https://dl.k8s.io/v1.36.0/bin/windows/amd64/kubectl-convert.exe.sha256"
```
Перевірте бінарний файл `kubectl-convert` за допомогою файлу контрольної суми:
- Використовуючи командний рядок для ручного порівняння виводу `CertUtil` з завантаженим файлом контрольної суми:
```cmd
CertUtil -hashfile kubectl-convert.exe SHA256
type kubectl-convert.exe.sha256
```
- Використовуючи PowerShell для автоматизації перевірки за допомогою оператора `-eq` для отримання результату `True` або `False`:
```powershell
$($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256)
```
3. Додайте на початок чи в кінець змінної середовища `PATH` шлях до теки з `kubectl-convert`.
4. Перевірте, що версія `kubectl-convert` збігається з завантаженою:
```cmd
kubectl-convert version
```
Або використайте це для детального перегляду версії:
```cmd
kubectl-convert version --output=yaml
```
5. Після встановлення втулка, вилучіть інсталяційні файли:
```powershell
Remove-Item kubectl-convert.exe
Remove-Item kubectl-convert.exe.sha256
```
## Що далі