Saltar para o conteúdo principal
Versão 3.0

Configuração Geral

CompatibilidadeKubernetes1.32+OpenShift4.19+Rancher2.10.x+Helm3.2.0+

Configuração de componentes TDP​

A configuração é a etapa em que um componente TDP Kubernetes é adaptado ao ambiente e ao modo de operação adotado.
Ela define como o componente será implantado, quais recursos utilizará, como será exposto, de quais dependências precisa e como se integrará aos demais serviços da plataforma.

Na prática, a configuração permite ajustar parâmetros como namespace, CPU, memória, armazenamento, secrets, acesso externo, persistência e integrações compartilhadas — como banco de dados, object storage e serviços de apoio.
Com isso, o mesmo componente pode ser usado em contextos diferentes, como laboratório, homologação e produção, sem mudar sua função principal.

Por exemplo:

  • Conectar o Airflow ao PostgreSQL do cluster em vez de usar o banco interno
  • Dizer ao Kafka quantas réplicas de broker e qual fator de replicação mínimo usar
  • Informar ao NiFi onde está o servidor LDAP para autenticação
  • Configurar o S3 Gateway do Ozone com as credenciais certas para que o Spark possa gravar dados

Os parâmetros de configuração se aplicam independentemente do método de instalação utilizado.
O objetivo desta página é explicar o que normalmente pode ser configurado em um componente TDP e como esses ajustes funcionam na prática.

Ao longo desta seção, são apresentados os padrões de configuração mais comuns entre os componentes TDP:

ÁreaO que defineExemplos
Execução no clusterOnde e com quais recursos o componente será executado.Namespace, CPU, memória, réplicas e limites.
PersistênciaComo os dados serão armazenados.Volumes, disco, storage class e retenção.
Exposição do serviçoComo o componente será acessado.Service, porta, ingress, hostname e TLS.
Segurança e acessoComo credenciais e dados sensíveis serão fornecidos.Secrets, usuários, senhas, tokens e referências a secrets.
IntegraçõesComo o componente se conecta a outros serviços.PostgreSQL, S3/Ozone, endpoints e serviços compartilhados.
Forma de aplicaçãoComo a configuração chega ao cluster.Helm, Argo CD/GitOps e futuramente tdpctl.

Onde consultar os parâmetros disponíveis​

Antes de personalizar a configuração de um componente, existem três fontes principais:

  • A página do componente neste guia — cada componente tem uma página com os parâmetros suportados, exemplos e observações específicas.
  • O values.yaml do chart — contém todos os parâmetros aceitos com seus valores padrão e comentários explicativos; acesse com helm show values.
  • O README do chart — disponível no registry, oferece uma visão geral das opções e casos de uso.
info

Execute helm show values oci://registry.tecnisys.com.br/tdp/charts/<CHART_NAME> para exportar todos os parâmetros disponíveis com seus valores padrão e comentários explicativos.

Figura 1 — Exportar os valores padrão do chart
Figura 1 — Exportar os valores padrão do chart

Este comando exporta os valores padrão do chart para um arquivo local values-padrao.yaml.
Esse arquivo pode ser usado como referência para identificar quais parâmetros ajustar para o ambiente.

Arquivo de valores customizado​

A configuração de um componente é feita por meio de um arquivo YAML com apenas os parâmetros que precisam ser alterados em relação ao padrão do chart.
Não é necessário copiar o arquivo completo de valores do chart — inclua somente as chaves que deseja sobrescrever.

O arquivo de valores define o que será configurado. Helm ou Argo CD definem como essa configuração será aplicada ao cluster — em ambos os fluxos, o formato e os parâmetros são idênticos.

Exemplo mínimo de arquivo de valores:

meu-values.yaml
# Inclua apenas o que precisa ser diferente do padrão
resources:
  requests:
    cpu: "500m"
    memory: "1Gi"
  limits:
    cpu: "2"
    memory: "2Gi"

persistence:
  size: 20Gi
  storageClassName: "nfs-fast"

Os procedimentos a seguir mostram como aplicar os valores ao cluster via Helm ou Argo CD.

note

O Helm mescla automaticamente seus valores com os padrões do chart — inclua apenas as chaves que deseja customizar.

Formas de fornecer valores​

Arquivo de valores (recomendado) — crie um YAML com as chaves a alterar e passe com -f:

Terminal input
helm upgrade --install <RELEASE_NAME> oci://registry.tecnisys.com.br/tdp/charts/<CHART_NAME> \
  -n <NAMESPACE> --create-namespace \
  -f meu-values.yaml

Flag --set — para alterações pontuais diretamente na linha de comando:

Terminal input
helm upgrade --install <RELEASE_NAME> oci://registry.tecnisys.com.br/tdp/charts/<CHART_NAME> \
  -n <NAMESPACE> --create-namespace \
  --set parametro.chave=valor

Combinação de arquivos — múltiplos arquivos mesclados em ordem, com os últimos tendo precedência:

Terminal input
helm upgrade --install <RELEASE_NAME> oci://registry.tecnisys.com.br/tdp/charts/<CHART_NAME> \
  -n <NAMESPACE> --create-namespace \
  -f values-base.yaml \
  -f values-producao.yaml

Passo a passo​

Descobrir parâmetros disponíveis

Antes de começar, exporte os valores aceitos pelo chart. Consulte Onde consultar os parâmetros disponíveis.

  1. Crie o arquivo de valores (exemplo: meu-values.yaml):
PowerShell
code .\meu-values.yaml
  1. Ajuste os parâmetros desejados, como namespace, recursos ou integrações:
meu-values.yaml
resources:
  requests:
    cpu: "500m"
    memory: "1Gi"
  limits:
    cpu: "1"
    memory: "2Gi"
  1. Aplique a configuração com o arquivo criado:
Terminal input
helm upgrade --install <RELEASE_NAME> oci://registry.tecnisys.com.br/tdp/charts/<CHART_NAME> \
  -n <NAMESPACE> --create-namespace \
  -f meu-values.yaml
Figura 3 - Configuração do arquivo criado
Figura 3 - Configuração do arquivo criado
  1. Verifique se os valores configurados foram aplicados:
Terminal input
helm get values <RELEASE_NAME> -n <NAMESPACE>
Figura 4 - Verificação dos valores configurados
Figura 4 - Verificação dos valores configurados
  1. Verifique os pods:
Terminal input
kubectl get pods -n <NAMESPACE>
Figura 5 - Verificação dos pods
Figura 5 - Verificação dos pods
note

Para componentes stateful, como PostgreSQL, valide também:

kubectl get statefulset -n <NAMESPACE>
Figura 6 - Validação de componentes stateful
Figura 6 - Validação de componentes stateful

Para componentes que utilizam Deployment, valide também:

kubectl get deploy -n <NAMESPACE>
  1. Confirme que o release está com status deployed e com a revisão atualizada:
Terminal input
helm list -n <NAMESPACE>
Figura 7 - Helm list
Figura 7 - Helm list
Próximo passo

Para acessar a configuração de um componente específico, volte ao índice de configuração.