kubectl

kubectl (произносят «кьюб-контрол», «кьюб-си-ти-эл» или «кубкатл») — официальная утилита командной строки Kubernetes. Всё, что она делает, — отправляет HTTP-запросы к API-серверу кластера: создаёт, читает, изменяет и удаляет объекты, а также открывает потоки логов, выполняет команды в контейнерах и пробрасывает порты.^[1] Это основной инструмент администратора и разработчика: им пользуются и вручную, и в скриптах CI/CD.

Подключение к кластеру

Куда и с какими правами ходить, kubectl узнаёт из файла kubeconfig — по умолчанию ~/.kube/config или файлы из переменной KUBECONFIG.^[3] В нём три списка:

• clusters — адреса API-серверов и сертификаты их центров сертификации;
• users — учётные данные: клиентский сертификат, токен или внешняя программа входа (например, облачный CLI);
• contexts — сочетания «кластер + пользователь + пространство имён по умолчанию».

kubectl config get-contexts
kubectl config use-context prod
kubectl config set-context --current --namespace=web

Ошибиться контекстом и выполнить команду в боевом кластере вместо тестового — классическая авария; поэтому текущий контекст выводят в приглашение оболочки, а для быстрого переключения используют утилиты kubectx и kubens.

Версия kubectl должна отличаться от версии API-сервера не больше чем на одну минорную в любую сторону.^[4]

Основные команды

Общий вид: kubectl <глагол> <тип> [имя] [флаги].^[2]

Флаг -n задаёт пространство имён, -A — все сразу, -l app=web — фильтр по меткам.

Декларативный и императивный стиль

Объекты можно создавать командами (kubectl create deployment web --image=nginx, kubectl expose), но в рабочих проектах применяют декларативный подход: манифесты в YAML хранятся в Git, а kubectl apply приводит кластер к описанному состоянию.

kubectl apply -f k8s/                       # все манифесты каталога
kubectl diff -f k8s/                        # что изменится, до применения
kubectl apply -k overlays/prod              # с наложениями Kustomize
kubectl apply --server-side -f big-crd.yaml

Клиентский apply хранит последнюю применённую конфигурацию в аннотации объекта и вычисляет изменения у себя. Server-side apply (стабилен с версии 1.22) переносит слияние на сервер и отслеживает, какой «менеджер» владеет каждым полем, — это снимает конфликты, когда один объект правят несколько инструментов.^[5]

Генерация заготовки без создания объекта — удобный способ не писать YAML с нуля:

kubectl create deployment web --image=nginx:1.27 --dry-run=client -o yaml > web.yaml

Вывод и отладка

kubectl get pods -o yaml                               # объект целиком
kubectl get pods -o jsonpath='{.items[*].metadata.name}'
kubectl get pods -o custom-columns=NAME:.metadata.name,NODE:.spec.nodeName
kubectl get events --sort-by=.lastTimestamp
kubectl get pods -w                                    # следить за изменениями
kubectl auth can-i delete pods --as=system:serviceaccount:web:deployer

Флаг -v=6 (до -v=9) показывает HTTP-запросы, которые kubectl отправляет к API, — полезно, чтобы понять, что на самом деле происходит. Типичный порядок разбора проблемного пода: get → describe (события: нехватка ресурсов, ошибка скачивания образа) → logs --previous → exec или debug.

Расширения

Любой исполняемый файл с именем kubectl-<имя> в PATH становится подкомандой kubectl <имя>.^[6] Менеджер плагинов krew устанавливает их из общего каталога: ctx, ns, neat (очищает вывод от служебных полей), tree (показывает владельцев объектов). Рядом с kubectl обычно используют k9s — терминальный интерфейс для навигации по кластеру, stern — для логов сразу нескольких подов, и Helm — для установки готовых пакетов.

Для удобства включают автодополнение (source <(kubectl completion zsh)) и короткий псевдоним alias k=kubectl. Сокращения типов тоже работают: po, svc, deploy, ns, cm.

См. также

• Kubernetes
• Shell и Bash
• ConfigMap и Secret
• Service и Ingress

Источники

1. Kubernetes Docs — Command line tool (kubectl)
2. Kubernetes Docs — kubectl Quick Reference
3. Kubernetes Docs — Organizing Cluster Access Using kubeconfig Files
4. Kubernetes Docs — Version Skew Policy
5. Kubernetes Docs — Server-Side Apply
6. Kubernetes Docs — Extend kubectl with plugins