Aprenda como criar seu primeiro projeto na plataforma Zenifra. Tutorial completo com console, planos, configurações e deploy na cloud.

Como Criar um Projeto na Zenifra via Console

Este tutorial completo vai te ensinar como criar seu primeiro projeto na plataforma PaaS Zenifra, desde o cadastro até o deploy da sua aplicação.

Pré-requisitos

Para criar um projeto na Zenifra, é necessário ter:

Uma conta criada e verificada
Um meio de pagamento cadastrado (cartão de crédito ou saldo em conta)
Login realizado no console

Acessando a Criação de Projeto

No menu lateral do console, clique em Projetos
No canto superior direito, clique no botão com ícone de "+" ou "Criar Projeto"
Você será direcionado para a tela de configuração do novo projeto

Passo 1: Escolher o Tipo de Projeto

A Zenifra oferece diferentes tipos de aplicações para deploy:

Aplicação HTTP

Ideal para:

Aplicações web (React, Vue, Angular)
Servidores HTTP (Nginx, Apache)
APIs REST
Aplicações Node.js, Python, Java, entre outras

Aplicação TCP

Em breve disponível

Ideal para:

Bancos de dados
Sistemas de mensageria
Aplicações que utilizam protocolos TCP puros

Passo 2: Selecionar o Plano

Os planos definem os recursos disponíveis e o preço da sua aplicação. Cada plano oferece diferentes níveis de:

CPU e Memória
Armazenamento
Quantidade máxima de instâncias
Recursos exclusivos (subdomínio personalizado, acesso por IP, etc.)

Modelos de Pagamento

Escolha como deseja pagar pelo seu projeto:

Modelo	Descrição	Ideal para
Por Hora	Cobrança por hora de uso. Pague apenas pelo tempo que sua aplicação ficar ativa.	Projetos com uso intermitente, testes, desenvolvimento
Por Mês	Preço fixo mensal. Instância reservada para você durante 30 dias.	Aplicações que precisam estar sempre disponíveis
Por Ano	Preço anual com desconto. Instância reservada por 364 dias.	Projetos de longo prazo com economia

Dica: No pagamento por hora, se sua aplicação rodar apenas 10 minutos no mês, você paga apenas por 1 hora!

Passo 3: Configurar Informações Básicas

Nome do Projeto

O nome é utilizado para:

Identificar seu projeto no dashboard
Gerar identificadores únicos (ID do projeto)
Criar subdomínios automáticos

Regras do nome:

Mínimo: 6 caracteres
Máximo: 32 caracteres
Apenas letras minúsculas, números e hífens
Exemplo: meu-projeto-web, api-minha-empresa

Descrição

Campo opcional para adicionar informações sobre o projeto. Ajuda a organizar e identificar projetos quando você tem vários.

Passo 4: Configurar a Imagem OCI

A imagem OCI é o modelo que será utilizado para criar sua instância. Você pode usar imagens públicas ou privadas.

Imagem Pública

Imagens que não necessitam de autenticação para download. Exemplos:

docker.io/nginx:1.26-alpine3.19
docker.io/metabase/metabase:v0.50.0
docker.io/wordpress:6.5.3-php8.2-apache

Imagem Privada

Para imagens em registries privados, você precisará configurar autenticação:

Opção 1: AWS ECR

Região AWS onde seu repositório está localizado
Access Key ID e Secret Access Key
ID da sua conta AWS

Opção 2: Usuário e Token

Nome de usuário do registry
Token ou senha de acesso

Importante: Sempre utilize tags específicas (como v1.2.3) em vez de latest. Isso garante que sua aplicação sempre utilizará a mesma versão da imagem.

Passo 5: Configurar Porta e Instâncias

Porta da Aplicação

A porta que sua aplicação escuta internamente. O tráfego externo (HTTP/HTTPS nas portas 80 e 443) será roteado para esta porta.

Portas comuns por tecnologia:

Tecnologia	Porta Padrão
Node.js	3000
Python Flask	5000
Java/Spring	8080
Nginx	80

Quantidade de Instâncias

Número de réplicas da sua aplicação:

1 instância: Ideal para aplicações de baixo tráfego ou testes
2+ instâncias: Alta disponibilidade e balanceamento de carga

Recomendação: Para aplicações em produção, utilize pelo menos 2 instâncias para garantir disponibilidade em caso de falhas.

Passo 6: Variáveis de Ambiente

As variáveis de ambiente (ENVs) são configurações que sua aplicação pode acessar em tempo de execução. São úteis para:

Configurações sensíveis (API keys, senhas)
URLs de APIs externas
Configurações que mudam entre ambientes

Exemplos de ENVs:

DATABASE_URL=postgres://user:pass@host:5432/db
API_KEY=sua-chave-aqui
PORT=3000
NODE_ENV=production

Limite: Até 50 variáveis de ambiente por projeto.

Passo 7: Configurar Armazenamento

Armazenamento Persistente

Escolha "Sim" se sua aplicação precisa:

Salvar arquivos que devem sobreviver a reinicializações
Compartilhar dados entre múltiplas instâncias
Persistir dados de banco de dados
Manter uploads de usuários

Escolha "Não" para aplicações onde os dados são efêmeros (como servidores web stateless).

Capacidade de Armazenamento

Mínimo: 1 GB
Máximo: 120 GB

Atenção: Para modelos de pagamento por hora, o armazenamento só pode ser aumentado, nunca diminuído. Para contratos mensais ou anuais, não é possível alterar o armazenamento após a criação do projeto.

Diretório para Persistir

Caminho absoluto do diretório dentro do container cujos dados serão salvos:

/app/data
/var/lib/postgresql/data
/uploads

Passo 8: Configurar Domínios

Subdomínio Zenifra

Planos superiores ao Basic incluem subdomínio personalizado no formato:

seu-projeto-sub-domain

Domínio Personalizado

Você pode usar seu próprio domínio (ex: api.suaempresa.com) em vez do subdomínio padrão.

Para configurar:

Ative a opção de domínio personalizado
Adicione seu domínio (ex: api.suaempresa.com)
Configure o DNS do seu domínio para apontar para a Zenifra via CNAME

Limite: Até 20 domínios personalizados por projeto.

Passo 9: Configurar Acesso de Rede (Planos Premium+)

Esta opção está disponível apenas em planos específicos.

Lista Branca (Whitelist)

Define quais endereços IP podem acessar seu projeto. IPs não listados serão bloqueados.

Formato CIDR:

0.0.0.0/0 - Permite todos os IPs (não recomendado em produção)
XXX.XXX.XXX.XXX/YY - Permite apenas o IP em si e todo o seu bloco.

Você pode adicionar seu IP atual automaticamente com um clique.

Lista Negra (Blacklist)

Define IPs específicos que serão bloqueados, mesmo que estejam na lista branca.

Passo 10: Finalizar a Criação

Revise todas as configurações
Clique em "Criar Projeto"
Aguarde alguns segundos para a criação

Após a Criação

Você receberá:

ID do Projeto: Identificador único do seu projeto
API Key: Chave para autenticação na API da Zenifra

Guarde a API Key em local seguro! Ela será necessária para gerenciar seu projeto via API.

Acesse a página do projeto
Vá em Configurações
Clique em Deletar
Confirme a ação

Atenção: Esta ação é irreversível! Todos os dados e configurações serão excluídos permanentemente.

Como Criar Projeto na Zenifra via Console