> ## 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.

# Checklist de atualização

> Siga as boas práticas e passos de verificação antes, durante e após um upgrade Helm do Midaz para garantir rollouts seguros em produção.

## Recomendação para produção

***

Não recomendamos usar as dependências padrão do Helm chart do Midaz (bancos de dados, cache e message broker) em ambientes de produção. Para deployments de nível produtivo, siga nossas [boas práticas](/pt/midaz/midaz-production-best-practices) para operar essas dependências com segurança adequada, observabilidade, backups, recuperação de desastres e SLOs.

## Boas práticas

***

### Ordem de atualização

Sempre atualize nesta ordem:

1. Infraestrutura (se necessário)
2. Midaz Core
3. Plugins (um por vez)

### Teste primeiro

Sempre teste atualizações em um ambiente de staging que espelhe produção antes de aplicar em produção.

### Monitore de perto

Monitore logs e métricas de perto nos primeiros 15-30 minutos após uma atualização.

### Mantenha backups

Mantenha backups dos seus valores do Helm e banco de dados antes de atualizações major.

## Resumo do checklist de atualização

| Passo                      | Comando                                                                           | Verificado |
| :------------------------- | :-------------------------------------------------------------------------------- | :--------: |
| Backup dos valores         | `helm get values <release> -n midaz > backup.yaml`                                |            |
| Verificar compatibilidade  | Revisar [tabela de compatibilidade](/pt/platform/helm/helm-version-compatibility) |            |
| Atualizar Midaz            | `helm upgrade midaz ...`                                                          |            |
| Verificar pods do Midaz    | `kubectl get pods -n midaz`                                                       |            |
| Atualizar plugins          | `helm upgrade <plugin> ...`                                                       |            |
| Verificar pods dos plugins | `kubectl get pods -n midaz`                                                       |            |
| Verificar logs             | `kubectl logs -n midaz deployment/<name>`                                         |            |

## Verificação pós-atualização

***

### 1. Verificar status dos pods

<CodeGroup>
  ```bash Shell theme={null}
  kubectl get pods -n midaz
  ```
</CodeGroup>

Todos os pods devem estar `Running` e `READY`.

### 2. Verificar serviços

<CodeGroup>
  ```bash Shell theme={null}
  kubectl get svc -n midaz
  ```
</CodeGroup>

### 3. Verificar os logs

<CodeGroup>
  ```bash Shell theme={null}
  # Se estiver usando o serviço Ledger (v5.x)
  kubectl logs -n midaz deployment/midaz-ledger

  # Se estiver usando serviços legado
  kubectl logs -n midaz deployment/midaz-onboarding
  kubectl logs -n midaz deployment/midaz-transaction

  # Verificar logs do RabbitMQ (importante para atualizações v4.x+)
  kubectl logs -n midaz statefulset/midaz-rabbitmq

  # Verificar logs do CRM (se habilitado)
  kubectl logs -n midaz deployment/midaz-crm
  ```
</CodeGroup>

### 4. Verificar roteamento de ingress (v5.x com Ledger)

<CodeGroup>
  ```bash Shell theme={null}
  kubectl get ingress -n midaz
  kubectl describe ingress midaz-onboarding -n midaz
  kubectl describe ingress midaz-transaction -n midaz
  ```
</CodeGroup>