Adios
Guidesadios.yaml

Guide du manifeste

Un manifeste, du code créé avec l’aide de l’IA à l’application en ligne.

`adios.yaml` garde le contrat de déploiement près du code : compilation, démarrage, port, santé, secrets, ressources, réplicas et routes. Les changements générés sont ainsi plus faciles à examiner avant d’arriver en production.

adios.yaml
name: billing-api
region: de
replicas: 2

build_cmd: pnpm install && pnpm build
start_cmd: pnpm start

runtime:
  name: node@24
  port: 3000
  health_path: /api/health

requires:
  - db

env:
  DATABASE_URL: secret://DATABASE_URL
  API_SIGNING_KEY: secret://API_SIGNING_KEY

Contrat de déploiement

Examinez le manifeste comme du code de production.

Le code de l’application et sa configuration de déploiement évoluent ensemble. Un petit manifeste rend les éléments opérationnels visibles lors de la revue du code, au lieu de les disperser entre une conversation, un tableau de bord et l’historique du shell.

ChampÉléments à vérifier
nameNom stable de l’application utilisé par Adios pour le workload.
build_cmdCommande qui prépare les fichiers de production à partir d’une copie propre du dépôt.
start_cmdCommande qui démarre le processus de production.
runtime.portPort sur lequel l’application écoute dans l’environnement d’exécution.
runtime.health_pathChemin HTTP qu’Adios peut utiliser pour vérifier que l’application est prête.
envVariables d’environnement, y compris les références secret://DATABASE_URL.
secretsDéclarations de génération de secrets, comme secret://generate:64.
requiresServices gérés dont dépend l'application, comme db ou cache.

Flux de travail

Utilisez le manifeste pour garder le code généré par l’IA déployable.

Lorsqu’un agent IA ajoute une route API, un worker en arrière-plan, un appel à une base de données ou un fournisseur externe, demandez-lui de mettre à jour le manifeste uniquement si le contrat d’exécution change. Vérifiez ensuite la commande et la configuration au lieu de faire confiance aveuglément au fichier généré.

Compiler depuis une arborescence propre

La commande de compilation doit fonctionner sans dépendre de l’état de l’éditeur, de caches locaux ou d’outils non déclarés.

Démarrer le serveur de production

La commande de démarrage doit lancer le processus serveur qui recevra le trafic réel.

Vérifier que l’application est prête

La route de santé doit échouer si les dépendances nécessaires au traitement des requêtes sont indisponibles.