Glossário

Termos que aparecem no console, na CLI, na API e nesta documentação, em ordem alfabética. Para uma visão de como eles se relacionam, veja Conceitos da plataforma.

A–C

API Key: Chave da organização usada pela API, pela CLI e por automações. Recebe apenas os scopes que você escolher. Veja API keys.

Armazenamento persistente: Diretório da aplicação que mantém os arquivos entre reinícios e publicações. Sem ele, o disco da instância é efêmero. Veja Armazenamento.

Auto-scaling: Ajuste automático da quantidade de instâncias conforme o uso. Veja Escala.

Build: Etapa que prepara a aplicação para rodar: instala dependências e executa pre-build e build. O resultado aparece em Logs de Build.

Comando start: Comando que inicia o processo principal da aplicação. É obrigatório em projetos GitHub.

Console: Interface web em console.zenifra.com para criar e administrar projetos.

Crédito: Saldo pré-pago da organização usado para pagar o consumo. Veja Pagamentos.

D–I

Deploy (publicação): Colocar uma nova versão da aplicação no ar. Pode ser manual, por push, por tag ou por release. Veja Implantação.

Domínio personalizado: Seu próprio domínio, como app.suaempresa.com.br, apontado para um projeto, com HTTPS gerenciado. Veja Domínios.

Efêmero: Que não sobrevive a um reinício. Arquivos gravados fora do armazenamento persistente são efêmeros.

Forma de atualização: Regra que define o que publica uma nova versão de um projeto GitHub: Manual, Automático por branch, Por Tag ou Por Release.

Health check: Verificação periódica de uma rota GET da aplicação. Se falhar, a instância é reiniciada. Veja Health checks.

Imagem OCI: Pacote de container no padrão aberto usado pelo Docker. Permite publicar qualquer linguagem. Veja Deploy via OCI.

Instância: Uma cópia da aplicação em execução. Mais instâncias significam mais capacidade e tolerância a falhas.

L–P

Logs de Build: Histórico de cada build, com a etapa e o motivo de falhas.

Logs da aplicação: Tudo o que a aplicação escreve em stdout e stderr durante a execução. Veja Observabilidade.

MCP: Protocolo que permite a agentes de IA operar a Zenifra com as permissões de uma API Key. Veja MCP.

Organização: Espaço que agrupa projetos, membros, cobrança e chaves. Uma conta pode participar de várias. Veja Organizações.

Owner: Papel com acesso total à organização.

Plano: Conjunto de recursos (CPU, memória, armazenamento e funcionalidades) contratado para um projeto. Veja Pagamentos e Limites.

Porta: Campo do projeto que indica em qual porta a aplicação escuta. Precisa ser igual à porta usada no código.

pre-build: Comando opcional executado depois da instalação das dependências e antes da build.

Preview (Ambiente de Preview): Cópia temporária do projeto, geralmente por pull request, com URL própria e TTL. Veja Ambientes de Preview.

Projeto: Unidade publicada na Zenifra: uma aplicação HTTP, um banco ou um serviço gerenciado.

R–Z

Registry: Serviço que armazena imagens OCI, como GitHub Container Registry, Docker Hub ou AWS ECR. Veja Registry privado.

Rollback: Voltar para uma versão anterior. Veja Rollback.

Runtime: Linguagem e versão usadas para construir projetos GitHub: Node.js ou Python. Veja Runtimes.

Scope: Permissão específica, como project.deploy.trigger, concedida a membros e API Keys. Veja Permissões.

Template: Configuração pronta para publicar uma aplicação com poucos cliques, como n8n ou WordPress. Veja Templates.

TTL: Tempo de vida. Em previews, é o prazo até a remoção automática. Em DNS, é por quanto tempo um registro fica em cache.

Variável de ambiente: Par nome e valor entregue à aplicação, usado para configuração e segredos. Veja Variáveis.

Próximos passos

Última atualização em

Nessa página