> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Estratégias de deploy

> Escolha a estratégia de deploy certa para o Midaz sob o BYOC: Kubernetes com Helm, fundamentos do Terraform e pré-requisitos de infraestrutura.

Esta seção cobre as estratégias de deploy para rodar o Midaz na sua própria infraestrutura sob o modelo **BYOC (Bring Your Own Cloud)**. Se você usa o modelo **SaaS**, a Lerian gerencia o deploy para você. Vá direto para [Primeiros passos](https://docs.lerian.studio/pt/start-here/getting-started.md) para começar a configurar sua plataforma.

> [!NOTE]
>
> Não sabe qual modelo é o mais adequado? Veja [Modelos de deploy](https://docs.lerian.studio/pt/start-here/evaluate-and-deploy/deployment-models.md) para uma comparação completa entre SaaS e BYOC.

Configure seu ambiente, atenda aos pré-requisitos e siga nossas boas práticas.

> [!TIP]
>
> Antes de fazer o deploy, confira a [Visão geral da arquitetura do Midaz](https://docs.lerian.studio/pt/products/midaz/architecture.md).

### Conteúdo

* [Midaz Terraform Foundation](https://docs.lerian.studio/pt/products/midaz/midaz-terraform-foundation.md): exemplos prontos de Terraform para provisionar a infraestrutura de nuvem em que o Midaz roda (AWS, GCP ou Azure).

Para instalar, configurar e atualizar o Midaz com o chart dele, consulte o [README do chart do Midaz](https://github.com/LerianStudio/helm/tree/main/charts/midaz).

## Estratégias de deploy

***

No BYOC, você gerencia a infraestrutura. Recomendamos fortemente usar Kubernetes com nossos Helm Charts. Essa abordagem simplifica o deploy e o escalonamento.

Você pode escolher a estratégia de deploy que atende às suas necessidades.

### Deploy com Kubernetes

Recomendamos nossos Helm Charts oficiais. Eles instalam o Midaz em um ambiente Kubernetes.

Você pode conectar o Midaz aos seus bancos de dados e serviços já existentes ou usar os componentes padrão fornecidos no Helm chart. Essa configuração se adapta a diferentes necessidades de infraestrutura.

Para a instalação passo a passo, consulte o [README do chart do Midaz](https://github.com/LerianStudio/helm/tree/main/charts/midaz).

### Deploy autogerenciado

Se você prefere controle total, pode fazer o deploy do Midaz manualmente. O Midaz é distribuído como imagens de container públicas no Docker Hub.

Você pode executá-las na sua própria infraestrutura, com um orquestrador diferente ou diretamente em máquinas virtuais ou bare metal.

Para instruções, confira a página [Instalando o Midaz](https://docs.lerian.studio/pt/products/midaz/midaz-setup.md).

## Requisitos de plataforma

***

Se você traz seus próprios componentes de infraestrutura, confirme que atende às versões mínimas suportadas:

| Serviço | Versão mínima suportada | Notas |
| :- | :- | :- |
| PostgreSQL | 17 | Banco de dados principal |
| MongoDB | 8.x | Armazenamento de documentos |
| RabbitMQ | 4.x | Broker de mensagens |
| Valkey | 8.x | Saldos em tempo real (fork do Redis) |

O Midaz precisa dessas versões mínimas para uma plataforma estável e com bom desempenho.

## Boas práticas

***

### Acesso à infraestrutura

* Use políticas de privilégio mínimo ao se conectar aos bancos de dados.
* Bloqueie o acesso direto aos bancos de dados por padrão. Permita apenas em casos excepcionais, com aprovação.
* Armazene segredos com segurança usando ferramentas como o HashiCorp Vault.
* Use ferramentas dedicadas para acesso seguro aos dados de produção.

### Redundância e alta disponibilidade

* Habilite replicação e backups tanto para o Midaz quanto para seus bancos de dados.
* Use load balancers para distribuir o tráfego entre os serviços de forma equilibrada.

### Segurança de rede

* Rode seus serviços dentro de VPCs para isolar componentes críticos.
* Use NAT gateways ou proxies para conexões de saída.
* Aplique security groups ou regras de firewall para restringir o acesso às portas e IPs necessários.

### Persistência e armazenamento de dados

* Use bancos de dados replicados para dar suporte à alta disponibilidade e à recuperação.
* Escolha soluções de armazenamento escaláveis que acompanhem o crescimento dos seus dados.
* Use o Valkey (fork do Redis), que guarda os saldos em tempo real.

### Observabilidade

* Integre ferramentas que monitoram logs, traces e métricas.
* O Midaz aceita observabilidade por meio do OpenTelemetry.

## Responsabilidades compartilhadas

***

Sob o modelo BYOC, a Lerian e sua equipe dividem a responsabilidade por rodar o Midaz. Para um detalhamento de quem protege o quê (incluindo como as responsabilidades diferem entre BYOC e SaaS), veja a página [Segurança](https://docs.lerian.studio/pt/products/midaz/security.md).

> [!TIP]
>
> Para orientações sobre como proteger seu ambiente antes do deploy, confira a documentação de [Recomendações de segurança](https://docs.lerian.studio/pt/products/midaz/security-recommendations.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.