Headlamp

Headlamp é uma interface web para gerenciamento de clusters. Ela permite visualizar recursos do cluster, gerenciá-los e monitorar o status de aplicações sem precisar usar kubectl.

Instalar

Antes de instalar o add-on, certifique-se de que o Nginx Ingress esteja instalado no cluster.

1. Acesse a seção Kubernetes e clique no cluster desejado.
2. Vá até a aba Complementos e selecione Headlamp.
3. Habilite a Instalação avançada e ajuste a configuração conforme necessário. Por exemplo, você pode definir:
   • o domínio onde a interface estará disponível;
   • configurações de ingress;
   • configuração de OIDC.
4. Clique em Instalar.

Para verificar se o add-on foi instalado corretamente, execute:

kubectl get pod -n headlamp

Se a instalação foi bem-sucedida, você verá um pod com status Running.

Autenticar

Após a instalação, o ícone do Headlamp aparecerá no painel de controle do cluster.

Clique nele para abrir a interface. Se você não estiver autenticado, será necessário fornecer um token.

O token pode ser obtido na aba Dashboard, clicando em Copiar ao lado de Token.

Após a autenticação, a interface do Headlamp será exibida.

Interface do Headlamp

Principais seções:

• Cluster: informações e status do cluster
• Map: visualização dos recursos e suas relações
• Workloads: gerenciamento de workloads (Pods, Deployments, StatefulSets)
• Storage: PVCs, PVs e classes de storage
• Network: serviços, ingress e políticas de rede
• Gateway: recursos do Gateway API
• Security: roles, service accounts e políticas de acesso
• Configuration: ConfigMaps, Secrets e outras configurações
• Custom Resources: recursos personalizados (CRDs)
• Create: criação de recursos pela interface

Configurar autenticação

Se a interface do Headlamp estiver exposta externamente, é recomendado configurar autenticação básica adicional.

O Headlamp não suporta autenticação direta por usuário e senha. A autenticação básica deve ser configurada no nível do ingress.

Crie um arquivo com usuário e senha:

htpasswd -c auth admin

Aqui, admin é o nome de usuário. Você será solicitado a digitar a senha desejada duas vezes.

O comando criará um arquivo chamado auth.

Se a utilidade htpasswd não estiver disponível, instale o pacote apache2-utils.

Em seguida, crie um secret no namespace headlamp usando o arquivo gerado:

kubectl create secret generic headlamp-basic-auth \
  --from-file=auth \
  -n headlamp

Vá para a seção Complementos no painel de controle do cluster e abra o add-on Headlamp instalado.

Habilite a instalação avançada e localize o seguinte bloco:

ingress:
 enabled: true
 annotations: {}

Remova {} ao lado de annotations e adicione as anotações necessárias:

ingress:
  enabled: true
  annotations:
    nginx.ingress.kubernetes.io/auth-type: basic
    nginx.ingress.kubernetes.io/auth-secret: headlamp-basic-auth
    nginx.ingress.kubernetes.io/auth-realm: "Authentication Required"

Clique em Salvar e aguarde a atualização do add-on.

Após isso, ao acessar o Headlamp, você precisará primeiro digitar o usuário e a senha, e depois fornecer o token.

Para alterar a senha, crie um novo arquivo auth e atualize o secret no cluster.