Estudos e experimentos arquiteturais¶
Ambiente: ambiente local · Status: validação arquitetural, sem adoção corporativa · Revisão: 11/10/2026.
Istio e Kubernetes Gateway API¶
Segundo o responsável, Istio e Kubernetes Gateway API existem somente no ambiente local e estão em fase de validação arquitetural. Não fazem parte da arquitetura oficialmente entregue nos ambientes corporativos. A adoção corporativa exige decisão própria.
| Aspecto | Registro |
|---|---|
| Objetivo | Avaliar alternativas locais para exposição HTTP e integração com a autorização do Gateway |
| Hipóteses em avaliação | Adequação de Gateway/HTTPRoute e mecanismos de autorização ao contrato do Checker/Broker; equivalência de headers, status e comportamento de falha |
| Configuração implementada | Helmfile experimental com componentes Istio; template condicional HTTPRoute quando global.ingressController seleciona Istio |
| Testes nesta revisão | Leitura dos artefatos e validação do portal; nenhum teste operacional de Istio/Gateway API executado |
| Resultados operacionais | Equivalência com o perfil NGINX ainda é critério de avaliação |
| Limitações | Tutoriais históricos podem exigir adaptação; configuração declarada não confirma compatibilidade, desempenho, segurança ou prontidão corporativa |
| Critérios propostos para adoção | Testes reproduzíveis de autenticação, headers, tenancy, erros, rotas, TLS, carga, observabilidade e rollback; revisão arquitetural e aprovação explícita com TOTVS Apps; manifests corporativos próprios e ADR aceita |
Os critérios acima são uma proposta de avaliação, não decisão aprovada nem compromisso de migração.
Fontes locais: Helmfile experimental, HTTPRoute condicional.
Acervo experimental preservado¶
- Estudo histórico Istio versus NGINX: recomendações antigas são hipóteses/propostas, sem aprovação corporativa.
- Instalação histórica local: contém procedimentos experimentais Istio; não é roteiro de deployment corporativo e pode exigir adaptação.
- Proposta de aliases DNS: a alternativa com Gateway API é experimental; não define a exposição corporativa atual.
- Referência cloud: visão fornecida pelo arquiteto, sem representar a topologia corporativa.
Registro mínimo de novos estudos¶
Informar ambiente, objetivo, hipótese, fontes/versões, procedimento, resultado realmente observado, limitações e critérios propostos de adoção. Manter status experimental até haver decisão aprovada e evidências da implementação no ambiente ao qual ela se aplica. Resultados do ambiente local não demonstram adoção em DEV, STAGING ou PROD.