Fazer 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

Abra a aba Backend e selecione o framework usado no seu app.

Etapa 2. Conectar o repositório

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

1. Escolha a branch que será usada no deploy.
2. 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

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

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

Nesta etapa, você pode configurar:

• o comando de build;
• as dependências;
• o comando de inicialização;
• 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.

Todas essas configurações podem ser alteradas depois, com um novo deploy.

Etapa 7. Informações do app

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

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.