Kubernetes
Conectar
Conecte Kubernetes pelo terminal. Passe --help para ver as flags que Kubernetes aceita, além de --no-browser para ambientes sem navegador.
polylane cloud connect --provider kubernetesInstale o agente do Polylane no seu cluster com Helm.
O Kubernetes se conecta por meio do agente do Polylane, instalado no seu cluster com Helm. O agente se autentica uma vez com uma chave de API do Polylane com escopo cloud_accounts:write, registra o cluster e abre um Cloudflare Tunnel de saída. Não há kubeconfig para colar nem portas de entrada para abrir, e as credenciais do seu cluster nunca saem do cluster.
Configuração
- Inicie o fluxo de conexão do Kubernetes no Polylane. Ele cria a chave de API para você.
- Execute o comando Helm mostrado no fluxo:
helm install polylane oci://ghcr.io/coreplanelabs/charts/polylane-k8s \
--namespace polylane --create-namespace \
--set polylane.apiKey=<API_KEY> \
--set config.cluster_name=<your cluster name>
- O agente se registra e seu cluster aparece no Polylane, normalmente em menos de um minuto. O Polylane então sincroniza seus workloads, services e outros recursos do cluster.
Para instalações em produção, prefira apiKey.existingSecret (um Secret do Kubernetes criado previamente) em vez de passar a chave na linha de comando.
Permissões
O agente roda com RBAC somente leitura concedendo get, list e watch. O Polylane faz apenas chamadas somente leitura à API do Kubernetes.
Solução de problemas
Se o cluster não aparecer, verifique o pod do agente: kubectl -n polylane get pods e kubectl -n polylane logs -l app.kubernetes.io/name=polylane-k8s -c agent.
Desconectar
Desinstale a release com helm uninstall polylane --namespace polylane, desconecte o cluster no Polylane e depois revogue a chave de API do agente em Settings → API keys.
Conecte Kubernetes a partir de um job de CI ou de qualquer outro ambiente sem navegador.
A conexão do Kubernetes já tem forma de pipeline: o agente é instalado com Helm e registra o cluster sozinho, então, assim que você tem uma chave de API, não sobra nenhuma etapa no console.
Pré-requisitos
- Uma chave de API do Polylane com o escopo
cloud_accounts:write, armazenada como segredo da pipeline. Veja Chaves de API e OAuth. O fluxo guiado cria essa chave para você; uma chave que você mesmo criar funciona da mesma forma. - Helm e credenciais para o cluster de destino no job.
Instalar o agente
helm upgrade --install polylane oci://ghcr.io/coreplanelabs/charts/polylane-k8s \
--namespace polylane --create-namespace \
--set polylane.apiKey=$POLYLANE_API_KEY \
--set config.cluster_name=<your cluster name>
helm upgrade --install mantém o job reexecutável, e o registro é idempotente por cluster, então repetir a pipeline nunca duplica a conexão. Para instalações em produção, prefira apiKey.existingSecret (um Secret do Kubernetes criado previamente) em vez de passar a chave na linha de comando.
O agente se registra e o cluster aparece no Polylane, normalmente em menos de um minuto. Se não aparecer, verifique o pod do agente: kubectl -n polylane get pods e kubectl -n polylane logs -l app.kubernetes.io/name=polylane-k8s -c agent.
Desconectar
Desinstale a release com helm uninstall polylane --namespace polylane, desconecte o cluster no Polylane e depois revogue a chave de API do agente em Settings → API keys.
Desconectar
Desconectar interrompe todas as sincronizações e verificações e apaga as credenciais que o Polylane guardava. O Polylane remove o que a API de Kubernetes permite remover. O seguinte permanece até que você mesmo remova:
- Helm release and agent pods in the cluster
polylane cloud disconnect <id>Ferramentas
1Operações que os agentes podem executar em threads.
Recursos suportados
24Tipos de recurso que aparecem no seu grafo de infraestrutura.