Endereço do projeto

Todo projeto recebe um endereço público com HTTPS. Você não configura certificado, não abre porta e não aponta DNS: o endereço nasce com o projeto.

Como o endereço é composto

Situação	Forma do endereço
Serviço web principal em Production	<projeto>-<organização>
Serviço web principal em outro ambiente	<projeto>-<ambiente>-<organização>
Serviço web adicional em Production	<serviço>-<projeto>-<organização>
Serviço web adicional em outro ambiente	<serviço>-<projeto>-<ambiente>-<organização>

O endereço completo é esse rótulo mais o domínio: o da plataforma, ou o domínio próprio da sua organização.

O ambiente entra no endereço dos ambientes não produtivos para que o mesmo serviço em ambientes diferentes não colapse em um endereço só. Production usa a forma curta porque é o endereço que você divulga.

Escolher o endereço

Na criação do projeto, e depois em Domínios, no projeto, você pode escolher o rótulo. Três perguntas independentes, que o formulário faz por você:

• Este texto pode virar endereço? — o rótulo tem regras: minúsculas, números e hífen, até 63 caracteres no rótulo inteiro.
• Está livre? — a conferência é 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á tomado.
• Que alternativas existem? — o formulário sugere endereços livres a partir do nome que você digitou.

Digitar não reserva nada. A reserva acontece quando você confirma.

Escolha a zona antes do endereço

Se você vai publicar sob o domínio da sua empresa, escolha a zona antes de conferir o endereço: conferir loja sem saber sob qual domínio confere a coisa errada. loja pode estar livre em um domínio e ocupado no outro.

Nomes reservados

Alguns rótulos pertencem à plataforma — console, api, auth, www, login, entre outros — e são recusados. Isso vale também sob domínio próprio.

Trocar o endereço

Um serviço tem um endereço público. Trocar não acumula endereços antigos: o anterior sai de uso e permanece reservado à sua organização.

1. Em Domínios, no projeto, escreva o endereço novo e escolha Usar este.
2. Leia a confirmação e clique em Trocar o endereço:

Trocar para novo endereço? O endereço atual deixa de responder assim que o novo estiver no ar e permanece reservado à sua organização — nenhuma outra pode usá-lo. Links divulgados, callbacks de login (OAuth) e webhooks que usam o endereço atual precisam ser atualizados.

Ao confirmar, a plataforma republica a versão que já está no ar com o endereço novo, sem reconstruir. A publicação aparece em Deployments como Troca de endereço. Enquanto ela corre, o anterior aparece como Deixa de responder quando o endereço novo estiver no ar.

Situação	O que acontece com o endereço anterior
A publicação com o endereço novo fica pronta	Deixa de responder no mesmo instante e fica reservado à sua organização. Nunca há intervalo sem endereço
A publicação falha	Continua respondendo. A próxima publicação que ficar pronta conclui a troca
O projeto nunca publicou	Sai de uso na hora, reservado à sua organização: não há o que republicar
Você volta ao nome anterior antes de a publicação terminar	A troca é desfeita

O endereço anterior continua da sua organização

Nenhuma outra organização pode escolher o endereço anterior: o que ainda aponta para ele — links, callbacks de login (OAuth), webhooks — nunca vai parar na aplicação de outra empresa. Um projeto da sua organização pode voltar a usá-lo quando quiser. Mesmo assim, atualize o que aponta para o endereço antigo: ele deixa de responder.

O identificador interno do projeto não muda quando o endereço muda.

Até onde o endereço foi confirmado

Na página Domínios do projeto, cada endereço mostra dois indicadores:

Indicador	O que significa
HTTPS	Confirmado ou ainda não confirmado
Roteamento	Confirmado ou ainda não confirmado

Eles registram o que a publicação provou, não uma sondagem feita agora. Por isso nunca dizem "erro": ausência de prova não é prova de falha, e um endereço recém-publicado que aparecesse em vermelho ensinaria a ignorar o vermelho de verdade.

Erros comuns

Sintoma	Causa	O que fazer
"Este endereço já está em uso"	O endereço final está reservado	Escolha outro ou use uma sugestão
O endereço aparece mas não responde	A primeira publicação ainda não terminou	Acompanhe em Deployments
O endereço antigo parou de responder	Houve uma troca de endereço, e a publicação com o novo ficou pronta	É o esperado: use o endereço novo e atualize links, callbacks e webhooks
Endereço recusado sem motivo aparente	Rótulo reservado pela plataforma	Escolha outro nome
Endereço maior que o permitido	O rótulo inteiro passa de 63 caracteres	Encurte o nome do projeto

Próximos passos

• Domínio próprio
• Delegar o domínio no seu provedor
• Criar e gerenciar projetos