Como Conectar Repositórios

Você pode conectar o repositório com o código da sua aplicação à nossa App Platform ao criar um novo app no painel de controle da Hostman.

A App Platform é compatível com repositórios GitLab, GitHub e BitBucket, além de repositórios acessíveis via URL, como Gitea, GitLab self-hosted, GitHub Enterprise, entre outros.

Conectar um repositório do GitLab, GitHub ou BitBucket

Para conectar o repositório:

1. Acesse a seção Plataforma de apps e clique em Criar aplicativo.

2. Na etapa Repositório, clique no ícone da plataforma.

3. Faça login na sua conta.

4. Autorize o acesso aos repositórios necessários.

5. Selecione o repositório para fazer o deploy na dashboard da Hostman.

Se você já estiver logado na sua conta do GitHub, GitLab ou Bitbucket, a Hostman exibirá automaticamente os repositórios disponíveis. Basta selecionar o desejado.

Se estiver logado mas o repositório necessário não aparecer:

1. Clique em Adicionar conta.

2. Escolha a plataforma.

3. Faça login, se necessário.

4. Selecione os repositórios desejados e salve as alterações.

Depois, selecione o repositório desejado para o deploy na dashboard da Hostman.

Conectar um repositório via URL

Você pode conectar qualquer repositório com um endereço externo HTTP ou HTTPS, incluindo repositórios do GitLab self-hosted, GitHub Enterprise ou provedores que não oferecemos suporte direto (ex: Gitea).

Essa opção também pode ser usada por motivos de segurança: se você não quiser fornecer acesso à conta Git inteira, é possível adicionar apenas o repositório específico por link.

Atenção: o deploy automático não estará disponível para repositórios conectados via URL. Após atualizar o código, será necessário fazer o deploy manualmente, escolhendo o commit.

Para repositórios públicos, basta informar a URL.

Para repositórios privados, você deverá fornecer login e senha da conta ou um token gerado na interface do provedor (GitLab, GitHub etc.).

Conectar um repositório

Você pode conectar o repositório por URL ao criar uma nova aplicação:

1. Acesse a seção Plataforma de apps e clique em Criar aplicativo.

2. Na etapa Repositório, clique em Conectar repositório via URL.

3. Informe a URL do repositório e os dados de acesso, caso seja privado.

4. Clique em Conectar.

O repositório e os commits disponíveis serão exibidos no painel de controle.

Obter link git

O link deve estar no formato Git URL, por exemplo:

https://github.com/hostman/app-example.git

No GitHub, clique em Code → HTTPS para obter o link.

No GitLab ou BitBucket: vá até o repositório desejado → clique em Código/Clonar → Clonar com HTTPS.

Obter link e token no BitBucket

Há duas maneiras de obter o token e o link no BitBucket.

Método 1.

1. Vá em Configurações pessoais do Bitbucket → Senha de aplicativo.

2. Defina um nome (Rótulo) e permissões; permissões de leitura são suficientes.

3. Clique em Criar.

4. Copie a senha e cole no campo Senha ou token na dashboard da Hostman.

5. Vá até o repositório e clique em Clonar. Copie tudo após git clone e cole no campo URL do repositório.

6. Copie a parte do link entre https:// e @ e cole no campo Nome de usuário.

Método 2.

1. Vá em Configurações → Configurações do repositório → Token de acesso → Criar Token de Acesso ao Repositório.

2. Defina o nome e as permissões (Escopos). Permissão de leitura é suficiente.

3. Copie o valor do campo Seu Token de Acesso ao Repositório e cole no campo Senha ou token da dashboard da Hostman.

4. Use como link do repositório a URL do campo Como usar este token com seu repositório Git. Copie tudo após git clone e cole no campo URL do repositório na Hostman.

Obter token no GitHub

Você não poderá conectar um repositório do GitHub usando apenas a senha da conta — é necessário gerar um token.

Para gerar um token no GitHub:

1. Acesse Configurações → Configurações do desenvolvedor → Tokens de acesso pessoal → Tokens → Gerar token de acesso pessoal.

2. Defina o nome, validade e permissões do token. Para acessar repositórios privados, marque a opção repo.

3. Clique em Gerar token.

4. Copie o token e cole no campo Senha ou token da dashboard da Hostman.

Obter token no GitLab

Para conectar repositórios do GitLab, é possível usar sua senha ou um token gerado nas configurações da conta GitLab.

1. Acesse Preferências → Tokens de Acesso.

2. Crie um novo token informando nome, validade e permissões. Permissões de leitura para repositórios são suficientes.

3. Clique em Criar token de acesso pessoal.

4. Copie o token e cole no campo Senha ou token na dashboard da Hostman.

Remover repositórios conectados

Qualquer repositório adicionado pode ser desvinculado da App Platform.

Se você desvincular um repositório, os deploys (automáticos e manuais) de todas as aplicações criadas a partir dele deixarão de funcionar.

1. Acesse a seção Plataforma de apps e clique em Criar aplicativo.

2. Na etapa Repositório, clique na lista suspensa de repositórios e depois em Excluir ao lado do que deseja remover.

3. Confirme a ação.

A App Platform não mostra o repositório necessário

Se sua conta do GitHub, GitLab ou Bitbucket estiver conectada à App Platform, mas o repositório necessário não for exibido no painel da Hostman, pode haver duas causas:

• Você adicionou o repositório após ter feito login na conta do GitHub, GitLab ou Bitbucket na App Platform.

• Você autorizou acesso apenas a alguns repositórios, e o necessário não está entre eles.

Para corrigir:

1. Acesse a seção Plataforma de apps e clique em Criar aplicativo.

2. Na etapa Repositório, clique em Adicionar conta.

3. Escolha a plataforma.

4. Faça login, se necessário.

5. Selecione o repositório desejado e salve as alterações.

Os repositórios conectados aparecerão no painel da Hostman e você poderá escolher o que precisa.