PostgreSQL
1. Visão Geral
O add-on PostgreSQL implanta uma instância dedicada do banco de dados relacional PostgreSQL dentro de um ambiente, com suporte a ACID, JSON e backups automáticos.
Use quando uma aplicação, Flow ou outro add-on precisa de um banco relacional próprio, isolado dos demais.
Tags do catálogo: Database, SQL.
2. Pré-requisitos
- Um squad e um ambiente já selecionados na tela de Add-ons.
3. Passo a passo do Deploy
O assistente de deploy do PostgreSQL tem 4 passos:
Passo 1 — General
| Campo | Obrigatório | Descrição |
|---|---|---|
| Add-on Name | Sim | Nome do add-on dentro do ambiente. Apenas letras minúsculas, números e hífens (3 a 63 caracteres). Exemplo: my-postgres. |
Passo 2 — Admin User
Define as credenciais de superusuário da instância, usadas pelo console administrativo, pelos backups e pelo copilot.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Admin Username | Sim | Usuário superusuário do PostgreSQL. Padrão: postgres. |
| Password | Sim | Senha do usuário superusuário. |
| Database Name | Sim | Nome do banco de dados criado na instância. Padrão: postgres. |
Passo 3 — Backup
Configura os backups automáticos da instância. Os backups são enviados para o Google Cloud Storage na frequência definida pelo cron, e os mais antigos são removidos automaticamente quando o limite de retenção é ultrapassado.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Enable automatic backups | Não | Liga/desliga os backups automáticos. Ligado por padrão. |
| Keep last N backups | Se backups ligados | Quantidade de backups mais recentes mantidos antes de purgar os mais antigos. Padrão: 10. |
| Cron schedule (UTC) | Se backups ligados | Expressão cron (em UTC) que define a frequência dos backups. Padrão: 0 2 * * * (todo dia às 02:00 UTC). |
Passo 4 — Database Resources (PostgreSQL)
Define os recursos alocados para a instância.
| Campo | Padrão | Máximo |
|---|---|---|
| Memory | 512Mi | 2Gi |
| CPU | 500m | 2000m |
| Disk Size | 5Gi | 20Gi |
Ao clicar em Deploy Add-on, a implantação é iniciada. O add-on passa a aparecer na aba My Add-ons do ambiente.
4. Perguntas frequentes
Dá para desligar os backups automáticos depois do deploy? Não. A configuração de backups automáticos é definida no momento da implantação e não pode ser desligada depois.
Onde ficam armazenados os backups e por quanto tempo? A retenção é por quantidade, não por tempo: você configura um número X de backups a manter (Keep last N backups) e a plataforma guarda sempre os X mais recentes, descartando os mais antigos. A frequência com que esses backups são gerados é definida pelo campo Cron schedule (UTC) do Passo 3.