Requisitos
- Elixir 1.20 (OTP 28) instalado localmente
- Conta na Vertra Cloud
- Um projeto com um
mix.exsna raiz
Estrutura do projeto
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:
Exemplo: servidor Plug
Deploy
- Painel
- CLI
- VS Code
- Compacte o projeto em um
.zipou envie para o GitHub. - No painel, clique em Novo Projeto e envie o
.zipou cole a URL do repositório. - 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. - Adicione suas variáveis de ambiente em Ambiente.
- 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. - Revise e faça o deploy. Acompanhe a saída na aba Logs.
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
_buildedeps - Variáveis de ambiente: leia-as em
config/runtime.exscomSystem.get_env/1 - Logs: use
Loggerpara logs que aparecem em tempo real - Escute em
0.0.0.0na porta 80
Erros comuns
SECRET_KEY_BASEouPHX_HOSTausente: uma aplicação Phoenix não inicia sem eles. Adicione os dois em Ambiente e reinicie.- Assets do Phoenix ausentes: execute
mix assets.deployantes de compactar, ou use um projeto sem assets. - O site não abre: o endpoint precisa escutar em
0.0.0.0e na porta 80, não em127.0.0.1ou 4000.