---
title: Kubernetes
slug: aiops/kubernetes
docTags: 
createdAt: 2025-06-08T03:38:07.502Z
---

Esta seção permite configurar a integração com um cluster Kubernetes para importar informações sobre namespaces, pods, serviços, e outros recursos para o sistema de inventário. A conexão é estabelecida por meio de autenticação com o cluster, seja via nome de usuário/senha ou, preferencialmente, token de autenticação.

1. **Host** (Obrigatório)
   - **Descrição:** Insira o endereço do servidor API do Kubernetes. Este é o endpoint de acesso ao cluster Kubernetes.
   - **Exemplo:** https\://192.168.0.200:6443
2. **Excluir namespaces**
   - **Descrição:** Selecione os namespaces que deseja **excluir** da descoberta. Isso é útil para evitar a importação de recursos de namespaces que não são necessários no inventário.
   - **Exemplo:** kube-system, monitoring.
3. **Autenticação via Token** (Opcional)
   - **Descrição:** Ative essa opção se desejar autenticar-se no cluster utilizando um token ao invés de nome de usuário e senha.
   - **Observação:** Se esta opção estiver habilitada, o campo de senha será substituído pelo campo de token.
4. **Nome de Usuário** (Obrigatório se a autenticação via Token estiver desativada)
   - **Descrição:** Informe o nome de usuário que será utilizado para autenticação com o cluster Kubernetes. Este usuário deve ter permissões suficientes para listar e gerenciar os recursos no cluster.
   - **Exemplo:** admin, devops-user.
5. **Senha** (Obrigatório se a autenticação via Token estiver desativada)
   - **Descrição:** Insira a senha associada ao nome de usuário. Este campo só estará disponível se a opção de autenticação via Token estiver desativada.
   - **Nota de Segurança:** A senha será armazenada de forma segura no sistema.
6. **Token de Autenticação** (Obrigatório se a autenticação via Token estiver ativada)
   - **Descrição:** Insira o token para autenticação com o cluster. Este campo substitui o nome de usuário e senha quando a autenticação via token está ativada.
   - **Exemplo:** eyJhbGciOiJSUzI1NiIs...

- **Testar Conexão**
  - **Descrição:** Verifica se as credenciais fornecidas e o host estão corretos e se o sistema pode se conectar com sucesso ao servidor API do Kubernetes. Certifique-se de que o servidor está acessível e que o usuário tem as permissões adequadas.
- **Permissões Necessárias:** Certifique-se de que o usuário ou token possui as permissões necessárias para listar namespaces, pods, serviços e outros recursos no cluster.
- **Filtragem de Recursos:** Utilize a opção de **Excluir namespaces** para evitar sobrecarga de dados desnecessários no inventário ao incluir apenas os namespaces de interesse.