Projetos e ambientes
O projeto é a aplicação
No Zero, projeto e "aplicação" são a mesma coisa. Não existe um objeto "aplicação" separado que você precise criar dentro de um projeto: o projeto tem o endereço público, o histórico de versões, as variáveis e as configurações.
Isso tem uma consequência prática: quando você cria o projeto, já informa de onde vem o código. Não há uma segunda etapa "agora crie a aplicação".
O repositório é do projeto — uma origem por projeto. Todos os serviços do projeto publicam do mesmo repositório, e cada um escolhe só a pasta e a referência. Para publicar de outro repositório, crie outro projeto.
O ambiente
Um environment é o alvo de uma publicação e o escopo de uma configuração. Todo projeto nasce com Production — você não cria ambiente antes de publicar pela primeira vez.
O ambiente é uma fronteira real, não um rótulo:
| O que o ambiente separa | Consequência |
|---|---|
| Espaço de execução | O que roda em um ambiente não enxerga o que roda no outro |
| Cota de recursos | Um ambiente não consome a capacidade do outro |
| Rede | Fechada por padrão; o que entra e sai é explícito |
| Configuração | Variáveis e secrets podem valer só naquele ambiente |
| Alcance de falha | Um problema fica contido no ambiente onde aconteceu |
O nome interno do ambiente nunca aparece na interface nem no endereço público. Ele é implementação, e mostrar identificador interno em endereço é o tipo de detalhe que envelhece mal.
Um projeto, vários serviços
Dentro de um ambiente, o projeto pode ter mais de um serviço — por exemplo, um serviço web que responde às pessoas e um processo de fundo que consome uma fila.
Com um serviço só, a camada não aparece: o console mostra o serviço direto. Com mais de um, a seção Serviços ganha conteúdo próprio. Ver Serviços.
Endereço e nome
O nome do projeto participa do endereço público. Por isso ele aceita apenas letras minúsculas, números e hífen — as mesmas regras que um endereço na internet admite.
- Production usa a forma curta:
<projeto>-<organização>. É o endereço que você divulga. - Outros ambientes carregam o ambiente no endereço:
<projeto>-<ambiente>-<organização>. - Um projeto com mais de um serviço web recebe
<serviço>-<projeto>-<organização>para os demais; o projeto continua tendo um endereço canônico.
A unicidade é sobre o endereço final, não sobre o nome dentro da organização: um nome livre na sua organização pode produzir um endereço já ocupado, e é o endereço que decide. O formulário confere isso enquanto você digita.
Cada serviço web tem um endereço público. Trocá-lo, em Domínios, não acumula endereços: o anterior deixa de responder assim que o novo estiver no ar e permanece reservado à sua organização. Ver Endereço do projeto.
Excluir
Excluir um projeto encerra tudo o que roda nele: ambientes e serviços saem do ar, publicações na fila são canceladas, e a origem e as credenciais dela são revogadas. O projeto some de toda leitura e o nome do projeto fica livre; o endereço público permanece reservado à sua organização. O histórico continua registrado — auditoria, operações, deployments e versões. É uma operação destrutiva: o console pede que você digite o nome do projeto. Ver Excluir o projeto.
Uma zona de domínio próprio em uso por um projeto recusa ser removida enquanto o projeto existir — a ordem correta é excluir o projeto primeiro.
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.