Publique sua primeira aplicação no Hangar.
Este guia leva um serviço web do repositório GitHub à primeira publicação. Ao terminar, você terá uma aplicação configurada e saberá onde acompanhar o deploy e acessar seus logs.
Antes de começar
Tenha uma conta no Hangar, um workspace com capacidade disponível e acesso autorizado ao repositório GitHub. A contratação informa o plano e, quando houver, as condições do trial.
- Um serviço web com os comandos de build e início conhecidos.
- Uma porta de execução e configuração para aceitar conexões externas.
- As variáveis necessárias à aplicação, sem segredos no repositório.
- Um Dockerfile, se optar por controlar o build em vez de usar Railpack.
1. Crie o projeto e escolha o ambiente
Selecione o workspace e abra Projetos. Use Criar projeto, dê um nome ao produto e abra o projeto criado. Selecione o ambiente em que a aplicação vai executar.
O workspace reúne plano e cobrança. O projeto reúne os ambientes; cada ambiente contém aplicações, bancos e volumes. Confira esse contexto antes de criar o serviço.
2. Conecte o repositório e configure a aplicação
No ambiente, abra o fluxo Criar aplicação. Conecte a conta GitHub autorizada, selecione repositório e branch e confira o diretório do projeto quando o código estiver em uma subpasta.
| Campo | Como escolher |
|---|---|
| Build | Railpack para detectar a stack, ou Dockerfile com o caminho do arquivo. |
| Comandos | Use os comandos que compilam e iniciam o projeto. Revise o resultado da detecção. |
| Porta | Use a mesma porta em que seu servidor escuta. |
| Variáveis | Configure ambiente, conexões e chaves necessárias à execução. |
| Recursos | Escolha CPU, memória e réplicas que caibam no workspace. |
Use credenciais de teste ao validar pela primeira vez. Homologação deve apontar para dados de homologação.
3. Publique e acompanhe o resultado
Revise a configuração e conclua Criar aplicação. Abra o serviço criado e acompanhe a publicação na área Deploys. Se precisar iniciar uma publicação manual, use Deploy.
Acompanhe build, eventos e logs até verificar o resultado. Uma solicitação aceita ainda não significa que a aplicação está pronta. Se houver falha, corrija a causa indicada e publique novamente.
4. Configure o acesso e teste a aplicação
Na área Domínios, configure um endereço para a aplicação e confira sua porta. Para um domínio próprio, siga os registros DNS apresentados no painel. Aguarde a verificação e confira o HTTPS.
Abra o endereço e teste uma rota conhecida. Verifique também uma operação representativa, como login ou leitura de dados, para confirmar que as variáveis e dependências estão corretas.
5. Configure os próximos deploys
Para publicar a cada push, ative Deploy automático na configuração de deploy e confirme a branch conectada. Caso prefira controlar o momento da publicação, mantenha o deploy manual.
Depois de cada mudança, consulte o resultado e os logs. Use testes e revisão de código no repositório antes de enviar mudanças à branch de produção.
Pronto para publicar?
Abra sua conta e comece criando o projeto da aplicação.