Configuração do OpenMetadata
O que é o OpenMetadata?
O OpenMetadata é uma plataforma de catálogo de dados e governança.
Em termos práticos, é onde você registra todos os ativos de dados da sua organização — tabelas do ClickHouse, tópicos do Kafka, dashboards do Superset, pipelines do Airflow — e obtém uma visão unificada de quem os criou, o que significam, quem os usa e como eles se relacionam.
No TDP Kubernetes, o OpenMetadata resolve a seguinte necessidade: com tantos componentes (Trino, ClickHouse, Kafka, Airflow, Superset), fica difícil saber onde um dado específico está, o que significa, e se ainda é confiável.
O OpenMetadata é o ponto central de descoberta e documentação.
Consulte OpenMetadata — Conceitos para uma visão completa da ferramenta, sua arquitetura e funcionamento.
Componentes implantados
| Componente | Descrição |
|---|---|
| OpenMetadata Server | API e interface web do catálogo |
| MySQL (interno padrão) | Banco de metadados do OpenMetadata |
| OpenSearch/Elasticsearch | Backend de busca para encontrar ativos de dados |
| Job de datasources (opcional) | Registra automaticamente os serviços TDP após a instalação |
O job de registro de datasources
Uma funcionalidade específica do chart tdp-openmetadata é o job de integração de datasources (datasourcesIntegration.enabled=true).
Ele roda automaticamente após a instalação e registra no OpenMetadata os serviços TDP que você habilitou (ClickHouse, Trino, Superset, Airflow, Kafka).
Assim, você não precisa cadastrar cada serviço manualmente pela UI.
Detalhes em Integrações — OpenMetadata.
Esta página resume a configuração do chart tdp-openmetadata: instalação via registry OCI, parâmetros principais e job opcional de registro de datasources após instalação ou atualização.
Visão geral
| Propriedade | Valor |
|---|---|
| Chart | tdp-openmetadata |
| Versão do OpenMetadata | 1.9.11 |
| Versão do Chart | 3.0.0 |
| Registry (OCI) | oci://registry.tecnisys.com.br/tdp/charts/tdp-openmetadata |
Instalação (OCI)
helm install <release> oci://registry.tecnisys.com.br/tdp/charts/tdp-openmetadata -n <namespace> --create-namespace
Parâmetros principais
| Parâmetro | Descrição | Valor por omissão |
|---|---|---|
openmetadata.enabled | Habilitar o deploy | true |
openmetadata.image.tag | Tag da imagem do servidor | 1.9.11 |
openmetadata.ingress.enabled | Habilitar Ingress | false |
openmetadata.config.database.dbScheme | Esquema do banco de metadados | mysql |
openmetadata.config.database.host | Host do banco de metadados | mysql |
openmetadata.config.elasticsearch.searchType | Backend de busca | opensearch |
openmetadata.config.elasticsearch.host | Host do backend de busca | opensearch |
externalServices.postgresql.* | Referência a PostgreSQL externo (hooks / senha admin) | "" |
datasourcesIntegration.enabled | Job pós-install/upgrade que registra serviços externos | false |
Demais chaves: consulte a saída de helm show values para a versão do pacote que utiliza.
Integração de datasources
Após install ou upgrade, um Job pode registrar serviços no OpenMetadata quando datasourcesIntegration.enabled=true:
- ClickHouse (Database Service)
- Trino (Database Service)
- Superset (Dashboard Service)
- Airflow (Pipeline Service)
- Kafka (Messaging Service)
Pré-requisitos: OpenMetadata e os serviços de destino implantados e alcançáveis; credenciais no arquivo de valores e/ou em Kubernetes Secrets.
Detalhes de YAML e exemplos estão em Integrações — OpenMetadata.
Acesso
kubectl -n <namespace> port-forward service/<release> 8585:8585
Solução de problemas
kubectl -n <namespace> get jobs
kubectl -n <namespace> logs job/<release>-register-datasources
Falhas comuns: OpenMetadata ainda não pronto, erro de autenticação, Secret ausente ou serviço de destino inacessível.
Desinstalação
helm uninstall <release> -n <namespace>
Autenticação e segurança
Provedores de autenticação avançados (por exemplo LDAP) não fazem parte do escopo desta documentação do pacote; alinhe com a documentação oficial do OpenMetadata e com o seu arquivo de valores. Veja Segurança — OpenMetadata para o que a documentação TDP cobre.