Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Backups e configurações

O rdev faz backup do que é difícil de reconstruir, e os backups sempre vão para um armazenamento que é seu.

Configurações dos agentes

As configurações, regras e skills dos seus agentes de IA (configurações, agentes, skills, comandos e hooks do Claude Code e do Codex, e as suas configurações de git e SSH) têm backup toda noite em um repositório git que é seu. Credenciais e chaves nunca são copiadas. Se você configurar um servidor novo, os seus agentes voltam com a mesma configuração. Isso está incluído em todos os planos.

Crie um repositório privado vazio e, no servidor, execute:

sudo rdev backup setup git [email protected]:you/rdev-settings.git

Ele imprime uma chave SSH; adicione-a ao repositório como uma deploy key com acesso de escrita e faça o primeiro backup com rdev backup run --settings. Cada ambiente grava na própria pasta, então no plano Team a equipe compartilha um repositório com uma pasta para cada desenvolvedor.

Backups noturnos

Nos planos Pro e Team, os seus bancos de dados MySQL, MariaDB, PostgreSQL e MongoDB e a sua pasta ~/Code têm backup toda noite em um bucket compatível com S3 que é seu: Amazon S3, Cloudflare R2, Hetzner, Backblaze ou o seu próprio MinIO. O node_modules, o vendor e outras pastas que podem ser reconstruídas ficam de fora. Os backups são criptografados e deduplicados; o rdev mantém 7 cópias diárias, 4 semanais e 6 mensais.

O jeito mais fácil é pelo painel: na página do seu servidor, Armazenamento de backup > Configurar o armazenamento de backup. Escolha o seu provedor, informe o endpoint, o bucket e uma chave que possa gravar e excluir nele, e guarde a senha de criptografia que o painel gera (ou informe a senha de backups que já estão nesse bucket para continuá-los). O seu navegador criptografa as chaves e a senha para esse servidor, então o painel nunca as vê. O servidor então grava um arquivo de teste no bucket, o exclui e abre o repositório criptografado; somente quando isso funciona ele mantém as configurações, e caso contrário informa o que deu errado (bucket inexistente, chave ou região incorreta, sem permissão). Testar conexão executa a mesma verificação depois.

Por um terminal, é assim:

sudo rdev backup setup s3 --endpoint s3.eu-central-1.amazonaws.com --bucket my-backups \
  --access-key AKIA… --secret-key …

Ele executa a mesma verificação (sudo rdev backup test a repete), aceita --region quando o endpoint não informa uma e imprime a senha de criptografia uma única vez. Guarde-a em um lugar seguro, fora do servidor: sem ela os backups não podem ser restaurados. Faça o primeiro backup com rdev backup run --data.

Você escolhe o bucket e fica com as credenciais; nós nunca temos acesso aos seus backups. Se um backup falhar, você recebe uma notificação nos seus canais.

Armazenamento de backup da equipe

No plano Team, o proprietário ou um administrador pode configurar um único bucket para toda a equipe na página Sua equipe: Armazenamento de backup da equipe > Configurar o armazenamento da equipe. Informe o endpoint, o bucket, uma chave que possa gravar e excluir nele e, se quiser, um prefixo de pasta, e guarde a senha de criptografia. Seu navegador criptografa as chaves e a senha separadamente para cada ambiente da equipe, então o painel nunca as vê. Cada ambiente faz backup na própria pasta, <prefix>/<member>/<environment>, assim os membros nunca sobrescrevem uns aos outros; quem tiver a chave e a senha pode restaurar os backups de qualquer membro.

Cada membro escolhe na página do seu servidor, em Armazenamento de backup: Armazenamento da equipe ou Meu próprio armazenamento. Um ambiente sem armazenamento próprio usa o da equipe, inclusive os de membros que entram depois: eles recebem as configurações de um ambiente que já o usa. Um ambiente que já tem o próprio bucket o mantém até o membro trocar. rdev backup status mostra qual armazenamento está em uso e a pasta. No terminal, --prefix em rdev backup setup s3 coloca os backups de um ambiente na pasta que você escolher, por exemplo em um bucket compartilhado.

Escolhendo o que tem backup

Você pode querer o backup das configurações dos seus agentes, mas não dos seus projetos, ou o contrário. Na página do seu servidor no painel, Desfazer e restaurar > Backup noturno tem um interruptor para cada um: Configurações dos agentes e Projetos e bancos de dados. O servidor aplica a escolha a partir da noite seguinte; rdev backup status a mostra, e rdev backup run ainda executa um backup manualmente, seja qual for a escolha. Escolher exige o rdev 0.2.0-beta.20 ou posterior.

Verificando e restaurando

  • rdev backup status mostra para onde os backups vão e como foram as últimas execuções.
  • rdev backup snapshots lista os snapshots noturnos.
  • Para restaurar pelo painel, abra o seu servidor e use Desfazer e restaurar > Backup de dados: escolha um backup e depois um projeto para restaurar os arquivos dele ou um banco de dados para restaurá-lo. O servidor faz isso em segundos e o resultado aparece em Restaurações recentes.
  • Ou no servidor: rdev backup restore <snapshot> --project shop ou rdev backup restore <snapshot> --database mysql:shop (mariadb:<name> para o MariaDB, postgres:<name> para o PostgreSQL, mongodb:all para todos os bancos de dados MongoDB de uma vez). O MariaDB e o MongoDB têm backup a partir do rdev 0.2.0-beta.19.

Um projeto restaurado substitui a pasta do projeto; a pasta substituída é movida para ~/rdev-restored, não é excluída. Um banco de dados restaurado é descartado e carregado a partir do backup, então as alterações feitas desde esse backup são perdidas. O painel conhece a lista de backups e de bancos de dados depois de cada execução noturna; restaurar exige o rdev 0.2.0-beta.16 ou posterior. Você ainda pode usar o restic diretamente com o seu bucket e a senha que você guardou.

Seu código

Os seus projetos ficam no git como de costume, e a sincronização de arquivos mantém uma cópia de trabalho no seu laptop. O rdev não substitui a sua própria hospedagem de git.