Kubernetes¶

Status: Não Adotado

Nenhum produto CoreFlow usa Kubernetes hoje. Este documento existe para deixar essa decisão explícita, não para descrever uma arquitetura em uso.

Objetivo¶

Registrar por que Kubernetes não faz parte da stack real do ambiente hauxtech, e quando isso deveria ser reavaliado.

Situação real¶

Toda a orquestração de containers do ambiente hauxtech é feita com Docker Compose v2, um stack por produto, em uma única VPS Contabo com Nginx Proxy Manager como proxy reverso — ver Docker e Cloud.

Por que não¶

8 produtos, cada um um monólito Django simples, sem necessidade de autoscaling horizontal automático.
Uma única VPS não se beneficia de um control plane de cluster — não há múltiplos nós para orquestrar.
Docker Compose cobre hoje 100% da necessidade real: subir/derrubar serviços, reiniciar em falha (restart: unless-stopped), redes isoladas por stack.
Adotar Kubernetes agora adicionaria complexidade operacional (etcd, kubelet, manifests, Helm) sem um problema real que resolva.

Quando reavaliar¶

Se um produto precisar de autoscaling real por carga variável.
Se o número de nós/VPS crescer a ponto de Docker Compose por servidor deixar de ser gerenciável manualmente.
Se surgir exigência de alta disponibilidade multi-região para algum produto específico.

Nenhum desses cenários está presente hoje nos 8 produtos CoreFlow.

Objetivo Final¶

Não usar uma ferramenta de orquestração mais complexa do que o problema real exige. Docker Compose permanece o padrão até que uma necessidade concreta justifique a migração.