Pular para o conteúdo principal

Requisitos

  • Elixir 1.20 (OTP 28) instalado localmente
  • Conta na Vertra Cloud
  • Um projeto com um mix.exs na raiz

Estrutura do projeto

A plataforma detecta o Elixir pelo mix.exs. Ela executa mix deps.get e compila com MIX_ENV=prod. Inicia a aplicação com mix run --no-halt ou, quando o projeto depende de :phoenix, com mix phx.server.

Configuração

vertracloud.config

MAIN é mix.exs.

Phoenix

O Phoenix é suportado. Defina estas variáveis em Ambiente: Em config/runtime.exs, escute em todas as interfaces e leia a porta do ambiente:
Execute mix assets.deploy localmente antes de compactar o projeto, ou use um projeto sem assets (mix phx.new --no-assets). Depois, envie os arquivos estáticos gerados no zip.

Exemplo: servidor Plug

Deploy

  1. Compacte o projeto em um .zip ou envie para o GitHub.
  2. No painel, clique em Novo Projeto e envie o .zip ou cole a URL do repositório.
  3. Em Build, confira o runtime (Elixir), o arquivo principal (mix.exs) e a memória. Os comandos de start e de build ficam em Configurações Avançadas.
  4. Adicione suas variáveis de ambiente em Ambiente.
  5. Em Rede, ative a publicação web para que a aplicação receba um endereço *.vertraweb.app (plano Pro ou superior, 512 MB de memória). A aplicação precisa escutar na porta 80.
  6. Revise e faça o deploy. Acompanhe a saída na aba Logs.
O passo a passo completo está em Primeiro deploy.

Versões disponíveis

Observações

  • Build: as dependências e a compilação rodam durante o deploy com MIX_ENV=prod
  • Excluir do zip: as pastas _build e deps
  • Variáveis de ambiente: leia-as em config/runtime.exs com System.get_env/1
  • Logs: use Logger para logs que aparecem em tempo real
  • Escute em 0.0.0.0 na porta 80

Erros comuns

  • SECRET_KEY_BASE ou PHX_HOST ausente: uma aplicação Phoenix não inicia sem eles. Adicione os dois em Ambiente e reinicie.
  • Assets do Phoenix ausentes: execute mix assets.deploy antes de compactar, ou use um projeto sem assets.
  • O site não abre: o endpoint precisa escutar em 0.0.0.0 e na porta 80, não em 127.0.0.1 ou 4000.
Última modificação em 26 de outubro de 2026