Templates na Zenifra

Templates são pontos de partida reutilizáveis para aplicações HTTP. Um template reúne uma aplicação, a porta que ela usa, a pasta de dados persistentes quando aplicável, as variáveis esperadas e uma configuração inicial de capacidade. Assim, uma organização pode transformar uma configuração validada em uma nova implantação com menos decisões repetidas.

O catálogo inclui Templates para aplicações comuns do dia a dia, como n8n, Metabase e WordPress, além de outras opções publicadas pela Zenifra, por parceiros oficiais e pela comunidade. Quando todas as informações necessárias já estão preparadas, basta selecionar Implantar e confirmar: a Zenifra cria uma aplicação pronta e funcional com um clique.

O recurso está disponível no menu Templates do console. A conta pessoal usa sua organização pessoal; contas empresariais podem alternar entre organizações antes de consultar ou criar recursos.

O que aparece no catálogo

O catálogo possui duas áreas:

• Templates da organização: templates públicos e privados pertencentes à organização ativa, ordenados por atualização;
• Templates públicos: templates publicados por organizações da Zenifra, com as opções Novos, Mais usados e Oficiais.

Um card mostra nome, resumo, organização autora, tags, revisão, visibilidade e uso. A navegação pública exige uma sessão autenticada, mas não exige permissão de criação. Isso permite que uma pessoa conheça as opções antes de pedir acesso para implantar.

Templates públicos não significam que o projeto original ou os dados da organização autora ficam acessíveis. O catálogo compartilha apenas as informações preparadas pelo autor. Cada implantação cria um projeto separado na organização consumidora.

Templates Oficiais

O selo Template Oficial identifica Templates publicados pela Zenifra ou por organizações parceiras reconhecidas pela plataforma. A classificação pertence à organização autora e aparece automaticamente em seus Templates. Use Oficiais no catálogo público para consultar somente esses publicadores.

O selo indica a origem oficial do Template, mas não substitui a revisão das configurações, variáveis, capacidade e cobrança para o seu projeto.

O que um template define

O autor configura uma referência pública de aplicação, a porta HTTP, a pasta persistente e as variáveis que o novo projeto deverá preencher. Também define sugestões para plano, cobrança, exposição, quantidade de instâncias, persistência, capacidade e auto-scaling.

Essas sugestões ajudam a começar, mas continuam editáveis durante a implantação. O nome do projeto, a descrição, o plano, o modo de cobrança, a exposição, a capacidade, a persistência e a escala pertencem ao novo projeto. Uma alteração posterior no template não altera projetos que já foram criados.

Templates da v1 atendem aplicações HTTP baseadas em referências públicas nos registros suportados pela Zenifra. Bancos, stacks com vários recursos, importação de projetos existentes e imagens privadas não fazem parte deste primeiro fluxo.

Segurança e revisão

Todo template nasce privado. O autor pode revisar o conteúdo e publicar quando estiver pronto. Variáveis secretas nunca recebem valor padrão e os valores sensíveis são informados somente no formulário de implantação. Não coloque tokens, senhas ou chaves na descrição, nas tags, na referência da aplicação ou em exemplos.

Cada alteração de conteúdo cria uma nova revisão. O console e a API confirmam a revisão escolhida antes de atualizar ou implantar. Isso evita que alguém publique uma configuração antiga sem perceber. Se o template for removido ou ficar indisponível, uma nova implantação será recusada; projetos já existentes permanecem independentes.

Próximos passos

• Criar e publicar um template
• Implantar uma aplicação por template
• Entender organizações e permissões
• Consultar a referência da API de Templates
• Abrir o catálogo no console

FAQ

Quais aplicações encontro no catálogo?

O catálogo inclui Templates como n8n, Metabase e WordPress, além de outras aplicações úteis no dia a dia. Novos Templates podem ser publicados pela Zenifra, por parceiros oficiais e por outras organizações.

Todo Template pode ser implantado com um clique?

A implantação com um clique fica disponível quando o Template já contém todas as informações necessárias. Se a aplicação exigir um segredo ou outro valor obrigatório que não possa ser sugerido, use Personalizar para preencher esse dado antes de criar o projeto.

Templates atualizam projetos automaticamente?

Não. O projeto recebe a revisão usada no momento da implantação e segue seu próprio ciclo de vida.

Posso usar um template sem poder criar projetos?

Sim. Pessoas sem project.create podem navegar pelo catálogo, visualizar templates acessíveis e consultar os detalhes. A ação de implantação ficará bloqueada até que a organização conceda a permissão necessária.

Um template privado pode ser compartilhado com outra organização?

Não. Para aparecer para outras organizações, o template precisa ser publicado. A publicação não expõe dados privados nem concede acesso administrativo à organização autora.