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 diários são enviados para o Google Cloud Storage, e os mais antigos são removidos automaticamente ao ultrapassar o limite de retenção.
| 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. Após o Deploy
TODO: descrever como obter a string/host de conexão da instância após o deploy, e como restaurar um backup a partir do Google Cloud Storage.
5. Perguntas frequentes
Dá para desligar os backups automáticos depois do deploy?
TODO: confirmar se Enable automatic backups pode ser alterado após a implantação.
Onde ficam armazenados os backups e por quanto tempo? TODO: confirmar bucket/local de armazenamento e política de retenção além do "Keep last N backups".