KubeStellar Console

Visão Geral

KubeStellar Console é um painel Kubernetes de código aberto para múltiplos clusters (projeto CNCF) com operações baseadas em IA. Ele vem com kc-agent, um servidor MCP que conecta agentes de codificação a kubeconfig e APIs do Kubernetes, além de mais de 10 habilidades de agente integradas para desenvolvimento, testes e operações.

Quando Usar Esta Habilidade

• Use ao gerenciar múltiplos clusters Kubernetes entre edge e nuvem
• Use quando precisar de solução de problemas e depuração de Kubernetes assistida por IA
• Use ao executar testes de desempenho, verificações de conformidade de cache ou depuração de CI em um painel Kubernetes
• Use ao integrar com projetos CNCF (Argo, Kyverno, Istio e mais de 20 outros)

Como Funciona

Passo 1: Instalar kc-agent

brew tap kubestellar/tap && brew install kc-agent

Passo 2: Iniciar o servidor MCP

kc-agent

Isso conecta o contexto kubeconfig ativo a qualquer agente de codificação compatível com MCP. Não o inicie a partir de um contexto de cluster-admin ou com permissão de escrita, a menos que o usuário aceite explicitamente esse risco.

Passo 3: Usar habilidades de agente integradas

O projeto vem com habilidades de agente acessíveis via CLAUDE.md e AGENTS.md:

• @perf-test — Teste de desempenho do painel e análise TTFI
• @cache-test — Teste de conformidade do cache de cartões (retorno aquecido do IndexedDB)
• @nav-test — Teste de desempenho de navegação
• @ui-compliance-test — Conformidade de carregamento de cartões (8 critérios, mais de 150 cartões)
• @ci-status — Monitoramento e verificação de status de pipeline de CI
• @rca — Análise de causa raiz para falhas de CI/teste
• @tdd — Fluxo de trabalho de desenvolvimento guiado por testes
• @k8s-debug — Depuração e solução de problemas do Kubernetes

Principais Recursos

• Gerenciamento de múltiplos clusters entre edge e nuvem
• Observabilidade em streaming em tempo real
• Mais de 20 integrações de projetos CNCF (Argo, Kyverno, Istio, etc.)
• Autenticação GitHub OAuth
• Segurança da cadeia de suprimentos (SBOM, SLSA)
• Cache SQLite WASM com padrão stale-while-revalidate
• Mais de 15 temas com modo escuro/claro

Notas de Segurança e Proteção

• Risco crítico: kc-agent conecta seu contexto kubeconfig ativo a agentes compatíveis com MCP. Se esse contexto tiver permissões de cluster-admin, de escrita ou de leitura de segredos, os agentes herdarão essas capacidades.
• Não confie apenas em objetos RBAC: criar um ServiceAccount ou ClusterRoleBinding não altera as credenciais que kc-agent usa. Inicie kc-agent apenas após alternar KUBECONFIG/contexto para credenciais dedicadas de privilégio mínimo e verificá-las.
• Escopo de leitura recomendado: evite resources='*', pois ele inclui objetos sensíveis como Secrets. Prefira uma lista explícita de recursos sem segredos e verifique o acesso antes de iniciar o servidor MCP:

  kubectl create serviceaccount kc-agent -n default
  kubectl create clusterrole kc-agent-readonly \
    --verb=get,list,watch \
    --resource=pods,services,deployments.apps,replicasets.apps,statefulsets.apps,daemonsets.apps,namespaces,nodes,events,configmaps
  kubectl create clusterrolebinding kc-agent-readonly \
    --clusterrole=kc-agent-readonly \
    --serviceaccount=default:kc-agent
  kubectl auth can-i get secrets --as=system:serviceaccount:default:kc-agent
  kubectl auth can-i list pods --as=system:serviceaccount:default:kc-agent
  

• O primeiro comando can-i deve retornar no; o segundo deve retornar yes. Em seguida, crie ou selecione um kubeconfig que autentique de fato como esse ServiceAccount antes de executar kc-agent.
• Não exponha kc-agent em uma rede pública sem autenticação.
• Revise SECURITY-AI.md para mitigações de injeção de prompt e desvio de agente.

Limitações

• Esta habilidade requer um binário externo (kc-agent) instalado separadamente via Homebrew.
• Não trate a saída do agente como substituta para validação específica do ambiente ou revisão especializada.
• Pare e peça esclarecimentos se as permissões necessárias ou os limites de segurança não estiverem claros.

Links

• GitHub
• Website
• CLAUDE.md
• AGENTS.md