Kubernetes

Kubernetes se conecta a través del agente de Polylane, instalado en tu clúster con Helm. El agente se autentica una vez con una clave de API de Polylane limitada a cloud_accounts:write, registra el clúster y abre un Cloudflare Tunnel saliente. No hay kubeconfig que pegar ni puertos entrantes que abrir, y las credenciales de tu clúster nunca salen del clúster.

Configuración

1. Inicia el flujo de conexión de Kubernetes en Polylane. Crea la clave de API por ti.
2. Ejecuta el comando de Helm que muestra el flujo:

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. El agente se registra por sí mismo y tu clúster aparece en Polylane, normalmente en menos de un minuto. Polylane sincroniza entonces tus cargas de trabajo, servicios y demás recursos del clúster.

Para instalaciones de producción, prefiere apiKey.existingSecret (un Secret de Kubernetes creado previamente) en lugar de pasar la clave en la línea de comandos.

Permisos

El agente se ejecuta con RBAC de solo lectura que concede get, list y watch. Polylane solo realiza llamadas de solo lectura a la API de Kubernetes.

Solución de problemas

Si el clúster no aparece, revisa el pod del agente: kubectl -n polylane get pods y kubectl -n polylane logs -l app.kubernetes.io/name=polylane-k8s -c agent.

Desconexión

Desinstala la release con helm uninstall polylane --namespace polylane, desconecta el clúster en Polylane y luego revoca la clave de API del agente en Settings → API keys.

La conexión de Kubernetes ya tiene forma de pipeline: el agente se instala con Helm y registra el clúster por sí mismo, así que una vez que tienes una clave de API no queda ningún paso en la consola.

Requisitos previos

• Una clave de API de Polylane con el scope cloud_accounts:write, guardada como secreto del pipeline. Consulta Claves de API y OAuth. El flujo guiado crea esta clave por ti; una clave que crees tú mismo funciona igual.
• Helm y credenciales para el clúster de destino en el trabajo.

Instalar el 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 el trabajo reejecutable, y el registro es idempotente por clúster, así que repetir el pipeline nunca duplica la conexión. Para instalaciones de producción, prefiere apiKey.existingSecret (un Secret de Kubernetes creado previamente) en lugar de pasar la clave en la línea de comandos.

El agente se registra por sí mismo y el clúster aparece en Polylane, normalmente en menos de un minuto. Si no lo hace, revisa el pod del agente: kubectl -n polylane get pods y kubectl -n polylane logs -l app.kubernetes.io/name=polylane-k8s -c agent.

Desconectar

Desinstala la release con helm uninstall polylane --namespace polylane, desconecta el clúster en Polylane y luego revoca la clave de API del agente en Settings → API keys.