Backup de volumes
Um volume é o disco persistente que uma aplicação monta no canvas do ambiente. Por padrão ele não tem backup. Ao ligar o backup, a plataforma tira cópias periódicas do volume e as guarda fora do cluster, cifradas com uma chave da sua organização.
Como funciona
- A plataforma tira um snapshot do disco. A aplicação continua rodando.
- Uma cópia do snapshot é enviada para o armazenamento de backups da sua organização, cifrada com uma senha exclusiva da organização. Ninguém de outra organização consegue ler, e sem a senha os arquivos são ilegíveis.
- Opcionalmente, os snapshots mais recentes também ficam no cluster (snapshots locais), o que deixa a restauração no mesmo ambiente bem mais rápida.
Você nunca recebe nem precisa de credenciais de armazenamento: tudo passa pelo portal, pela API ou pela CLI.
O backup de volume equivale a desligar a máquina da tomada e copiar o disco: os arquivos ficam como estavam no instante do snapshot, mas uma escrita pela metade pode aparecer incompleta. Para dados transacionais (pedidos, saldos, cadastros), use os bancos gerenciados, que têm backup consistente e restauração para um ponto no tempo. Use o backup de volume para arquivos: uploads, mídia, índices que podem ser reconstruídos, estado de ferramentas.
Ligar o backup em um volume
No canvas do ambiente, selecione o volume e abra a seção Backup:
| Campo | O que define |
|---|---|
| Backup ligado | Liga os backups agendados deste volume. |
| Intervalo | De quantas em quantas horas um backup novo começa. Não pode ser menor que o mínimo do plano. |
| Retenção | Por quantos dias cada ponto de backup fica guardado. Não pode passar do máximo do plano. |
| Snapshots locais | Quantos snapshots recentes ficam no cluster para restauração rápida (0 desliga). |
Como toda mudança no canvas, a configuração entra no rascunho e vale depois que você aplica a revisão. O diff mostra o que muda antes de aplicar.
Backup sob demanda
Na lista de backups do volume, Fazer backup agora cria um ponto na hora, com um rótulo opcional (por exemplo, "antes da migração"). Precisa do papel Developer. Só um backup roda por vez em cada volume; se já houver um em andamento, espere ele terminar. Cada plano tem um limite diário de backups sob demanda.
Restaurar
A restauração sempre cria um volume novo, ao lado do original. Ela nunca sobrescreve o volume atual, então você pode conferir os dados antes de trocar.
- Na lista de backups do volume, escolha o ponto e clique em Restaurar.
- Dê um nome ao volume novo (por exemplo,
uploads-restaurado) e, se quiser, um tamanho maior. O tamanho nunca pode ser menor que o do volume de origem. - O volume novo aparece no rascunho do canvas. Aplique a revisão: o volume fica em Restaurando até a cópia terminar.
- Confira os dados e, quando estiver tudo certo, troque a aresta de montagem (
mount) da aplicação do volume antigo para o novo no canvas e aplique. - Remova o volume antigo quando não precisar mais dele.
Restaurar no mesmo ambiente exige o papel Developer. Restaurar em outro ambiente do mesmo projeto (por exemplo, dados de produção em homologação) exige Admin, porque leva dados para um ambiente que pode ter acesso mais amplo.
Backup final ao excluir um volume
Excluir um volume com backup ligado cria primeiro um backup final. O volume só é apagado depois que esse backup termina. Se o backup final falhar, a exclusão para e os dados continuam intactos.
O backup final fica guardado pelo prazo do plano e aparece na lista de backups da organização, mesmo depois que o volume deixa de existir. Ele pode ser restaurado no ambiente original ou em outro ambiente do mesmo projeto (este caso com papel Admin).
Retenção e limites por plano
| Chave | O que limita | Starter | Pro | Business | Enterprise |
|---|---|---|---|---|---|
volumes.backups | Backup de volume disponível | não | sim | sim | sim |
volumes.backupMinIntervalHours | Intervalo mínimo entre backups agendados | — | 24 h | 6 h | 1 h |
volumes.backupRetentionDaysMax | Retenção máxima de cada ponto | — | 7 dias | 30 dias | 90 dias |
volumes.finalBackupRetentionDays | Retenção do backup final | — | 7 dias | 30 dias | 90 dias |
volumes.localSnapshotsMax | Snapshots locais por volume | 0 | 1 | 3 | 7 |
volumes.onDemandBackupsPerDay | Backups sob demanda por dia | 0 | 3 | 10 | 50 |
volumes.backupStorageGiB | Espaço total de backups de volume da organização | 0 | 100 GiB | 1 024 GiB | 10 240 GiB |
Estes são os valores padrão de cada plano. O administrador da plataforma pode ajustá-los por plano ou por organização; o portal sempre mostra o valor que vale para a sua organização (veja Planos, recursos e limites).
- No Starter, o painel de backup mostra o aviso do plano e não deixa ligar.
- Ao passar do espaço de backups, novos backups sob demanda e restaurações ficam bloqueados até liberar espaço. Os backups agendados continuam: a proteção dos dados não para.
- Se o plano mudar para um que não tem backup de volume, os agendamentos ficam suspensos sem apagar a configuração nem os pontos existentes. Voltar a um plano com backup retoma tudo.
- O espaço ocupado pelos backups e pelos snapshots locais aparece no consumo da organização.
Perguntas frequentes
Posso restaurar um arquivo só? Não. A restauração é sempre do volume inteiro, em um volume novo. Monte o volume restaurado numa aplicação e copie o que precisar.
Posso restaurar por cima do volume atual? Não. Restaurar ao lado e trocar a montagem evita perder o estado atual por engano.
O backup deixa a aplicação lenta? O snapshot é rápido e a cópia roda num processo à parte, com recursos próprios, fora da cota das suas aplicações.