Kubernetes

Kubernetes si collega tramite l'agente Polylane, installato nel tuo cluster con Helm. L'agente si autentica una volta con una chiave API Polylane limitata a cloud_accounts:write, registra il cluster e apre un Cloudflare Tunnel in uscita. Non c'è nessun kubeconfig da incollare né porte in ingresso da aprire, e le credenziali del cluster non lasciano mai il cluster.

Configurazione

1. Avvia il flusso di collegamento Kubernetes in Polylane. Crea la chiave API per te.
2. Esegui il comando Helm mostrato nel flusso:

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>

3. L'agente si registra da solo e il cluster compare in Polylane, di solito in meno di un minuto. Polylane sincronizza poi i tuoi workload, i servizi e le altre risorse del cluster.

Per le installazioni in produzione preferisci apiKey.existingSecret (un Secret Kubernetes creato in anticipo) al passaggio della chiave sulla riga di comando.

Permessi

L'agente gira con RBAC in sola lettura che concede get, list e watch. Polylane effettua solo chiamate in sola lettura all'API Kubernetes.

Risoluzione dei problemi

Se il cluster non compare, controlla il pod dell'agente: kubectl -n polylane get pods e kubectl -n polylane logs -l app.kubernetes.io/name=polylane-k8s -c agent.

Scollegamento

Disinstalla la release con helm uninstall polylane --namespace polylane, scollega il cluster in Polylane, poi revoca la chiave API dell'agente sotto Settings → API keys.

Il collegamento Kubernetes ha già la forma di una pipeline: l'agente si installa con Helm e registra da solo il cluster, quindi una volta che hai una chiave API non resta nessun passaggio nella console.

Prerequisiti

• Una chiave API Polylane con lo scope cloud_accounts:write, conservata come secret della pipeline. Vedi Chiavi API e OAuth. Il flusso guidato crea questa chiave per te; una chiave che crei tu stesso funziona allo stesso modo.
• Helm e le credenziali per il cluster di destinazione nel job.

Installa l'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 mantiene il job rieseguibile, e la registrazione è idempotente per cluster, quindi ripetere la pipeline non duplica mai il collegamento. Per le installazioni in produzione preferisci apiKey.existingSecret (un Secret Kubernetes creato in anticipo) al passaggio della chiave sulla riga di comando.

L'agente si registra da solo e il cluster compare in Polylane, di solito in meno di un minuto. Se non compare, controlla il pod dell'agente: kubectl -n polylane get pods e kubectl -n polylane logs -l app.kubernetes.io/name=polylane-k8s -c agent.

Scollega

Disinstalla la release con helm uninstall polylane --namespace polylane, scollega il cluster in Polylane, poi revoca la chiave API dell'agente sotto Settings → API keys.