Conceitos da plataforma
Esta página reúne o vocabulário usado no console, na CLI, na API e no restante da documentação. Leia antes de criar o primeiro projeto: a maior parte das decisões de configuração e cobrança depende destes conceitos.
Conta, organização e permissões
Conta
A conta identifica uma pessoa. Ela tem e-mail verificado, senha, autenticação em dois fatores opcional e, se você quiser publicar a partir de repositórios, uma conexão com o GitHub. Veja Configurações de conta.
Organização
A organização é o espaço onde projetos, cobrança, crédito, membros e API keys vivem. Uma mesma conta pode participar de várias organizações e alternar entre elas no console. Todo projeto pertence a exatamente uma organização. Veja Organizações.
Papéis e permissões
Cada membro recebe um papel (owner, assistant ou member) e, quando necessário, permissões granulares por recurso, como um projeto específico, bancos de dados ou cobrança. O mesmo modelo de permissões vale para pessoas e para API keys. Veja Permissões granulares.
API key da organização
Chave usada pela API, pela CLI, pela GitHub Action e por agentes via MCP. Ela pertence à organização, recebe apenas os scopes que você conceder e pode ser revogada a qualquer momento. Veja API keys.
Projetos
Projeto
Projeto é a unidade que você cria, configura, monitora e paga. Cada projeto tem um tipo, um plano, um modelo de pagamento e um ID único usado pela CLI e pela API.
Tipos de projeto
| Tipo | Para que serve | Onde aprender |
|---|---|---|
| HTTP | Sites, APIs, workers e aplicações em geral | Deploy |
| PostgreSQL / MariaDB | Banco relacional gerenciado | Banco de Dados |
| Chave-Valor, Cache e Filas | Valkey gerenciado para estado, cache e mensageria | Serviços gerenciados |
| Analytics | ClickHouse gerenciado para consultas analíticas | Analytics |
Origem do projeto HTTP
Um projeto HTTP é publicado a partir de uma de duas origens, escolhida na criação:
- Repositório GitHub: a Zenifra faz o build do código (Node.js ou Python) a partir de uma branch. Veja Implantação via GitHub.
- Imagem OCI: você entrega uma imagem pronta de um registry público ou privado. Veja Deploy via imagem OCI.
A origem não pode ser trocada depois da criação.
Template
Um template descreve uma aplicação pronta (imagem, porta, variáveis e, opcionalmente, um banco) para ser implantada com poucos cliques. Veja Templates.
Ambiente de preview
Cópia temporária de um projeto HTTP criada para um pull request ou para uma chave de preview. Ele herda a configuração do projeto principal e expira automaticamente. Veja Ambientes de Preview.
Capacidade e execução
Plano
O plano define CPU, memória, armazenamento incluído e recursos extras, como subdomínio personalizado, métricas avançadas, health checks, auto-scaling e controle de acesso por IP. O console sempre mostra os recursos do plano antes da confirmação.
Instância
Instância é uma cópia em execução da sua aplicação ou banco. Projetos HTTP podem rodar de 1 a 10 instâncias fixas, ou variar automaticamente com auto-scaling. Mais instâncias aumentam capacidade e disponibilidade, e também o custo.
Exposição
Projetos HTTP são públicos (recebem endereço *.clients.zenifra.com e aceitam domínios próprios) ou privados (sem rota pública, ideais para workers e automações). Veja Rede e acesso.
Variáveis de ambiente e armazenamento
Variáveis de ambiente guardam configuração e segredos fora do código. O armazenamento persistente mantém arquivos entre reinícios e novas versões.
Cobrança
Modelo de pagamento
Cada projeto é cobrado por hora, por mês ou por ano. O modelo por hora oferece mais flexibilidade para mudar plano e armazenamento; os modelos mensal e anual reservam a capacidade pelo período contratado. Veja Modelos de pagamento.
Crédito
O crédito é o saldo pré-pago da organização, usado inclusive para o consumo de IA. Veja Gestão de pagamentos.