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 atendem aplicações HTTP baseadas em referências públicas nos registros suportados pela Zenifra. Opcionalmente, o autor pode declarar que a aplicação precisa de banco de dados, selecionar mecanismos compatíveis no catálogo, recomendar uma configuração para cada um e vincular variáveis declaradas aos dados de conexão. Quando a pessoa consumidora escolher essa opção, a Zenifra cria o banco selecionado junto com a aplicação.

Depois da criação, banco e aplicação continuam sendo projetos independentes. Remover um deles não remove o outro, e renovar a senha do banco não altera automaticamente as variáveis da aplicação. Importar um banco já existente e usar imagens privadas continuam fora deste 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. Os vínculos de banco guardam apenas o nome da variável e o tipo de dado de conexão; nunca guardam o valor da conexã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.

Um Template pode criar um banco junto?

Sim. Quando o autor declara uma dependência de banco, a página de implantação oferece criar um banco compatível junto com a aplicação. O mecanismo e a configuração recomendados pelo autor já vêm selecionados, mas a pessoa consumidora pode escolher outra opção compatível. As variáveis de conexão declaradas pelo autor são preenchidas automaticamente e os valores sensíveis permanecem mascarados.

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.