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 Code/Clone → Clone with 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 Personal Bitbucket settings → App password.

Seção "Settings" na interface do Bitbucket

2. Defina um nome (Label) e permissões; permissões de Read são suficientes.

Seção "App passwords" na interface do Bitbucket

3. Clique em Create.
4. Copie a senha e cole no campo Password or token na dashboard da Hostman.
5. Vá até o repositório e clique em Clone. Copie tudo após git clone e cole no campo Repository URL.

Janela "Clone this repository" na interface do Bitbucket

6. Copie a parte do link entre https:// e @ e cole no campo Username.

Método 2.

1. Vá em Settings → Repository settings → Access token → Create Repository Access Token.
2. Defina o nome e as permissões (Scopes). Permissão de leitura é suficiente.

Criação de token na interface do Bitbucket

3. Copie o valor do campo Seu Your Repository Access Token e cole no campo Password or token da dashboard da Hostman.

Visualização do token na interface do Bitbucket

4. Use como link do repositório a URL do campo How to use this token with your Git repository. Copie tudo após git clone e cole no campo Repository URL na Hostman.

Visualização do token na interface do Bitbucket

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 Settings → Developer Settings → Personal access tokens → Tokens → Generate a personal access token.
2. Defina o nome, validade e permissões do token. Para acessar repositórios privados, marque a opção repo.

Geração de token pessoal na interface do GitHub

3. Clique em Generate token.
4. Copie o token e cole no campo Password or 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 Preferences → Access Tokens.
2. Crie um novo token informando nome, validade e permissões. Permissões de leitura para repositórios são suficientes.
3. Clique em Create personal access token.
4. Copie o token e cole no campo Password or 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.