Начало работы
Основы kubectl
kubectl — CLI для Kubernetes. get перечисляет ресурсы, create создаёт новые, expose создаёт сервисы, scale меняет число реплик. describe даёт подробную информацию о ресурсе.
# cluster info
kubectl cluster-info
# list nodes
kubectl get nodes
# list pods (all namespaces)
kubectl get pods --all-namespaces
# create a deployment
kubectl create deployment nginx --image=nginx
# expose deployment as service
kubectl expose deployment nginx --port=80 --type=LoadBalancer
# scale deployment
kubectl scale deployment nginx --replicas=3
# get detailed info
kubectl describe pod <pod-name>
# view logs
kubectl logs <pod-name>Форматирование вывода
Флаг -o управляет выводом. yaml/json показывают полную спецификацию ресурса. jsonpath и custom-columns извлекают отдельные поля для скриптов. -w следит за изменениями в реальном времени. В скриптах используйте --no-headers, чтобы убрать заголовки колонок.
# wide format (more columns)
kubectl get pods -o wide
# YAML output
kubectl get pod nginx -o yaml
# JSON output
kubectl get pod nginx -o json
# jsonpath (extract specific fields)
kubectl get pods -o jsonpath='{.items[*].metadata.name}'
# custom columns
kubectl get pods -o custom-columns=NAME:.metadata.name,STATUS:.status.phase
# show labels
kubectl get pods --show-labels
# watch for changes
kubectl get pods -wКонтекст и конфигурация
Контекст объединяет адрес кластера, учётные данные пользователя и пространство имён. Файлы kubeconfig (по умолчанию ~/.kube/config) хранят это. Несколько файлов можно объединить через переменную окружения KUBECONFIG для управления многими кластерами.
# view current config
kubectl config view
# list contexts
kubectl config get-contexts
# switch context
kubectl config use-context my-cluster
# set default namespace for current context
kubectl config set-context --current --namespace=dev
# show current context
kubectl config current-context
# KUBECONFIG with multiple files
export KUBECONFIG=~/.kube/config:~/.kube/prod-configExplain и API-ресурсы
api-resources перечисляет, что поддерживает кластер. explain показывает схему OpenAPI любого ресурса — бесценно для написания YAML, не выходя из терминала. Используйте --recursive, чтобы вывести всю вложенную структуру.
# list all resource types
kubectl api-resources
# list namespaced vs cluster-scoped
kubectl api-resources --namespaced=true
kubectl api-resources --namespaced=false
# explain a resource's fields
kubectl explain pod
kubectl explain pod.spec.containers
kubectl explain deployment.spec.strategy
# explain with recursion (all nested fields)
kubectl explain pod --recursive
# include description
kubectl explain pod.spec.containers.resources --api-version=apps/v1Dry run и генерация YAML
--dry-run=client -o yaml — стандартный способ создать манифесты из императивных команд. --dry-run=server проверяет по настоящему apiserver (admission webhooks, схема), не сохраняя. Отлично для создания заготовок декларативного YAML.
# generate YAML without applying
kubectl create deployment nginx --image=nginx --dry-run=client -o yaml
# pipe generated YAML straight to a file
kubectl create deployment nginx --image=nginx --dry-run=client -o yaml > nginx.yaml
# apply the generated manifest
kubectl apply -f nginx.yaml
# dry-run against the server (validates with apiserver)
kubectl apply -f nginx.yaml --dry-run=server
# generate a service from a deployment
kubectl create service clusterip my-svc --tcp=80:80 --dry-run=client -o yamlСправка и автодополнение
Каждая команда kubectl поддерживает --help с примерами. Автодополнение в shell экономит массу набора и показывает подкоманды. Алиас k=kubectl почти универсален среди практиков — сочетайте его с автодополнением для лучшего опыта.
# top-level help
kubectl --help
# subcommand help
kubectl create --help
kubectl explain --help
# generate bash completion
kubectl completion bash > /etc/bash_completion.d/kubectl
# zsh completion
source <(kubectl completion zsh)
# alias k=kubectl with completion
alias k=kubectl
complete -o default -F __start_kubectl k
# shorthand: kubectl -> k
echo 'alias k=kubectl' >> ~/.bashrcPod
Манифест Pod
Pod — минимальная единица развёртывания, содержащая один или несколько контейнеров с общей сетью и хранилищем. Контейнеры в pod всегда размещаются на одном узле. Напрямую pod создают редко — используйте Deployment или Job.
apiVersion: v1
kind: Pod
metadata:
name: nginx
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.25
ports:
- containerPort: 80
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 200m
memory: 256Mi
restartPolicy: AlwaysМногоконтейнерный Pod (sidecar)
Многоконтейнерные pod делят сеть (тот же IP и порты) и тома. Частые паттерны: sidecar (помощник), adapter (преобразует вывод), ambassador (прокси). Общий том emptyDir позволяет sidecar читать логи, которые пишет основной контейнер.
apiVersion: v1
kind: Pod
metadata:
name: web-with-logs
spec:
containers:
- name: app
image: nginx
volumeMounts:
- name: shared-logs
mountPath: /var/log/nginx
- name: log-shipper
image: busybox
command: ["sh", "-c", "tail -f /var/log/nginx/access.log"]
volumeMounts:
- name: shared-logs
mountPath: /var/log/nginx
readOnly: true
volumes:
- name: shared-logs
emptyDir: {}Жизненный цикл и фазы Pod
Фаза pod верхнеуровневая (Pending, Running, Succeeded, Failed). Состояния контейнера (Waiting/Running/Terminated) дают реальные детали: например, CrashLoopBackOff означает, что контейнер постоянно завершается. Проверяйте число перезапусков и события для диагностики.
# pod phases: Pending | Running | Succeeded | Failed | Unknown
kubectl get pod nginx
# show status including container states
kubectl get pod nginx -o jsonpath='{.status}'
# container states: Waiting | Running | Terminated
kubectl describe pod nginx
# common Waiting reasons: ImagePullBackOff, CrashLoopBackOff, CreateContainerConfigError
kubectl get pods --field-selector=status.phase=Pending
# restart count reveals crash loops
kubectl get pods -o jsonpath='{.items[*].status.containerStatuses[*].restartCount}'Статус Pod и события
События — журнал аудита кластера для ресурса: планирование, загрузка образа, ошибки загрузки, сбои liveness. Они истекают (по умолчанию около часа), поэтому фиксируйте их при отладке. describe объединяет события со спецификацией ресурса для быстрой диагностики.
# full describe (includes Events at the bottom)
kubectl describe pod nginx
# list cluster events sorted by time
kubectl get events --sort-by=.lastTimestamp
# events for a specific namespace
kubectl get events -n default
# watch events live
kubectl get events -w
# filter events by type
kubectl get events --field-selector type=Warning
# events for a specific pod
kubectl get events --field-selector involvedObject.name=nginxExec и port-forward
exec выпол няет команды внутри контейнера; -it выделяет TTY для shell. port-forward туннелирует локальный порт к pod или сервису, не публикуя его наружу, — необходимо для отладки баз данных и веб-интерфейсов с ноутбука.
# open an interactive shell
kubectl exec -it nginx -- sh
# run a one-off command
kubectl exec nginx -- ls /etc/nginx
# specify container in a multi-container pod
kubectl exec -it web-with-logs -c log-shipper -- sh
# forward a local port to a pod port
kubectl port-forward pod/nginx 8080:80
# forward to a service / deployment
kubectl port-forward svc/nginx 8080:80
kubectl port-forward deployment/nginx 8080:80
# forward to a random local port
kubectl port-forward pod/nginx :80Удаление и force
Удаление pod, управляемого Deployment/StatefulSet, вызывает немедленную замену. --force --grace-period=0 пропускает период ожидания сигнала TERM и может оставить устаревшие ресурсы — используйте редко. Застрявшим в Terminating pod часто нужно убрать finalizer.
# delete a pod (controller will recreate it)
kubectl delete pod nginx
# force delete immediately (bypasses graceful shutdown)
kubectl delete pod nginx --grace-period=0 --force
# delete by label
kubectl delete pods -l app=nginx
# delete all pods in a namespace
kubectl delete pods --all -n default
# delete a pod and wait for it to be gone
kubectl delete pod nginx --wait
# delete with a timeout
kubectl delete pod nginx --timeout=30sDeployment
Манифест Deployment
Deployment управляет ReplicaSet и даёт декларативные rolling update и rollback. spec.selector должен совпадать с spec.template.metadata.labels. Шаблон задаёт спецификацию pod, которая выкатывается.
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx
labels:
app: nginx
spec:
replicas: 3
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.25
ports:
- containerPort: 80Стратеги я rolling update
RollingUpdate (по умолчанию) постепенно заменяет pod без простоя. maxSurge/maxUnavailable управляют скоростью выката и доступностью. Recreate убивает все pod перед созданием новых — используется, когда приложение не может работать в двух версиях одновременно (например, писатели в один том).
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx
spec:
replicas: 10
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 25% # extra pods above replicas during update
maxUnavailable: 25% # pods allowed down during update
# alternative: recreate (kills all, then starts new)
# strategy:
# type: Recreate
selector:
matchLabels:
app: nginx
template:Откат
Каждое изменение шаблона pod создаёт ревизию ReplicaSet. undo переключает трафик обратно на предыдущий ReplicaSet. pause позволяет сделать несколько исправлений между шагами канареечного выката. Используйте --record (устарел) или аннотации для отслеживания причин изменений.
# view rollout history
kubectl rollout history deployment/nginx
# see details of a specific revision
kubectl rollout history deployment/nginx --revision=2
# undo to the previous revision
kubectl rollout undo deployment/nginx
# undo to a specific revision
kubectl rollout undo deployment/nginx --to-revision=2
# pause/resume a rollout (for canary pauses)
kubectl rollout pause deployment/nginx
kubectl rollout resume deployment/nginx
# check rollout status
kubectl rollout status deployment/nginxМасштабирование и HPA
HPA масштабирует реплики по CPU/памяти или своим метрикам. Для CPU/памяти нужен metrics-server. minReplicas и maxReplicas ограничивают масштабирование. API v2 поддерживает несколько метрик и поведение (стабилизацию при снижении).
# scale manually
kubectl scale deployment/nginx --replicas=5
# horizontal pod autoscaler (CPU target)
kubectl autoscale deployment nginx --min=2 --max=10 --cpu-percent=80
# list HPA
kubectl get hpa
# HPA manifest (v2 with custom metrics)
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
name: nginx
spec:
scaleTargetRef:
apiVersion: apps/v1
kind: Deployment
name: nginx
minReplicas: 2
maxReplicas: 10
metrics:
- type: Resource
resource:
name: cpu
target:
type: Utilization
averageUtilization: 80Обновление образа и перезапуск
set image запускает новый ReplicaSet и rolling update. rollout restart — самый чистый способ подтянуть свежий образ или обновить конфигурацию: создаётся новый ReplicaSet с той же спецификацией. edit открывает $EDITOR для разовых исправлений.
# update container image
kubectl set image deployment/nginx nginx=nginx:1.26
# update from a specific container
kubectl set image deployment/nginx container=nginx:1.26 --record
# trigger a rollout restart (same image, recreate pods)
kubectl rollout restart deployment/nginx
# edit a deployment in editor
kubectl edit deployment/nginx
# patch a single field
kubectl patch deployment/nginx -p '{"spec":{"replicas":5}}'
# apply a manifest change
kubectl apply -f nginx-deployment.yamlСтатус Deployment
Deployment владеет ReplicaSet; активен только один (replicas>0). Старые ReplicaSet масштабируются в ноль для отката. Метка pod-template-hash помечает каждый pod его ревизией. Проверяйте status.conditions на сигналы Available, Progressing и ReplicaFailure.
# deployment status
kubectl get deployment nginx
# watch rollout
kubectl rollout status deployment/nginx
# show ReplicaSets owned by the deployment
kubectl get rs -l app=nginx
# show pods across all revisions
kubectl get pods -l app=nginx --show-labels
# pod-template-hash label distinguishes revisions
# kubectl get pods -l app=nginx,pod-template-hash=xxxx
# conditions: Available, Progressing, ReplicaFailure
kubectl get deployment nginx -o jsonpath='{.status.conditions}'