Início rápido
Nesta página você cria um projeto, aponta um repositório e coloca a aplicação no ar com endereço público e HTTPS.
Antes de começar
- Acesso ao console em console.zero.nnumbers.com.br e participação em pelo menos uma organização.
- Um repositório no GitHub, no GitLab ou no Bitbucket com um
Dockerfilena pasta que você vai publicar. - A aplicação precisa escutar em
0.0.0.0, na porta indicada pela variávelPORTdo ambiente (padrão 8080). Ver Como a aplicação roda.
Repositório público não precisa de credencial. Para um repositório privado, informe um token de acesso em Origem, no projeto, logo depois de criá-lo — e publique de novo se a primeira publicação não conseguir buscar o código. Ver A origem do projeto.
Passo a passo
1. Entre e escolha a organização
Abra o console. Se você participa de mais de uma organização, escolha qual delas — a organização decide o significado de tudo o que vem depois: projetos, endereços, medição e acesso.
2. Crie o projeto
Em Projetos, clique em Criar projeto e preencha:
| Campo | O que informar |
|---|---|
| Nome do projeto | Letras minúsculas, números e hífen. Ele aparece no endereço público |
| Domínio | O domínio da plataforma, ou uma zona própria já ativa |
| Endereço | Opcional. Em branco, a plataforma compõe um a partir do nome |
| Provedor | GitHub, GitLab ou Bitbucket. Deduzido do endereço quando ele diz o host |
| Endereço do repositório | A URL completa (https://github.com/dono/repo), o endereço SSH ou dono/repo |
| Branch ou tag | De onde a primeira versão será publicada |
| Pasta dentro do repositório | Opcional. Em branco, a raiz. Num monorepo, a pasta onde está o Dockerfile |
O ambiente Production nasce junto com o projeto. Você não precisa criá-lo.
3. Confirme
Clique em Criar e publicar. A publicação começa imediatamente e o console leva você para a página do projeto.
4. Acompanhe a publicação
A publicação percorre cinco estados visíveis:
Preparando → Construindo → Publicando → Verificando → Online
A publicação aparece na hora em Deployments, na seção Publicação em andamento. Ver detalhes mostra as etapas e a narração da plataforma ao vivo. Depois que a versão é registrada, o log do build do Deployment traz a saída do construtor da imagem — é o que responde "por que quebrou" quando algo dá errado na construção.
Se a aplicação não ficar pronta, a publicação falha com o motivo e a ação, e a linha do tempo conta o que aconteceu.
5. Abra o endereço
Quando o estado chega a Online, o endereço público do projeto responde. Ele fica visível na página do projeto e em Domínios.
Abra o endereço. A publicação mostra 3 de 4 etapas até a primeira requisição real chegar e ser respondida pela aplicação — a sua visita é essa prova. A partir daí, 4 de 4 e Recebendo tráfego. Ver Até onde foi confirmado.
O que acontece depois
- Toda nova publicação cria uma versão nova. A anterior continua no histórico, inteira.
- A versão anterior continua atendendo até a nova responder. Uma publicação que falha não derruba o que estava no ar.
- Você pode restaurar uma versão anterior a qualquer momento — é troca de ponteiro, não reconstrução.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| A publicação falha em Construindo | Não há Dockerfile na pasta publicada | Confira o campo "Pasta dentro do repositório" e abra o log do build |
| "A aplicação iniciou, mas não respondeu" | A aplicação não escuta em 0.0.0.0 na porta da variável PORT | Leia a porta de PORT e escute em 0.0.0.0 |
| "A aplicação parou logo depois de iniciar" | Normalmente variável de ambiente ausente ou dependência não configurada | Veja as últimas linhas em Logs → Runtime |
| O endereço recusado no formulário | O endereço já está reservado por outro projeto | Escolha outro, ou use uma sugestão do próprio formulário |
| Repositório não encontrado | Repositório privado sem token de acesso | Informe um token em Origem, no projeto, e publique de novo |
Mais casos em Problemas comuns.
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.