Deploy de apps de backend
Para fazer deploy de um app de backend na Hostman, vá até a seção Plataforma de Apps e clique em Criar aplicativo.
Etapa 1. Escolher o tipo de aplicação Copiar link
Abra a aba Backend e selecione o framework usado no seu app.
Etapa 2. Conectar o repositório Copiar link
Você pode conectar um repositório de duas formas:
- Via GitHub, GitLab ou Bitbucket. Clique no nome da plataforma, faça login e escolha o repositório desejado. Se você já estiver logada, a Hostman mostrará automaticamente os repositórios disponíveis.
- Via URL. Clique em Conectar repositório via URL e informe a URL Git do repositório. Se o repositório for privado, inclua também os dados de acesso.
Saiba mais sobre como conectar repositórios aqui.
Etapa 3. Selecionar branch e commit Copiar link
- Escolha a branch que será usada no deploy.
- Por padrão, a opção Compilação pelo último commit executado vem ativada. Nesse modo, a Plataforma de Apps faz o deploy do commit mais recente e depois reconstrói automaticamente o app sempre que novos commits forem enviados para o repositório. Se quiser, você pode desativar o deploy automático mais tarde.
Caso prefira escolher um commit específico manualmente, basta desativar essa opção.
Etapa 4. Escolher localização e configuração do servidor Copiar link
O app será executado em um servidor em nuvem dedicado. Selecione a região onde o servidor ficará e a configuração desejada.
Você pode fazer upgrade do servidor a qualquer momento, mas não é possível fazer downgrade.
Etapa 5. Configurar a rede privada Copiar link
Aqui você pode adicionar o app a uma rede privada e definir o endereço IP que ele vai utilizar.
Atenção: depois do deploy, não será possível alterar a rede privada.
Etapa 6. Configurar as opções de build Copiar link
Nesta etapa, você pode configurar:
- o comando de build;
- as dependências;
- o comando de inicialização;
- o diretório do projeto;
- o caminho do healthcheck;
- as variáveis de ambiente.
Na maioria dos casos, a Plataforma de Apps detecta automaticamente o comando de start do projeto, então você pode deixar essa configuração como está.
Se precisar de pacotes adicionais do sistema (por exemplo, para compilar o projeto), informe-os na seção Dependências. Eles serão passados diretamente para o comando apt install. Você pode adicionar várias dependências separando-as por espaço.
Se os arquivos do seu projeto estiverem localizados em um subdiretório em vez da raiz do repositório, informe o caminho para esse diretório no campo Caminho do diretório do projeto.
Quando um caminho é especificado:
- O diretório de trabalho passa a ser a pasta especificada.
- As dependências são instaladas a partir dos arquivos do projeto localizados nessa pasta.
- Os comandos de build e de execução também são executados a partir dessa pasta.
Todas essas configurações podem ser alteradas depois, com um novo deploy.
Etapa 7. Informações do app Copiar link
Defina o nome e um comentário para o app, que serão exibidos no Dashboard da Hostman.
Você também pode escolher em qual projeto o app será incluído.
Essas informações podem ser editadas posteriormente.
Etapa 8. Fazer deploy Copiar link
Clique em Pedido. Assim que o processo começar, o log de deploy ficará disponível na aba Implantar.
O log mostra todas as etapas do processo e ajuda a identificar possíveis problemas. Se algo der errado (por exemplo, por erro no código), a causa será indicada diretamente no log.
No primeiro deploy, a instalação do servidor pode levar alguns minutos. Quando tudo estiver pronto, o status do app será atualizado e essa informação também aparecerá no log.
Pronto!
Você pode encontrar o IP do app e o domínio técnico associado na aba Dashboard. O app ficará disponível na porta 443; a porta 80 também estará aberta.
Para conectar um domínio próprio ao app, siga este guia.
A partir desse momento, a Plataforma de Apps passa a monitorar o repositório e, se o deploy automático estiver ativado, o projeto será reconstruído automaticamente sempre que houver novas alterações.