Documentación / Desarrollar y desplegar
Variables y configuración
Variables del servicio, referencias y formato de upferry.json.
Variables y referencias
Añade configuración y secretos en Variables del servicio. Las variables compartidas pertenecen al entorno del proyecto. Se incluyen mediante una referencia explícita, no se inyectan automáticamente en todos los servicios.
DATABASE_URL=${{postgres.DATABASE_URL}}
API_KEY=${{shared.API_KEY}}
API_BASE=https://${{api.UPFERRY_PUBLIC_DOMAIN}}/v1
postgres y api son servicios del mismo entorno. ${{PGHOST}} referencia una variable del servicio actual. Las referencias ausentes y circulares producen errores. Guardar no cambia el proceso en ejecución: despliega de nuevo. No publiques secretos en código, registros ni capturas.
Archivo del repositorio
Pon upferry.json en la raíz del servicio; si falta, se busca en la raíz del repositorio. Sus campos sustituyen los correspondientes del panel para ese despliegue. El resto mantiene los valores del panel.
{
"build": {
"buildCommand": "npm ci && npm run build",
"watchPatterns": ["apps/api/**", "packages/shared/**"]
},
"deploy": {
"startCommand": "npm start",
"healthcheckPath": "/health",
"healthcheckTimeout": 120,
"restartPolicyType": "ON_FAILURE",
"restartPolicyMaxRetries": 3
},
"resources": {
"memoryMb": 1024,
"cpus": 0.5,
"pids": 256
}
}
Adapta comandos y patrones al proyecto. deploy también admite preDeployCommand y cronSchedule. Las políticas son ON_FAILURE, ALWAYS y NEVER. El tiempo de comprobación está en segundos y cron usa UTC. Los campos desconocidos se rechazan.