Encontre um template na galeria
A galeria lista os templates disponíveis para você. No dashboard, abra Templates na barra lateral, que tem três abas: Catalog, My templates (seus templates privados) e In use (os apps e stacks que você criou a partir de templates, com o selo New version available quando há atualização).- Busca e categorias: automação, agentes de IA, bots, APIs, CMS, monitoramento, projetos iniciais, bancos de dados e outros.
- Fits my plan: mostra apenas o que a sua conta pode usar agora, com sua memória livre e suas vagas de imagem livres em cada card. Um template que não cabe explica o motivo.
- Ordenação: recomendados, mais usados, novos ou de A a Z.
- Selos: Vertra, Community, Private e From the workspace. Veja as três origens.
Passo a passo no assistente
1
Nome e destino
Dê um nome ao app (ou à stack, quando o template tem vários serviços) e escolha o workspace e a pasta.
2
As perguntas do template
As respostas aparecem em ordem, e algumas perguntas só aparecem dependendo das respostas anteriores. Uma pergunta pode ser texto, número, sim ou não, uma escolha ou um segredo. As perguntas que a plataforma gera (como uma chave de criptografia) são preenchidas para você.
3
Memória de cada serviço
Escolha a memória de cada serviço dentro do que o template permite. O assistente mostra “precisa de X, você tem Y livre”.
4
Subdomínio
Se um serviço tem web, escolha um subdomínio ou deixe aleatório.
5
Resumo
Revise o que será criado, o plano exigido e as vagas de imagem.
6
Criar
Acompanhe o progresso por etapa: validação, bancos de dados, imagens, apps, variáveis, certificados, início e verificação de saúde.
TEMPLATE_DEPLOY_IN_PROGRESS.
O que é criado
Os bancos de dados são bancos de dados gerenciados comuns, cada um com sua própria memória descontada do seu plano. As variáveis de conexão e os certificados são injetados para você: veja Conectar apps a bancos de dados em uma stack. Tudo o que é criado a partir de um template fica vinculado à versão de origem, então você pode atualizar depois.
Saídas e segredos exibidos uma única vez
Quando o job termina, o assistente mostra as saídas do template: o endereço do app, os próximos passos e as credenciais geradas. Uma saída marcada como segredo exibido uma única vez aparece na primeira leitura do job concluído e some depois. Copie-a antes de sair da página. O mesmo vale para a CLI, o servidor MCP e a API.Se o deploy falhar
O job desfaz tudo o que criou, em ordem inversa. Antes de apagar um app ou um banco de dados, ele tira um snapshot de segurança, porque o banco de dados pode já ter aceitado conexões e o/app do app pode ter mudado. O erro traz um código estável e o passo que falhou, por exemplo TEMPLATE_RAM_INSUFFICIENT no passo validate. Veja a referência de erros para causas e correções.
Use um template pela CLI, MCP ou API
- CLI
- MCP
- API
deploy faz as perguntas do template no terminal (segredos são digitados sem eco), acompanha os passos e imprime as saídas no final. Responda antes com --set <question>=<value>; --yes, --json ou uma sessão sem terminal não perguntam nada e falham listando todas as respostas que faltam. --service <service>.ram=2048 define a memória por serviço, e --share <link> faz deploy a partir de um link de compartilhamento. Veja a referência da CLI.Relacionados
Stacks
O que um template de vários serviços cria.
Atualizar e fazer rollback
Novas versões de um template.