Como criar um projeto na Zenifra via console

Primeiro Passo

Para criarmos um projeto na Zenifra, é necessário ter uma conta com saldo disponível, ou com um cartão de crédito disponível, tanto pessoa física, como pessoa júridica.

Ao realizar login na console, selecionar no menu esquerdo, a aba Projeto.

Após selecionar Projetos, no canto superior direito(fig 1) terá um botão com ícone de "+", no qual deverá clicar, e assim será aberto uma nova tela para criação do projeto!

Segundo Passo

Ao abrir a tela de criação de projeto, iremos ver mais sobre as opções disponíveis para criar os mais diversos possíveis!

Detalhes dos Campos

Nome do Projeto

O nome do projeto é importante, para a organização dos projetos, como também para o domínio!

Em todos os planos, é dado um domínio de forma gratuita para o projeto em questão, ser utilizado através da internet. Para projetos no plano Basic, o nome do subdomínio do projeto será constituído de um nome aleatório.

Para projetos que tenham o plano superior ao Basic, como Premium, Business entre outros, o nome do subdomínio será o nome do projeto acrescido alguns caracteres.

Imagem

A imagem do projeto, é a imagem docker que rodará nas nossas máquinas!

Importante passar a imagem docker, com o path completo!

Exemplo:

docker.io/postgres:17.5-alpine3.21

⚠️ É de extrema importância colocar o path completo, incluindo o Registry e uma tag, sem ser "latest"! Ao passar uma imagem com a tag "latest", não será garantido a permanência naquela versão baixada no "latest", podendo ocorrer problemas futuros de compatibilidade.

As imagens podem ser mudadas a qualquer momento! Para realizar tal ação, iremos abordar em outro passo a passo, mas saiba que essa mudança de imagem poderá ocorrer tanto de forma manual, como automatizada, como disparo de API via fluxo, como GitHub Actions!

Registry Público

Escolha a opção que se encaixa na sua imagem! Caso a sua imagem seja pública, ou seja, não necessite de autenticação para ser baixada, assinale a opção "Pública".

Caso a sua imagem necessite de permissão para ser baixada, assinale a opção "Privada"

Plano

O plano do projeto, define o preço a ser pago na modalidade escolhida, além da quantidade de recursos, como CPU, Memória e Armazenamento disponível para a sua aplicação!

Existem diversos planos, tanto para aplicações Web, Backend(APIs), Banco de Dados, IA(Inteligência Artificial) entre outras! Nossos planos são feitos para atender a todos os tipos de aplicações e projetos.

O plano do projeto não poderá ser mudado após o projeto ter sido criado!

Armazenamento Persistente

O armazenamento persistente é utilizado nos cenários abaixo:

• Múltiplas instâncias do projeto em execução, no qual todas acessam com leitura e escrita os mesmos dados.
• Banco de Dados.
• Na troca de imagem da instância, não ocorrerá perdas das informações.
• Em caso de algum problema na máquina de execução da instância, a mesma não sofrerá perda de informações.

Quando o armazenamento não é persistente, a informação daquela instância só existe enquanto aquele processo estiver vivo! Caso ocorra algum erro, ou atualização, as informações ali contidas na instância, serão devidamente apagadas!

Escolha a opção que se encaixa no seu caso de uso! Sua aplicação necessita, ou é recomendada ter um armazenamento persistente para ela? Se sim, selecione a opção "Sim".

Caso sua aplicação não necessite de armazenamento persistente, como a maioria dos casos como servidores web e sites, selecione a opção "Não".

Tamanho do Armazenamento

Por padrão, o mínimo de armazenamento que é permitido, é de 5GB por projeto!

Todos os planos dão de forma gratuita, 5GB de armazenamento efêmero para ser utilizado no projeto.

Para armazenamento efêmero, cada instância terá o seu próprio armazenamento, não compartilhado com nenhuma outra instância. Consequentemente, para cada nova instância, será acrescido o valor do armazenamento.

Para armazenamento persistente, todas as instâncias do projeto, compartilharão o mesmo armazenamento! Consequentemente, cada nova instância não terá acréscimo de valor.

Número da Porta

O número da porta, diz respeito em qual porta será aberta para acesso pela internet!

Lembrando que no final, as portas 80 e 443 acessadas via internet(HTTP e HTTPs), irão ser enviadas para essa porta aberta na instância.

Escolha modelo de pagamento do plano

Nesse passo, deverá escolher em qual modelo de pagamento você deseja fazer para esse projeto!

Na Zenifra, temos 3 modelos de pagamento, sendo eles:

• Por Hora
• Por Mês
• Por Ano

Pagamento por Hora

No pagamento por hora, é cobrado a utilização das instâncias, por hora! Ou seja, você só irá pagar, quando tiver uma instância em execução no projeto.

Esse tipo de modalidade é o ideal para muitos projetos!

Caso a sua aplicação tenha executado durante apenas 10 minutos no mês, você pagará apenas o valor de 1 hora.

Caso sua aplicação tenha executado durante apenas 3 dias inteiros no mês, você pagará o valor de 72 horas. (24h * 3d)

Importante frizar que no pagamento por hora, o pagamento da utilização é debitado no cartão ou no saldo em conta, apenas no final do mês!

Pagamento por Mês

No pagamento por mês, é cobrado a utilização das instâncias, por mês! Ou seja, ao selecionar esse modelo de precificação, você terá o direito de executar a instância por 30 dias corridos, apartir da criação do projeto.

No total, você estará comprando 720h para execução da sua instância.

Nesse modelo de precificação, a instância ficará reservada para sua utilização durante todo o período, mesmo que você não use!

Pagamento por Ano

No pagamento por ano, é cobrado a utilização das instâncias de forma anual! Ou seja, ao selecionar esse modelo de precificação, você terá o direito de executar a instância por 364 dias!

No total, você estará comprando 8640h para execução da sua instância.

Nesse modelo de precificação, a instância ficará reservada para sua utilização durante todo o período, mesmo que você não use!

Quantidade de Instâncias

A quantidade de instâncias diz respeito ao número de instâncias de máquinas rodando nesse projeto!

Para aplicações que recebem alto número de tráfego, como aplicações Web e APIs, é recomendável a utilização de pelo menos 2 instâncias por projeto, para garantir alta disponibilidade e resiliência em caso de falhas.

O tráfego recebido será distribuído de forma homogênia entre as instâncias.

Para cada instância, será acrescido o valor do plano antes selecionado.

Environment Variables

As variáveis de ambientes, conhecidas como ENVs, poderão ser adicionadas nesse step. Elas podem ser mudadas posteriormente, sem problemas.

Possui o limite de 50 ENVs cadastradas por projeto!

Custo total

No custo total, você terá a visibillidade de quanto essa aplicação lhe custará por hora, dia, mês e ano!

Para usar de exemplo, altere o valor do número da quantidade de instâncias, aumentando e diminuindo, para ver o custo.

Terceiro Passo

Após preencher todas as informações acima, clique no botão "Criar Projeto", no qual poderá levar alguns segundos até a criação do projeto ocorrer!

Após criado, será aberto uma nova tela, de forma automática, mostrando a URL do projeto a ser acessado.

Clique nesse link, e ao clicar, será aberto uma nova aba, que será redirecionado diretamente para esse projeto!

Finalizando

Caso deseje finalizar/terminar a execução da instância, poderá ir na aba Projetos, e lá, pesquisar pelo projeto criado. Após ter encontrado, clicar encima do nome do projeto, no qual abrirá uma nova página contendo as informações daquele projeto.

Ao acessar a tela, clicar em "Configurações" e "Deletar", no qual o projeto será devidamente deletado.

Para saber mais sobre essa tela, e como tirar insigths do seu negócio, prossiga para a próxima documentação!