English Versão web Baixar para Linux
Ajuda

Problemas comuns

Os problemas comuns que costumam travar (kubelogin, cluster privado, métricas e o Redis no Azure Cache) e como resolver. Cada página de função também tem os erros dela.

Onde
Web e Desktop
Planos
Free, Pro e Team
Papel
Não se aplica

"usa plugin exec (kubelogin) — conecte pela aba Conta de nuvem"

Na web, um contexto que autentica com plugin exec só roda na sua máquina. Para AKS (kubelogin) e EKS (aws), cadastre a conta Azure ou AWS na aba Conta de nuvem e o Kubepier descobre o cluster. Para GKE (gke-gcloud-auth-plugin) e outros, use um token de ServiceAccount. No desktop, os plugins funcionam como no kubectl.

A CA ou a credencial está num arquivo local

A web precisa do conteúdo embutido no kubeconfig. Gere uma versão autocontida:

kubectl config view --flatten --minify

O cluster não responde na web

  • A API aceita só alguns IPs: libere os IPs de saída do Kubepier.
  • O cluster é totalmente privado: a web não alcança. Use o desktop pela sua VPN.

A conta Azure ou AWS não acha os clusters

  • Azure: o Service Principal precisa de Reader e de Azure Kubernetes Service Cluster User Role na assinatura ou no resource group; em AKS com Entra ID, também de um papel no cluster, como Azure Kubernetes Service RBAC Reader.
  • AWS: a chave IAM precisa de eks:ListClusters e eks:DescribeCluster (ec2:DescribeRegions é opcional), e o usuário IAM precisa de uma access entry no EKS para ler o cluster.

Secrets e releases do Helm vazios

A credencial não lê Secrets. O papel view do Kubernetes não inclui Secrets, e a web lê os releases do Helm nos Secrets com owner=helm.

Sem consumo de CPU e memória

Na web, o cluster não tem metrics-server. No desktop, abra Configurações do cluster › Metrics e use Instalar / Atualizar, em Lens Metrics: o Kubepier aplica o Prometheus, o kube-state-metrics e o node-exporter no namespace lens-metrics e escolhe o provider Lens. As métricas aparecem em 1 a 2 minutos, quando o Prometheus termina de subir. Remover pede confirmação e apaga o namespace lens-metrics com todo o histórico de métricas.

O botão de ação aparece com cadeado

A organização está no Free, ou você é membro. Ações, shell e ações destrutivas nos serviços pedem Pro ou Team e papel de admin (no desktop, a partir da 2.7.0). No desktop, uma licença paga sem confirmar há mais de 7 dias volta a valer como Free.

No desktop, o cadeado e o aviso para assinar chegam na 2.4.0. Até a 2.3.0, as ações pagas não aparecem no Free: o menu mostra só o que o plano libera.

Redis no Azure Cache: WRONGPASS e "conexão encerrada" nas duas rotas

Caso real em produção: um Redis no Azure Cache Premium mostrava conexao_encerrada pela rota Direta e pela rota Pelo cluster. Firewall, porta 6380 e TLS estavam certos. A causa era a senha salva no cadastro: a chave de acesso de outro cache. O Redis recusava o AUTH e fechava a conexão, e o Kubepier mostrava só o fechamento.

redis-cli --tls -h <cache>.redis.cache.windows.net -p 6380 --askpass PING
  • Desde 05/10/2026, a web mostra o erro real: WRONGPASS (senha errada) ou NOAUTH (falta a senha) no status, e "sem permissão no serviço" nas ações. No desktop, a partir da 2.3.0; até a 2.2.0, esse caso aparece como Connection is closed.
  • Se a falha é igual nas duas rotas, desconfie da credencial antes da rede: a rede das duas rotas é diferente, a senha é a mesma.
  • Teste a credencial com o cliente oficial, como no comando abaixo: a resposta certa é PONG; WRONGPASS confirma a senha errada.
  • Para não misturar dev e prd, cole no cadastro a connection string inteira que o portal mostra em Chaves de acesso do cache certo (host:6380,password=...,ssl=True,abortConnect=False), em vez de copiar só a chave.

Um serviço do cliente diz "sem permissão"

  • RabbitMQ: tag management e read nas filas.
  • Service Bus: política SAS com Manage.
  • MongoDB: clusterMonitor no admin e read no banco.
  • Redis: os comandos do ACL da página Redis (NOPERM). WRONGPASS ou NOAUTH não é falta de permissão: é a senha errada ou ausente.

Aviso ao instalar no Windows ou no macOS

O instalador ainda não é assinado. No Windows, clique em "Mais informações" e "Executar assim mesmo". No macOS, clique com o botão direito no app e escolha "Abrir".