Acceso a un cluster mediante el faro

Utilice Headlamp Desktop cuando desee acceder a uno o más clusters desde una estación de trabajo sin desplegar Headlamp en los clusters.

Para utilizar Headlamp Desktop para acceder a un cluster:

1. Si todavía no lo ha hecho, siga los pasos para configurar el archivo de configuración kubeconfig del cluster y (si es necesario) defina la variable de entorno KUBECONFIG para que apunte al archivo. Tenga en cuenta que debe configurar su propio archivo kubeconfig. No puede acceder a un cluster utilizando un archivo kubeconfig que haya configurado un usuario diferente. Consulte Configuración del acceso a los clusters.

2. Verifique que el archivo kubeconfig contiene el contexto de Kubernetes para el cluster al que desea acceder introduciendo:

   kubectl config get-contexts

3. Instale el escritorio de faros siguiendo las instrucciones del sistema operativo en la documentación del escritorio de faros.

   Por ejemplo, en macOS, puede instalar Headlamp Desktop con Homebrew introduciendo:

   brew install --cask headlamp

4. Inicie el escritorio del faro.
5. Seleccione el cluster o el contexto de Kubernetes al que desea acceder.
6. Complete la autenticación si se le solicita.

El faro muestra los recursos de Kubernetes a los que la identidad del archivo kubeconfig tiene autorización para acceder. Las operaciones disponibles en el faro dependen de los permisos de RBAC de Kubernetes otorgados a esa identidad.

Debido a que Headlamp Desktop se ejecuta en la estación de trabajo, no consume recursos de nodos de trabajador y no está sujeto a restricciones de carga de trabajo de nodos virtuales.

Despliegue el faro en un cluster cuando desee proporcionar una interfaz compartida basada en explorador.

Antes de instalar el faro, asegúrese de que:

• Ha configurado el acceso al cluster. Puede verificar el acceso introduciendo kubectl get nodes. Consulte Configuración del acceso a los clusters.
• Helm está instalado y disponible en su entorno. Puede verificar la instalación introduciendo helm version.
• Su identidad de Kubernetes tiene permisos suficientes para crear los recursos en el gráfico de Helm de faro.

Para instalar el faro con Helm:

1. Agregue el repositorio de Helm del faro introduciendo:

   helm repo add headlamp https://kubernetes-sigs.github.io/headlamp/

   helm repo update

2. Cree un espacio de nombres para el faro introduciendo:

   kubectl create namespace headlamp

3. Instale el faro introduciendo:

   helm install headlamp headlamp/headlamp --namespace headlamp

4. Verifique la instalación:

   kubectl get deployment,pods,service -n headlamp

   Espere hasta que la cápsula del faro esté en funcionamiento y lista.

El faro utiliza la autenticación de Kubernetes y RBAC para determinar a qué recursos de cluster pueden acceder los usuarios.

Para autenticarse en el despliegue del faro instalado mediante el gráfico de Helm:

1. Verifique la cuenta de servicio del faro introduciendo:

   kubectl get serviceaccount headlamp -n headlamp

2. Verifique ClusterRoleBinding introduciendo:

   kubectl get clusterrolebinding headlamp-admin -o yaml

   Importante
   
   

   Por defecto, el gráfico de Helm de faro crea un ClusterRoleBinding headlamp-admin que otorga el rol cluster-admin a la cuenta de servicio headlamp. El rol cluster-admin proporciona acceso sin restricciones al cluster. Para uso de producción, otorgue solo los permisos necesarios para su entorno.

3. Cree un token temporal para la cuenta de servicio Headlamp introduciendo:

   kubectl create token headlamp -n headlamp

4. Copie el token de la salida del comando. Este token se introduce al acceder al faro.

Para despliegues compartidos, considere la posibilidad de configurar la autenticación de OpenID Connect (OIDC) en lugar de distribuir tokens de cuenta de servicio. Consulte la documentación de Faro en cluster.

Para el acceso administrativo local, puede utilizar kubectl port-forward para acceder al servicio Headlamp.

1. Adelante el puerto local 8080 al servicio de faros introduciendo:

   kubectl port-forward -n headlamp service/headlamp 8080:80

2. Abra un explorador y vaya a:

   http://localhost:8080

3. Cuando se le solicite, introduzca el token de autenticación que creó anteriormente.

Para el acceso de producción compartido, configure la entrada, TLS y un mecanismo de autenticación adecuado en lugar de depender del reenvío del puerto. Consulte la documentación de faros en cluster.

Puede utilizar el faro con clusters que contienen pools de nodos virtuales.

• Headlamp Desktop se ejecuta fuera del cluster y no está sujeto a restricciones de carga de trabajo de nodos virtuales. Las cargas de trabajo que inspeccione o gestione seguirán sujetas a las capacidades y limitaciones del tipo de nodo en el que se ejecutan.
• Un despliegue de faros en cluster se ejecuta como pods de Kubernetes. Si los pods de faros están programados en nodos virtuales, los pods están sujetos a las mismas restricciones de recursos, almacenamiento, red y función de Kubernetes que otras cargas de trabajo que se ejecutan en nodos virtuales.

En particular, kubectl port-forward no está soportado para pods en nodos virtuales. Consulte Comparación de nodos virtuales con nodos gestionados y Recursos asignados a pods aprovisionados por nodos virtuales.

Después de conectarse al cluster con el faro:

1. Seleccione el cluster.
2. Seleccionar un espacio de nombres.
3. Abra Cargas de trabajo.
4. Seleccione Despliegues o Pods.
5. Seleccione un recurso para ver sus detalles, eventos, logs y recursos relacionados.

Los recursos y las operaciones que se muestran dependen de los permisos de RBAC de Kubernetes otorgados a la identidad que utilizó para acceder al cluster.

Si el servidor de métricas de Kubernetes está instalado en el cluster, el faro también puede mostrar información de uso de recursos. Para obtener más información sobre el servidor de métricas de Kubernetes, consulte Despliegue del servidor de métricas de Kubernetes en un cluster.

Para eliminar el despliegue del faro creado en este tema:

1. Desinstale la versión de Helm del faro introduciendo:

   helm uninstall headlamp -n headlamp

2. Suprima el espacio de nombres del faro introduciendo:

   kubectl delete namespace headlamp

La eliminación del escritorio de faros de la estación de trabajo no modifica los clusters a los que ha accedido con él.