плагин

kubernetes-operator — плагин для Claude Code: CRD, reconcile, аудит

Q: Как установить kubernetes-operator в Claude?

Через маркетплейс: сначала `/plugin marketplace add alirezarezvani/claude-skills`, затем `/plugin install kubernetes-operator@claude-code-skills`.

Дисциплина разработки Kubernetes-операторов: валидатор CRD, линтер reconcile-циклов и аудит Capability Levels. Пригодится, когда контроллер уже пишется, а не когда его только выбирают.

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓

/plugin marketplace add alirezarezvani/claude-skills
/plugin install kubernetes-operator@claude-code-skills

Открыть на GitHub

Что делает kubernetes-operator

Плагин закрывает один участок работы — паттерн Operator. Внутри три инструмента на стандартной библиотеке Python: crd_validator.py проверяет CRD, reconcile_lint.py ищет в контроллере типовые ошибки цикла согласования, operator_capability_audit.py оценивает оператора по уровням OperatorHub. Плюс четыре справочника: сам паттерн, проектирование CRD, паттерны reconcile и сравнение фреймворков — controller-runtime, kubebuilder, operator-sdk, metacontroller, KOPF.

Есть шаблоны: production CRD в YAML и скелет Go-контроллера, оба проходят линтеры. Слэш-команда /operator-audit запускает все три скрипта и собирает отчёт. Ставить имеет смысл до первого пуша в кластер: линтер ловит отсутствующие финализаторы, блокирующие вызовы, дрейф статуса, лишние права RBAC и потерянный requeue — то, что потом ищут по логам в проде.

Это не общий набор по Kubernetes. Для Helm-чартов, kubectl-операций, безопасности кластера или облачной архитектуры автор указывает другие скиллы, так что тащить его под всё подряд не стоит. Инструменты запускаются вручную из директории скилла, ключей и внешних сервисов не требуют.

Какие задачи решает

проверить CRD до мержа, а не после падения в кластере
найти в reconcile-функции блокирующие вызовы и потерянный requeue
оценить оператора по уровням OperatorHub перед публичным релизом
выбрать фреймворк для контроллера и сравнить подходы
взять готовый скелет CRD и Go-контроллера вместо пустого файла

Примеры запросов агенту

прогони /operator-audit по текущему оператору и покажи отчёт
проверь config/crd/myapp.yaml валидатором CRD и объясни замечания
пролинтуй controllers/myapp_controller.go в строгом режиме

Как установить kubernetes-operator

Через маркетплейс плагинов

/plugin marketplace add alirezarezvani/claude-skills

/plugin install kubernetes-operator@claude-code-skills

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Из того же набора387

Весь набор →

Рядом в теме «DevOps и инфраструктура»

Все плагины по теме «DevOps и инфраструктура» →

Вопросы о kubernetes-operator

Как установить kubernetes-operator в Claude?

Через маркетплейс: сначала /plugin marketplace add alirezarezvani/claude-skills, затем /plugin install kubernetes-operator@claude-code-skills.

Что делает kubernetes-operator?

Помогает писать Kubernetes-операторы: валидирует CRD, линтит reconcile-циклы, аудитит уровни OperatorHub и даёт справочники со скелетами.

Чем он отличается от общих скиллов по Kubernetes?

Он про паттерн Operator и ничего больше. Для Helm-чартов, kubectl-операций, безопасности и облачной архитектуры в репозитории есть отдельные скиллы.

Исходный текст

kubernetes-operator · MIT

# Kubernetes Operator

End-to-end discipline for building Kubernetes Operators correctly. Catches the recurring reconcile-loop bugs (missing finalizers, blocking calls, status drift, RBAC over-grants, no requeue) before they reach a cluster.

## What's inside

- **3 stdlib Python tools** — CRD validator, reconcile-loop linter, OperatorHub capability auditor
- **4 reference docs** — operator pattern, CRD design, reconcile patterns, framework comparison
- **Asset templates** — production CRD YAML + Go controller skeleton (both pass the linters)
- **`/operator-audit` slash command** — runs all 3 tools and produces a report

## Install

```bash
# Via Claude Code marketplace
/plugin install kubernetes-operator

# Or clone the repo
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills/engineering/kubernetes-operator
```

## Quick start

```bash
SKILL=engineering/kubernetes-operator/skills/kubernetes-operator

python "$SKILL/scripts/crd_validator.py" --crd config/crd/myapp.yaml
python "$SKILL/scripts/reconcile_lint.py" --controller controllers/myapp_controller.go
python "$SKILL/scripts/operator_capability_audit.py" --operator-dir .
```

## Scope

This is the **Operator pattern** specifically. For other Kubernetes work:

- Helm chart authoring → `helm-chart-builder`
- Kubectl operations / blue-green deploys → `senior-devops`
- General k8s security → `cloud-security`
- Cloud architecture → `aws-solution-architect`, `azure-cloud-architect`, `gcp-cloud-architect`

## Key principles

1. **Reconcile is idempotent**, declarative, and bounded in time
2. **Status subresource is non-negotiable** — without it, status updates loop spec reconciles
3. **Finalizers protect external resources** — cascade deletion is the operator pattern's free gift, but only for owned k8s resources
4. **RBAC is least-privilege** — controllers shouldn't read secrets they don't need
5. **Capability levels are an SLA**, not a label — aim for L3 (Full Lifecycle) before public release

## Skill structure

```
kubernetes-operator/
├── README.md
├── .claude-plugin/plugin.json
└── skills/kubernetes-operator/
    ├── SKILL.md
    ├── scripts/
    │   ├── crd_validator.py
    │   ├── reconcile_lint.py
    │   └── operator_capability_audit.py
    ├── references/
    │   ├── operator_pattern.md
    │   ├── crd_design.md
    │   ├── reconcile_loop.md
    │   └── tooling_landscape.md
    └── assets/
        ├── crd_template.yaml
        └── reconcile_skeleton.go
```

## Verifiable success

A team using this skill should achieve:

- 100% of new CRDs pass `crd_validator.py` before merge
- All reconcile functions pass `reconcile_lint.py` strict mode
- Operators reach OperatorHub Capability Level 3 before public release
- Mean time to fix a reconcile bug: <1 day (no infinite loops in production)

## License

MIT — see repo root LICENSE.