Pular para o conteúdo principal

Como Conectar seu Repositório do GitHub

🔗 Integração com GitHub​

Agora você pode conectar seu servidor diretamente a um repositório do GitHub, permitindo que o código seja clonado automaticamente antes da aplicação iniciar. Essa funcionalidade funciona para qualquer linguagem — Python, Node.js, Java, JavaScript, entre outras — já que a clonagem é feita pelo próprio egg, independente da stack do seu projeto.

🚀 O que essa integração permite?​

  • ✅ Clonagem automática do repositório na inicialização
  • ✅ Suporte a repositórios públicos e privados
  • ✅ Escolha de branch específica
  • ✅ Atualização automática do código a cada reinício (Auto Update)
  • ✅ Compatível com qualquer linguagem suportada pelo painel

📋 Como conectar seu repositório​

  1. Acesse as configurações de Startup: No painel, entre no seu servidor e clique na aba Startup no menu lateral.
  2. Preencha o endereço do repositório: No campo GIT REPO ADDRESS, cole o link do seu repositório no formato: 
    https://github.com/seu-usuario/nome-do-repositorio
  3. Escolha a branch (opcional): No campo GIT BRANCH, deixe em branco para usar a branch principal, ou digite o nome de uma branch específica, como main ou dev.
  4. Configure "User Uploaded Files": Deixe essa opção desligada. Ela só deve ser ativada se você for enviar os arquivos manualmente pelo gerenciador de arquivos, sem usar o GitHub.
  5. Ative o "Auto Update" (recomendado): Com essa opção ativada, o servidor busca automaticamente as últimas atualizações do repositório a cada reinício, sem precisar reinstalar manualmente.
  6. Salve e reinstale: Clique em Save, depois acesse a página inicial do servidor e clique em Reinstall. Acompanhe o progresso pelo console.

🔒 Conectando um repositório privado​

Se o seu repositório for privado, o campo GIT REPO ADDRESS precisa incluir um Personal Access Token (PAT) do GitHub, já que o script de instalação só consegue clonar repositórios públicos sem autenticação.

Gerando o token no GitHub:

  1. Acesse GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) (ou "Fine-grained tokens", recomendado)
  2. Clique em Generate new token
  3. Dê um nome (ex: haskhosting-deploy) e marque apenas a permissão repo — ou, no fine-grained, restrinja o acesso somente àquele repositório, com permissão apenas de leitura
  4. Defina uma data de expiração (evite "no expiration")
  5. Copie o token gerado — ele só aparece uma vez

Usando o token no campo GIT REPO ADDRESS:

https://[email protected]/seu-usuario/nome-do-repositorio

Substitua SEU_TOKEN pelo token gerado, mantendo o resto da URL igual.

⚠️ Recomendações Importantes​

  • 🔸 O token fica visível no campo de variável do painel para quem tiver acesso à conta/servidor — use sempre um token com escopo mínimo, restrito só àquele repositório
  • 🔸 Nunca reaproveite um token que já é usado em outros projetos ou serviços
  • 🔸 Defina sempre uma data de expiração e gere um novo token quando ele vencer
  • 🔸 Se o repositório pertencer a uma organização com SSO habilitado, pode ser necessário autorizar o token explicitamente para a organização
  • 🔸 Se desconfiar que o token vazou, revogue imediatamente em Settings → Developer settings → Tokens e gere um novo

💡 Benefícios​

  • ⚡ Deploy automático direto do GitHub, sem upload manual
  • 🔄 Atualizações automáticas a cada reinício com o Auto Update
  • 🧩 Funciona com qualquer linguagem suportada pelo painel
  • 🔐 Suporte completo a repositórios privados via token

Com essa integração, manter seu servidor atualizado com o código do GitHub fica muito mais prático e profissional 🚀

Dúvidas ou problemas? Entre em contato com o suporte da HaskHosting.