Requisitos
- Elixir 1.20 (OTP 28) instalado localmente
- Cuenta en Vertra Cloud
- Un proyecto con un
mix.exsen la raíz
Estructura del proyecto
mix.exs. Ejecuta mix deps.get y compila con MIX_ENV=prod. Inicia la aplicación con mix run --no-halt o con mix phx.server cuando el proyecto depende de :phoenix.
Configuración
vertracloud.config
MAIN es mix.exs.
Phoenix
Phoenix es compatible. Define estas variables en Entorno:
En
config/runtime.exs, vincula a todas las interfaces y lee el puerto del entorno:
Ejemplo: servidor Plug
Despliegue
- Panel
- CLI
- VS Code
- Comprime el proyecto en un
.zipo súbelo a GitHub. - En el panel, haz clic en Nuevo proyecto y sube el
.zipo pega la URL del repositorio. - En Build, revisa el runtime (Elixir), el archivo principal (
mix.exs) y la memoria. Los comandos de inicio y de build están en Ajustes avanzados. - Agrega tus variables de entorno en Entorno.
- En Red, activa Publicación web para que la aplicación obtenga una dirección
*.vertraweb.app(plan Pro o superior, 512 MB de memoria). La aplicación debe escuchar en el puerto 80. - Revisa y despliega. Sigue la salida en la pestaña Logs.
Versiones disponibles
Notas
- Compilación: las dependencias y la compilación se ejecutan durante el despliegue con
MIX_ENV=prod - Excluir del zip: las carpetas
_buildydeps - Variables de entorno: léelas en
config/runtime.exsconSystem.get_env/1 - Logs: usa
Loggerpara los logs que aparecen en tiempo real - Escucha en
0.0.0.0en el puerto 80
Errores comunes
- Falta
SECRET_KEY_BASEoPHX_HOST: una aplicación Phoenix no arranca sin ellas. Agrega ambas en Entorno y reinicia. - Faltan los assets de Phoenix: ejecuta
mix assets.deployantes de comprimir, o usa un proyecto sin assets. - El sitio no abre: el endpoint debe vincularse a
0.0.0.0y al puerto 80, no a127.0.0.1ni al 4000.