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

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

Los campos de comando son comandos de shell escalares:

build_cmd: pnpm install && pnpm build

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.