> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/all-id/production-guidance.md).

# Orientações para produção

Exemplos de implantação e melhores práticas para executar o All ID em produção.

## Visão geral

Esta seção fornece guias de implantação específicos da plataforma para ajudar você a executar o All ID em produção. Cada guia inclui instruções completas de configuração, configurações de segurança, monitoramento e melhores práticas operacionais.

## Guias de implantação

### AWS ECS

Guia completo para implantar o All ID no AWS ECS Fargate com Application Load Balancer, RDS Aurora MySQL e descoberta de serviços com Cloud Map.

Oferecemos duas opções de Infrastructure as Code (IaC):

#### AWS CDK (TypeScript)

[**Ver o Guia de Implantação do AWS ECS (CDK) →**](/caf-api/caf-api-pt-br/all-id/production-guidance/ecs.md)

**Inclui**:

* Infrastructure as Code usando AWS CDK (TypeScript)
* Configuração de rede e grupos de segurança
* Configuração do cluster ECS Fargate
* Banco de dados Aurora MySQL Serverless v2
* Application Load Balancer com roteamento baseado em caminho
* Suporte a implantação multi-tenant
* Instruções completas de implantação passo a passo

{% hint style="info" %}
O guia CDK inclui um projeto CDK completo para provisionamento automatizado da infraestrutura. A Certta fornecerá o código CDK como parte do pacote de implantação.
{% endhint %}

#### Terraform (HCL)

[**Ver o Guia de Implantação do AWS ECS (Terraform) →**](/caf-api/caf-api-pt-br/all-id/production-guidance/ecs-terraform.md)

**Inclui**:

* Infrastructure as Code usando Terraform (HCL)
* Arquitetura modular com módulos reutilizáveis
* Configuração de rede e grupos de segurança
* Configuração do cluster ECS Fargate
* Banco de dados Aurora MySQL Serverless v2
* Application Load Balancer com roteamento baseado em caminho
* Suporte a implantação multi-tenant
* Instruções completas de implantação passo a passo
* Melhores práticas de gerenciamento de estado

{% hint style="info" %}
O guia Terraform inclui módulos e configurações completas do Terraform. A Certta fornecerá o código Terraform como parte do pacote de implantação.
{% endhint %}

{% hint style="success" %}
**Qual ferramenta de IaC devo escolher?**

* **AWS CDK**: Escolha se você prefere TypeScript/JavaScript, quer uma forte integração com a AWS ou já tem experiência com CDK
* **Terraform**: Escolha se você prefere a sintaxe declarativa HCL, precisa de suporte multicloud ou já tem experiência com Terraform

Ambas as opções criam a mesma infraestrutura e têm suporte completo da Certta.
{% endhint %}

### Outras plataformas

Guias de implantação adicionais para outras plataformas (EKS, Kubernetes, Docker Compose) podem ser fornecidos com base nos requisitos do cliente. Entre em contato com seu gerente técnico de contas da Certta para obter ajuda com plataformas de implantação alternativas.

## Melhores práticas gerais

Independentemente da sua plataforma de implantação, siga estes princípios básicos:

### Alta disponibilidade

* Implante em várias zonas de disponibilidade
* Use replicação de banco de dados com failover automático
* Configure verificações de integridade e sondas de prontidão
* Implemente autoescalonamento com base em métricas de carga

### Segurança

* Implante serviços em redes privadas
* Use gerenciamento de segredos para credenciais (nunca codifique diretamente)
* Implemente lista de permissões de IP para o Certta Router Service

{% hint style="info" %}
Veja [Melhores Práticas de Segurança](/caf-api/caf-api-pt-br/all-id/security-best-practices.md) para diretrizes detalhadas de segurança, incluindo segmentação de rede, criptografia e lista de permissões de IP.
{% endhint %}

### Monitoramento e operações

* Configure alertas para CPU, memória e taxas de erro
* Monitore o desempenho do banco de dados e os pools de conexão
* Acompanhe a latência e a taxa de transferência da API
* Habilite backups automáticos do banco de dados com retenção de 7 dias ou mais
* Teste regularmente os procedimentos de restauração

## Dimensionamento do ambiente

Equilibre custo com confiabilidade com base no ambiente:

**Desenvolvimento/Teste**:

* Instâncias únicas de cada serviço
* Configurações menores de banco de dados
* Monitoramento mínimo

**Produção**:

* Implantações com várias instâncias e autoescalonamento
* Banco de dados Multi-AZ com réplicas
* Monitoramento e alertas abrangentes

{% hint style="success" %}
Comece com uma configuração mínima de produção e escale com base nos padrões reais de uso. Monitore os custos e ajuste as alocações de recursos conforme necessário.
{% endhint %}

## Obtendo suporte

Para obter ajuda com a implantação:

* Revise os guias específicos da plataforma nesta seção
* Consulte [Requisitos Técnicos](/caf-api/caf-api-pt-br/all-id/technical-requirements.md) para especificações de recursos
* Revise [Configuração](/caf-api/caf-api-pt-br/all-id/configuration.md) para variáveis de ambiente
* Entre em contato com seu gerente técnico de contas da Certta para suporte de implantação

## Próximos passos

1. Escolha sua plataforma de implantação e ferramenta de IaC:
   * [AWS ECS com CDK](/caf-api/caf-api-pt-br/all-id/production-guidance/ecs.md) (TypeScript)
   * [AWS ECS com Terraform](/caf-api/caf-api-pt-br/all-id/production-guidance/ecs-terraform.md) (HCL)
2. Revise [Requisitos Técnicos](/caf-api/caf-api-pt-br/all-id/technical-requirements.md) para especificações de recursos
3. Prepare os pré-requisitos da sua infraestrutura
4. Siga as instruções de implantação passo a passo
5. Configure monitoramento e alertas
6. Valide sua implantação


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.caf.io/caf-api/caf-api-pt-br/all-id/production-guidance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
