Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

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 fichierce 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 :

Terminal window
aggrega scaffold --example import-compose

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd import-compose

Build

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 :

Terminal window
cd source
aggrega import compose.yaml --target compose
aggrega build --release release.yaml

La 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 :

Terminal window
curl -sS http://127.0.0.1:8080/notes

Le 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 :

Terminal window
kubectl port-forward -n <namespace> svc/api-default 8080:8080