Skip to main content

Backup GitHub

Este processo protege o hub do cliente em um repositório privado do GitHub. Ele não publica o produto e não envia .env.local, licença local, caches ou arquivos sensíveis.
O backup guarda dados operacionais, wiki, states e peças produzidas. Ele existe para você conseguir retomar trabalho, trocar de máquina com menos risco e não perder histórico.

1. Criar conta no GitHub

Se você ainda não tem conta, crie em github.com. Use um e-mail que você consiga acessar e ative autenticação de dois fatores se o GitHub pedir. Depois volte para o terminal.

2. Rodar o setup guiado

zoryon-setup
O primeiro bloco do setup verifica as ferramentas necessárias.
FerramentaPara que serve
GitVersionamento local do hub.
GitHub CLI (gh)Login e criação do repositório privado.
Git LFSArquivos grandes, imagens e vídeos quando ativado.
uvAmbiente Python do motor.
Node.js/npmSetup interativo e interface @clack/prompts.
ffmpegMídia, áudio e vídeo.
Se algo estiver ausente, aceite a instalação automática. Se ela falhar, siga a orientação exibida no próprio setup e rode zoryon-setup novamente.

3. Fazer login no GitHub

Quando o setup pedir:
gh auth login --web
Escolha GitHub.com, navegador/web e conclua a autenticação. Depois volte ao terminal. O setup valida gh auth status antes de criar o backup.

4. Escolher o repositório

Use o nome sugerido:
zoryon-coia-backup
O repositório é privado. Se ele já existir, o Zoryon conecta e faz pull sem apagar o trabalho local.

5. Decidir sobre Git LFS

Ative Git LFS se o cliente for guardar muita mídia no hub, como vídeos, imagens finais, áudios e materiais pesados. Para operações leves, pode deixar desativado e ativar depois.

6. Usar no dia a dia

zoryon-status
zoryon-pull
zoryon-push
zoryon-sync

Antes de trabalhar

Use zoryon-pull para puxar a versão mais recente da nuvem.

Ao terminar

Use zoryon-push para enviar o que mudou.

Ver status

Use zoryon-status para confirmar se o backup está conectado.

Sincronizar

Use zoryon-sync quando quiser pull e push em um único comando.

7. Saúde do backup

zoryon --doctor
zoryon status
Se o backup não estiver configurado, o status mostra nao_configurado. Isso não bloqueia o produto, mas significa que o hub está apenas local.
Nunca envie .env.local, cache de licença, keys, tokens ou segredos para o repositório. O backup deve proteger o trabalho sem expor credenciais.