Referencia de adios.yaml
adios.yaml describe cómo Adios compila, ejecuta, conecta y publica tu aplicación.
Aplicación y entorno de ejecución
name: api
region: de
replicas: 2
dependency_cmd: go mod download
build_cmd: go build -o /app/api .
start_cmd: /app/api
runtime:
name: go@1.25
port: 8080
cpu: "0.5"
memory_mb: 512
disk_mb: 2048
health_path: /healthz
health_path es opcional. Si no lo indicas, Adios comprueba / por HTTP en el puerto del entorno de ejecución. Los servicios gestionados de bases de datos, caché y colas usan en su lugar una comprobación TCP en su puerto.
Los campos de comando son comandos de shell escalares:
dependency_cmd: pnpm install --frozen-lockfile
build_cmd: pnpm build
Dependencias y build
Pon la instalación de paquetes en dependency_cmd y la compilación en build_cmd. Adios ejecuta dependency_cmd primero, en un paso aparte que solo ve tus archivos de dependencias, como package.json y su lockfile, requirements.txt,
go.mod, o composer.lock. Si esos archivos, el entorno de ejecución, el comando y el entorno de build no han cambiado, el siguiente build reutiliza los paquetes instalados y pasa directamente a build_cmd.
Comandos habituales:
| Stack | dependency_cmd |
|---|---|
| npm | npm ci (añade --include=dev si el build necesita dependencias de desarrollo) |
| pnpm | pnpm install --frozen-lockfile |
| pip | python -m pip install -r requirements.txt |
| Bundler | BUNDLE_FROZEN=true bundle install |
| Composer | composer install --no-dev --prefer-dist --no-interaction --no-scripts --no-autoloader |
| Go | go mod download |
| .NET | dotnet restore |
Los paquetes instalados solo con build_cmd no están disponibles cuando un espacio de trabajo ejecuta comandos de lint o de pruebas en un entorno nuevo, por eso el espacio de trabajo avisa cuando falta dependency_cmd.
Si tu instalación necesita archivos además de los archivos de dependencias habituales, indícalos en build.dependency_files. La lista sustituye la detección automática, así que incluye también el lockfile. Los proyectos cuya instalación depende del código de la aplicación, como la generación de Prisma, las dependencias de rutas locales o los scripts de Composer, reciben el código completo automáticamente. Ejecuta adios up --no-cache para reinstalar desde cero.
Caché en el edge y tráfico saliente
Las apps de Next.js tienen caché en el edge para recursos estáticos y páginas de forma automática. En otras apps, activa la caché del gateway en adios.yaml:
cache:
enabled: true
ttl_seconds: 300
El edge omite las solicitudes con un encabezado Authorization y las respuestas marcadas como no-store o private, o que establecen cookies.
Configura runtime.egress: none para impedir que una carga de trabajo acceda a internet, por ejemplo un worker interno que solo se comunica con servicios privados. Usa egress: internet para permitirlo de forma explícita. Si no se define el campo, se aplica el valor predeterminado de la plataforma.
Recursos gestionados
resources:
- name: db
template: postgres:16
database: aor
username: aor_api
password: secret://POSTGRES_PASSWORD
- name: redis
template: redis:7
database: "0"
password: secret://REDIS_PASSWORD
- name: rabbitmq
template: rabbitmq:3
database: aor
username: aor_api
password: secret://RABBITMQ_PASSWORD
El resources aprovisiona y vincula bases de datos, cachés y colas gestionadas con la aplicación. Las familias de recursos compatibles incluyen Postgres, pgvector, Redis, RabbitMQ, MongoDB y MySQL. Usa ref cuando la aplicación debe unirse a un recurso existente en lugar de poseer uno nuevo.
Los ajustes de conexión se inyectan en la aplicación con un nombre de host privado estable. El nombre sin versión sigue el recurso actual promovido; un nombre de host con versión explícita puede seleccionar una v1, v2, o la versión de despliegue generada. Consulta Recursos gestionados y DNS interno con versiones para el contrato completo de nombres, fijación de versiones, seguridad y resolución de problemas.
Secretos y configuración
env:
PUBLIC_APP_URL: https://dashboard.example.com
DATABASE_URL: secret://DATABASE_URL
STRIPE_SECRET_KEY: secret://STRIPE_SECRET_KEY
Coloca tanto las variables de entorno normales como secret://NAME referencias en env. Crea los valores de secretos referenciados con la CLI o el IDE web antes del despliegue. Usa el secrets solo para generar valores nuevos:
env:
PUBLIC_APP_URL: https://dashboard.example.com
API_SIGNING_KEY: secret://API_SIGNING_KEY
DJANGO_SECRET_KEY: secret://DJANGO_SECRET_KEY
secrets:
API_SIGNING_KEY: secret://generate:64
DJANGO_SECRET_KEY: secret://generate:32
El secrets declara la generación; env hace referencia a los valores que necesita la aplicación. Mantén los valores de las credenciales fuera de Git. La configuración de ejecución también puede incluir indicadores de funciones, volúmenes y ajustes de despliegue gestionados desde el espacio de trabajo.
Dependencias Git privadas
Las compilaciones que obtienen repositorios Git privados deben utilizar una clave de despliegue exclusiva de compilación:
build:
ssh:
- default=secret://BITBUCKET_DEPLOY_KEY
env:
GOPRIVATE: "bitbucket.org/your-workspace/*"
Registra la clave pública con el proveedor Git y después almacena la privada en el equipo Adios de la aplicación:
adios secrets set BITBUCKET_DEPLOY_KEY \
--from-file ~/.ssh/adios-build
El worker resuelve la clave solo para la compilación y después elimina su copia temporal. No añadas una clave privada al repositorio ni la pongas en una URL de repositorio. Sigue Dependencias Git privadas para generación de claves, Bitbucket, GitHub, GitLab, Docker y pasos de resolución de problemas.
Versiones, réplicas y enrutamiento
name: web
region: de
replicas: 2
routable: true
custom_hosts:
- app.example.com
- www.example.com
redirects:
- from: example.com
to: www.example.com
Cada despliegue crea una versión del entorno de ejecución. Adios puede mantener las versiones anteriores disponibles para inspección y reactivación mientras dirige el tráfico a la versión actual promovida. Las réplicas pueden ejecutarse por región, y el tráfico público puede servirse mediante rutas generadas, dominios personalizados, CDN y puntos de entrada basados en anycast.
custom_hosts asocia nombres de host públicos exactos a la versión actual promovida. redirects crea rutas de redirección para hosts exactos. Un destino de redirección sin esquema utiliza HTTPS de forma predeterminada, y la puerta de enlace conserva la ruta de la solicitud y la cadena de consulta.
Consulta Dominios y redirecciones para el flujo de enrutamiento completo.
Manifiestos de flujo de trabajo
Los entornos de ejecución de aplicaciones utilizan build_cmd, start_cmd, y runtime. La automatización de flujos de trabajo utiliza un manifiesto con workflow_id, triggers, y steps. Consulta Flujos de trabajo para un flujo de trabajo completo adios.yaml ejemplo.
Código fuente y espacios de trabajo
build:
excludes:
- node_modules
- .next
Los artefactos de código fuente permiten que el IDE web abra el código que produjo una app desplegada. Desde un espacio de trabajo puedes editar archivos, usar Git, ejecutar vistas previas, inspeccionar registros y desplegar la versión actual.