Importer un projet Compose — une API de notes avec PostgreSQL et Redis
Un fichier Compose exécutant une API, la base de données PostgreSQL dans laquelle elle conserve ses notes et un cache Redis, transformé en brouillons de fichiers Aggrega par aggrega import — en reprenant les connexions, les paramètres de la base de données, le mot de passe sous forme de référence à une variable et le tag de chaque image — et compilé pour Docker Compose.
Importer un projet Compose le présente pas à pas : la commande, les fichiers qu’elle écrit et la raison d’être de chaque ligne, la compilation, et la stack en cours d’exécution. Ce dossier contient chaque étape de ce tutoriel :
| dossier ou fichier | ce qu’il contient |
|---|---|
source/ | le projet Compose, compose.yaml, le .aggrega-config.yaml qui fait du dossier un espace de travail, et import-answers.yaml, la seule valeur dont une compilation pour Kubernetes a besoin et qu’aucun fichier Compose ne contient |
draft/ | les fichiers que aggrega import compose.yaml --target compose a écrits, inchangés, release.lock compris, et ce qu’il a affiché : stdout.txt sur la sortie standard, import.txt sur la sortie d’erreur standard |
Dans un checkout du dépôt de la documentation, check.sh exécute à nouveau l’import, compare ce qu’il écrit et affiche avec draft/, compare les blocs que le tutoriel cite avec ces fichiers, et valide et compile ce que l’import a écrit. Il nécessite le catalogue de la bibliothèque standard (où en obtenir un) extrait à côté de ce dépôt, ou son répertoire indiqué dans AGGREGA_CATALOG_DIRS.
Générer l’exemple
Vous pouvez exécuter l’import de cet exemple avec les commandes ci-dessous, ou le faire exécuter par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example import-composeElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd import-composeBuild
L’import rédige les brouillons des fichiers Aggrega à côté du projet, dans source/. Il évalue le projet par rapport au catalogue de la bibliothèque standard, que le registre par défaut de l’espace de travail publie sous forme d’instantané signé : le premier import le récupère, le vérifie, le conserve dans le cache de contenu de l’espace de travail et le désigne par son digest dans l’enregistrement qu’il écrit à côté des brouillons. Un espace de travail qui désigne ses propres dossiers de catalogue — dans AGGREGA_CATALOG_DIRS, ou sous workspace.catalog_dirs — importe plutôt par rapport à ceux-ci. L’import récupère ensuite ce dont dépend la Release rédigée, de sorte que la compilation suit immédiatement :
cd sourceaggrega import compose.yaml --target composeaggrega build --release release.yamlLa compilation écrit dist/compose/docker-compose.yaml ; son exécution est décrite dans le tutoriel indiqué ci-dessus.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `import-compose`, appelez une fois l’outil `scaffold` avec `example` défini sur `import-compose` et sans `dir` : il écrit l’exemple dans un nouveau dossier `import-compose`, dont le dossier `source` contient ce que cet exemple importe. Appelez ensuite l’outil `import` avec `workspace_root` défini sur `import-compose/source`, `source` défini sur `compose.yaml` et `target` défini sur `compose` : il lit les réponses dont il a besoin dans `import-answers.yaml`, à côté de `compose.yaml`, écrit ses brouillons dans `import-compose/source` et récupère ce dont ils ont besoin. Appelez ensuite l’outil `validate` avec `workspace_root` défini sur `import-compose/source` et `release` défini sur `release.yaml`, puis l’outil `build` avec `workspace_root` défini sur `import-compose/source`, `release` défini sur `release.yaml` et `write` défini sur true. Indiquez-moi les fichiers écrits par le build ; ils se trouvent sous `import-compose/source/dist/`.Tester
Avec la pile en cours d’exécution comme le guide pas à pas l’exécute, et une image répondant en HTTP sur le port 8080 désignée pour l’API, interrogez l’API sur le port que la Release publie :
curl -sS http://127.0.0.1:8080/notesLe substitut du guide pas à pas répond par une description de la requête qu’il a reçue :
{ "path": "/notes", "headers": { "host": "127.0.0.1:8080", [… omitted: the user agent and the media types the client sent] }, "method": "GET", [… omitted: the rest of the request as the stand-in received it, the client's address and the container's host name]}Importée avec --target helm et appliquée à Kubernetes, comme le montre le guide pas à pas, l’API répond à la même requête à la même adresse une fois un port local redirigé vers son Service ; elle n’y reçoit pas encore le mot de passe de sa base de données, puisque le Secret n’atteint que la base de données :
kubectl port-forward -n <namespace> svc/api-default 8080:8080