Configuración

Configurá un build con acropolis.json o railpack.json y con variables ACROPOLIS_ o RAILPACK_.

La mayoría de las apps no necesitan configuración: Acropolis detecta el provider a partir del repo, con la misma precedencia que Railpack (Go, Rust, Python, Java y otros ganan sobre un package.json). Cuando la detección necesita ayuda, tenés dos formas de orientarla.

Archivo de configuración

Acropolis lee acropolis.json, o railpack.json si no existe, desde el directorio de la app. --config (o la variable CONFIG_FILE) elige otro archivo, que tiene que estar dentro del directorio de la app. El archivo es JSON (también se acepta JSON5) y sigue el schema de Railpack:

{
  "provider": "node",
  "buildAptPackages": ["libvips-dev"],
  "steps": {
    "build": { "commands": ["npm run build:prod"] }
  },
  "deploy": {
    "startCommand": "node dist/server.js",
    "aptPackages": ["ffmpeg"],
    "paths": ["dist"]
  }
}

Claves soportadas: provider, packages, buildAptPackages, steps (con commands, variables, secrets, deployOutputs), deploy (startCommand, aptPackages, inputs, paths, variables) y exclude. Los secrets y caches de primer nivel de Railpack, los inputs y caches de los steps y deploy.base se aceptan por compatibilidad, pero se ignoran. Las claves desconocidas hacen fallar el build, así que un typo no pasa desapercibido.

Variables

Las variables de la app se pasan con -e KEY=VALUE. Cada setting se lee primero con el prefijo ACROPOLIS_ y después con el prefijo RAILPACK_, así una configuración de Railpack sigue funcionando:

Las variables comunes de la app que pasás con -e (cualquier nombre sin el prefijo ACROPOLIS_ o RAILPACK_) llegan a los steps del build, pero el plan solo lleva referencias {env:NAME}, nunca los valores, y la config de la imagen no las recibe: definí las variables de runtime en el contenedor que corre la imagen. Los settings de la tabla de arriba son distintos: Acropolis lee sus valores para armar el plan, así que pueden terminar en el plan que imprime plan --json y en la config de la imagen (START_CMD pasa a ser el comando de la imagen, por ejemplo). Las variables escritas en los steps personalizados de un archivo de configuración también forman parte del plan. Nunca pongas secretos en estos settings.

info.json no guarda el plan: tiene el hash del plan, los datos detectados y las versiones de toolchain pedidas y resueltas.

Settings del operador

Estas (con el prefijo ACROPOLIS_ o RAILPACK_) se leen solo del entorno del proceso acropolis. Si llegan por -e o por el archivo de configuración se ignoran, así que una app no puede cambiarlas: