kube-agents — скилл
Набор агентов для Kubernetes и GKE: аудиты флота по расписанию, правки через пулреквесты, ответы в Google Chat и Slack
- 124 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Установщик создает ресурсы и кластер GCP от имени вашего аккаунта, а набор прав задает флаг `--permission-set`.
- Агенты работают по расписанию без запроса, пишут в чаты и GitOps-репозиторий и открывают пулреквесты с изменениями инфраструктуры.
- Установка запускается скриптом из сети командой `curl ... | bash`.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/gke-labs/kube-agents/<RELEASE_VERSION>/install.sh | bashВместо `<RELEASE_VERSION>` подставьте тег релиза, например `0.4.0`. Интерактивный установщик создает ресурсы GCP.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Установщик создает ресурсы и кластер GCP от имени вашего аккаунта, а набор прав задает флаг `--permission-set`.
- Агенты работают по расписанию без запроса, пишут в чаты и GitOps-репозиторий и открывают пулреквесты с изменениями инфраструктуры.
- Установка запускается скриптом из сети командой `curl ... | bash`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
kube-agents разворачивает в кластере GKE трех агентов. Planning Agent принимает сообщения в чате и раздает работу, Platform Agent отвечает за инфраструктуру и политики флота, а Cluster Agent следит за одним кластером с доступом только на чтение. Установщик `install.sh` спрашивает проект GCP, кластер (Autopilot или Standard), чат и провайдера моделей, после чего один `terraform apply` создает ресурсы GCP и ставит чарт Helm. Platform Agent по расписанию запускает аудиты: безопасность и RBAC, надежность нагрузок, сеть и VPC, патчи и обновления, лишние траты, дрейф конфигурации. Отчеты приходят в Google Chat или Slack, а исправления агент оформляет пулреквестом в GitOps-репозитории на GitHub или GitLab. В репозитории лежат файлы SKILL.md для агентов, больше шестидесяти: создание кластера, стоимость, резервные копии, разбор сбоев.
Для кого. Платформенным командам и SRE на GKE, которые хотят отдать агенту ночные аудиты кластеров и разбор сбоев, а правки оставить за ревью людей.
Подходит, если
- Каждое утро в Slack приходит отчет по RBAC, сети и безопасности всех кластеров флота.
- Алерт `CrashLoopBackOff` попадает в чат, и агент ищет причину в логах и метриках.
- Перед обновлением GKE агент готовит отчет о готовности и находит устаревшие API.
- Команда ищет лишние траты на недозагруженных нагрузках и спрашивает разбивку по BigQuery.
- Установку поручают другому агенту по готовому промпту: он показывает результат `--dry-run` и ждет подтверждения.
Не подходит, если
- Нужна проверка манифестов прямо в редакторе: kube-agents работает сервисом в кластере, а не подсказкой в Cursor.
- Облако другое: установщик и Terraform рассчитаны на GCP и GKE.
- Правки должны попадать в кластер напрямую: агент вносит изменения только через пулреквест.
- К продуктивному проекту выдают доступ без чтения документации о безопасности и IAM: она советует начать с нее.
Пример запроса к агенту
@kube-agents запусти самопроверку всего флота и покажи предупреждения и сбои по разделам.Ограничения
Проект из gke-labs и официально не поддерживается Google. Нужны проект GCP, кластер GKE и учетные данные провайдера моделей: поддерживаются Gemini, Vertex AI, OpenAI, Anthropic и совместимые API. Установка запускает `terraform apply` и создает платные ресурсы GCP. Версию релиза в команде установки подставляют вручную, для GitLab нужна 0.9.0 или новее. Агент Kubernetes читает кластер без доступа к Secrets.
Как отключить. Выполните `./uninstall.sh` из распакованного релиза или `lifecycle.sh destroy` в `terraform/examples/full-install`: оба варианта откатывают установку.
Частые вопросы
Как установить kube-agents?
Выполните `curl -fsSL https://raw.githubusercontent.com/gke-labs/kube-agents/<RELEASE_VERSION>/install.sh | bash`, подставив тег релиза, например `0.4.0`. Интерактивный установщик спросит проект GCP, кластер, чат и провайдера моделей.
Как поставить без вопросов, из CI или агентом?
Добавьте `--non-interactive` и флаги `--gcp-project-id`, `--gke-cluster-name`, `--gcp-region`, `--model-provider`, `--permission-set`. Сначала запустите с `--dry-run`, чтобы увидеть сводку.
Меняет ли агент кластер сам?
Нет. Права Kubernetes у агента только на чтение, а изменения инфраструктуры он оформляет пулреквестом в GitOps-репозиторий, и принимает их человек.
Какие аудиты запускаются по расписанию?
Безопасность и RBAC, надежность, парк GCE, сеть и VPC, безопасность ИИ-нагрузок, емкость, готовность к обновлениям, лишние траты и дрейф конфигурации. Задания лежат в `agents/platform/cron/jobs.json`.
Какие провайдеры моделей поддерживаются?
Gemini, Vertex AI, OpenAI, Anthropic и совместимые с OpenAI API через шлюз LiteLLM. Провайдера задает флаг `--model-provider`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл KubeShark: агент сначала ищет режим отказа, потом пишет манифесты, Helm и Kustomize по официальным практикам и возвращает план проверки и отката
Агенты OpenCode в Kubernetes: задачи и общие настройки задают манифестами, а в живого агента заходят командой kubeoc
Agent Skills для продуктов Google
Agent Skills for Google products and technologies
Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента
MCP-сервер для Kubernetes на Go: чтение любых ресурсов кластера, логи подов, а в режиме записи apply и exec
Большая база скиллов по DevOps, безопасности, инфраструктуре и комплаенсу для AI-агентов
Открытый интерфейс Kubernetes с встроенным MCP-сервером: агент осматривает кластер, разбирает поломки и выполняет операции с учетом RBAC
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| kube-agents (эта карточка) | нет | 124 | ||
| kubectl-ai | да | не нужна | 7 598 | переводит просьбы в команды kubectl прямо в терминале; kube-agents обходит флот по расписанию и ведет аудиты и пулреквесты в GitOps |
| GKE MCP Server | да | не нужна | 169 | дает MCP-инструменты для GKE; kube-agents разворачивает собственных агентов с плановыми аудитами и чатом |
Коротко о README
Проект описывает три уровня агентов, таблицу плановых аудитов, каталог скиллов по областям, меры изоляции (песочница gVisor, брокер учетных данных) и диаграмму архитектуры с оператором Kubernetes.
Бейдж для README
Исходный SKILL.md
---
name: gke-cost-analysis
metadata:
category: CloudObservabilityAndMonitoring
description: >-
Answer natural language questions and perform analysis on GKE cluster and
workload costs using BigQuery billing exports, cost allocation data, and live
cluster monitoring metrics. Use when querying GKE costs across projects,
namespaces, or workloads, analyzing billing reports in BigQuery (`bq`), checking
cluster cost budgets (`gcloud billing`), or diagnosing cost drivers like pod
requests vs. actual utilization (`kubectl top`). Don't use for applying cost
optimization changes, creating rightsizing manifests (VPA/MPA), or selecting
ComputeClasses (use gke-cost-optimization instead).
---
# GKE Cost Analysis
This skill provides guidance on answering natural language questions about
GKE-related costs, billing reports, and utilization analysis.
## Overview
When users ask about GKE costs (e.g., "What are my costs across projects?",
"What's my most expensive namespace?", "Why is my cluster cost spiking?"), use
this skill to provide a structured and expert response using BigQuery billing
exports, cost allocation metadata, and live cluster metrics.
## Instructions
When handling a cost-related question:
1. **Provide a Direct Answer**: Address the specific cost question or
analytical request clearly and concisely.
2. **Explain BigQuery Integration**: Explain how to query BigQuery for
historical cost breakdown. Note that GKE costs originate from the GCP
Billing Detailed BigQuery Export (`gcp_billing_export_resource_v1_*`).
3. **Check & Verify Cost Allocation**: Explain that GKE Cost Allocation must be
enabled on the cluster (`--enable-cost-allocation`) for namespace, label,
and workload-level billing granularity. If queries return empty labels,
provide the `gcloud` command to enable it.
4. **Analyze Pricing Drivers & Utilization**: When diagnosing cost drivers,
explain whether the cluster is in Autopilot (billed by requested pod
CPU/memory) or Standard mode (billed by underlying VM node size + control
plane fees), and compare live utilization (`kubectl top`) against
provisioned requests.