Pular para o conteúdo principal
O Petto Vault é um lugar privado para proteger a configuração do seu servidor. Um backup é uma foto da estrutura do servidor: cargos, canais, permissões, emojis, figurinhas, regras do AutoMod e as principais configurações do servidor. Ele nunca guarda mensagens, lista de membros, tokens ou senhas.
Os backups podem ser colocados em manutenção pela equipe do Petto. Enquanto estiverem, o !backup, o seu menu e a página Backups do dashboard avisam, e os backups agendados não são feitos. Os backups que você já tem e o seu agendamento continuam como estão.
Os backups automáticos ficam desligados até um administrador ligá-los. Qualquer backup pode ser apagado a qualquer momento, e os backups de um servidor de onde o Petto saiu são apagados 30 dias depois do último.
kira digita !backup e o Petto responde que os backups estão em manutenção e que os salvos são mantidos

No Discord: enquanto os backups estão em manutenção, !backup avisa e não faz mais nada.

A página Backups coberta pelo aviso Os backups estão em manutenção

Dashboard → Backups: o mesmo aviso no dashboard.

O que um backup guarda

  • Cargos: nome, cor, ícone, permissões, posição, e se são exibidos separadamente ou podem ser mencionados.
  • Canais e categorias: nomes, ordem, tópicos, modo lento, configurações de voz, tags e padrões de fóruns, e as permissões de cada um.
  • Emojis e figurinhas (as figurinhas animadas Lottie não podem ser enviadas de novo, então uma restauração as pula).
  • Regras do AutoMod do Discord, com suas exceções e ações.
  • Configurações do servidor: nome, ícone e banner, descrição, idioma, nível de verificação, notificações, opções do canal do sistema e os canais especiais (regras, atualizações, AFK, alertas de segurança).
As únicas pessoas em um backup são as citadas nas permissões de um canal (o ID delas), que é o que uma restauração precisa para colocar essas permissões de volta.

Comandos

Abra o menu

O menu permite criar, listar, exportar, restaurar, apagar e agendar backups, e ver a atividade, a partir de uma lista de opções. É o que abre se você digitar só !backup (!backups e !serverbackup também funcionam).
O painel do Petto Vault com três backups recentes, um agendamento a cada 24 horas guardando 7, e o menu para criar, listar, exportar, restaurar, apagar e agendar

No Discord: a Central de backups do !backup panel.

A central de backups com o menu aberto: criar, listar, exportar o último, restaurar, apagar, agendar e a atividade

No Discord: o menu de !backup panel, aberto.

Criar, listar e exportar

liam cria um backup chamado Antes de mudar os cargos e o Petto diz que o backup 8 foi salvo com 14 cargos, 25 canais e 3 emojis

No Discord: !backup create com um nome: o número e o que foi salvo.

O Petto lista os backups 7, 6 e 5 com seus nomes e há quanto tempo foram feitos

No Discord: !backup list: número, nome, automático ou manual, e quando.

O Petto diz que o backup 6 está pronto e anexa o arquivo petto-backup-1290000000000000001-6.json

No Discord: !backup export: o backup como arquivo JSON.

export entrega um arquivo JSON com a configuração capturada.

Restaurar um backup

Só Administradores podem restaurar. Nada muda até você confirmar, e uma restauração passa por etapas:
shi usa !backup restore 6 e o Petto responde em vermelho que só Administradores podem restaurar

No Discord: um membro sem Administrador não pode restaurar.

  1. Prévia. O Petto mostra quantos cargos, canais e emojis criaria ou atualizaria e, no modo replace, os nomes dos canais e cargos que apagaria.
  2. Verificação humana. Uma imagem com letras, como a da verificação. Digite as letras para continuar.
  3. Backup de segurança. O Petto salva o servidor como está agora, para você poder voltar. O número dele aparece no final.
  4. Progresso ao vivo. Uma mensagem mostra a fase e quanto falta, com um botão Parar restauração. Só uma restauração roda por vez em um servidor.
O Petto mostra o plano de restaurar o backup 6 no modo merge, com Continuar e Cancelar

No Discord: a prévia de um merge: o que seria criado e atualizado, nada é apagado.

O Petto avisa em vermelho que replace apagaria os canais zona-spam e eventos-antigos e o cargo Temporário

No Discord: no modo replace a prévia diz o que seria apagado.

O cartão pede para digitar as letras da imagem, mostra K7M2Q e tem os botões para digitar, pedir outra imagem ou cancelar

No Discord: depois de Continuar: a imagem com letras.

A caixa de verificação humana com K7M2Q digitado

No Discord: a caixa onde as letras são digitadas.

O cartão do Petto restaurando o backup 6 em 45%, passo 19 de 42, restaurando canais, com um botão vermelho para parar

No Discord: uma mensagem mostra a fase, quanto falta e Parar restauração.

O Petto diz que o backup 6 foi restaurado no modo merge, que o backup de segurança é o 8 e o que foi criado e atualizado

No Discord: o fim da restauração, com o número do backup de segurança.

O mode pode ser:
  • merge (o seguro): cria o que falta e atualiza o que existe. Não apaga nada.
  • replace: também apaga os canais e cargos que não estão no backup.
Uma restauração parada mantém o que já fez e não apaga mais nada. O replace não apaga absolutamente nada se um cargo ou canal não pôde ser criado, e nunca apaga o canal de onde você começou nem os canais de regras, do sistema, de atualizações e AFK.

Ative os backups automáticos

O Petto confirma backups automáticos a cada 24h, mantendo os 7 últimos, e quando roda o próximo

No Discord: !backup schedule 24 7: a cada 24 horas, mantendo 7.

hours vai de 1 a 168 e keep de 1 a 30 (7 se você não informar). Exemplo: !backup schedule 24 7 faz um backup a cada 24 horas e mantém os últimos 7 automáticos. Para desligá-los:
O Petto confirma que os backups automáticos estão desligados

No Discord: !backup unschedule.

Apagar backups

Só Administradores podem apagar, e o Petto pede para você confirmar antes. Apagar todos os backups também desliga os automáticos. No menu é Apagar backups (digite um número, ou ALL).
liam usa !backup delete 5 e o Petto pergunta em vermelho se apaga o backup 5, com Apagar e Cancelar

No Discord: o Petto pergunta antes de apagar um backup.

A pergunta muda para Backup 5 apagado

No Discord: depois de Apagar.

O Petto pergunta em vermelho se apaga os 3 backups e desliga os automáticos

No Discord: apagar todos os backups também desliga os automáticos.

A caixa Apagar backups com 5 digitado no campo do número do backup ou ALL

No Discord: no menu, Apagar backups pede um número ou ALL.

Veja a atividade

Mostra quem criou, exportou, restaurou ou apagou backups e quem mudou o agendamento: as últimas 10 entradas, ou até 20 com limit.
O Petto lista a atividade: uma exportação de liam, um backup agendado feito pelo Petto, um backup de liam e uma mudança de agendamento

No Discord: !backup audit: quem fez o quê e quando.

Use pelo dashboard

Dashboard → Backups faz o mesmo: criar, exportar, agendar, ver a atividade e apagar. Restaurar abre uma janela com as mesmas etapas (modo, o que trazer de volta, prévia, verificação humana) e depois mostra o progresso ao vivo com um botão Parar restauração.
A página Backups com Criar um backup, Backups automáticos a cada 24 horas mantendo 7, três backups salvos, o cartão Seus dados e o histórico de atividade

Dashboard → Backups: criar, agendar, os backups salvos com Exportar, Restaurar e apagar, Seus dados e a atividade.

O diálogo de restauração com o conteúdo do backup 6, cargos, canais e emojis para criar e atualizar, e em vermelho os 2 canais e 1 cargo que apagaria

Dashboard → Backups → Restaurar: o que o backup tem, o que seria criado e atualizado, e o que replace apagaria.

A etapa de verificação com a imagem K7M2Q, a resposta digitada e o botão Iniciar restauração

Dashboard → Backups → Restaurar: digite as letras da imagem e depois Iniciar restauração.

Restaurando o backup 6 em 45%, passo 19 de 42, restaurando canais, com o botão para parar

Dashboard → Backups → Restaurar: o progresso da restauração, com Parar restauração.

Restauração concluída, com o que foi criado, atualizado e apagado e a nota de que o backup 8 tem o servidor como era

Dashboard → Backups → Restaurar: o fim, com o que mudou e o backup de segurança.

O diálogo Apagar um backup perguntando se apaga o backup 5, com Cancelar e Apagar

Dashboard → Backups: apagar um backup pergunta antes.

Restaurar só algumas partes

No dashboard você pode escolher o que trazer de volta. Desmarque o que deve ficar como está agora:
  • Cargos
  • Canais, categorias e permissões
  • Configurações do servidor
  • Emojis
  • Figurinhas
  • Regras do AutoMod
A primeira etapa do diálogo de restauração: Merge ou Substituir, e as seis partes para recuperar, todas marcadas

Dashboard → Backups → Restaurar: o modo e O que recuperar.

O replace só apaga dentro das partes que você traz de volta, então restaurar só os canais nunca apaga um cargo. A prévia também diz o que o backup contém: cargos, categorias, canais, permissões sobrescritas, emojis, figurinhas e regras do AutoMod.
Restaurar só algumas partes é uma opção do dashboard. O !backup restore sempre traz de volta todas as partes.
O cartão Seus dados diz o que é guardado e permite desligar os backups automáticos ou apagar tudo. O dashboard nunca fala direto com o banco de dados. As ações passam pelo bot, que confere no Discord se você tem Manage Server ou Administrator naquele servidor (restaurar e apagar precisam de Administrator).

Banco de dados próprio

O Vault usa a sua própria conexão PostgreSQL através de PETTO_VAULT_DATABASE_URL. Defina a senha como uma variável privada no host e nunca a publique no repositório. O bot e o dashboard compartilham um segredo privado: