Importare un progetto Compose — un’API di note con PostgreSQL e Redis
Un file Compose che esegue un’API, il database PostgreSQL in cui questa conserva le sue note e una cache Redis, trasformato in bozze di file Aggrega da aggrega import — riportando le connessioni, le impostazioni del database, la password come riferimento a una variabile e il tag di ogni immagine — e compilato per Docker Compose.
Importare un progetto Compose lo illustra passo per passo: il comando, i file che scrive e perché ogni riga è lì, la compilazione e lo stack in esecuzione. Questa cartella contiene ogni fase di quella procedura guidata:
| cartella o file | cosa contiene |
|---|---|
source/ | il progetto Compose, compose.yaml, il .aggrega-config.yaml che rende la cartella un workspace, e import-answers.yaml, l’unico valore necessario a una build per Kubernetes che nessun file Compose contiene |
draft/ | i file che aggrega import compose.yaml --target compose ha scritto, invariati, release.lock incluso, e ciò che ha stampato: stdout.txt sullo standard output, import.txt sullo standard error |
In un checkout del repository della documentazione, check.sh esegue di nuovo l’importazione, confronta ciò che scrive e stampa con draft/, confronta i blocchi citati dalla procedura guidata con questi file, e convalida e compila ciò che l’importazione ha scritto. Richiede il catalogo della libreria standard (dove procurarselo) estratto accanto a questo repository, oppure la sua directory indicata in AGGREGA_CATALOG_DIRS.
Generare l’esempio
Puoi eseguire l’importazione di questo esempio con i comandi qui sotto, oppure far sì che il tuo assistente AI la esegua per te.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example import-composePoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd import-composeBuild
L’importazione genera le bozze dei file Aggrega accanto al progetto, in source/. Valuta il progetto rispetto al catalogo della libreria standard, che il registry predefinito del workspace pubblica come snapshot firmato: la prima importazione lo scarica, lo verifica, lo conserva nella cache dei contenuti del workspace e lo indica tramite il suo digest nel record che scrive accanto alle bozze. Un workspace che indica le proprie cartelle di catalogo — in AGGREGA_CATALOG_DIRS o sotto workspace.catalog_dirs — importa invece rispetto a quelle. L’importazione scarica quindi ciò da cui dipende la Release in bozza, così la compilazione segue subito:
cd sourceaggrega import compose.yaml --target composeaggrega build --release release.yamlLa compilazione scrive dist/compose/docker-compose.yaml; come eseguirlo è spiegato nella procedura guidata collegata sopra.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `import-compose`, chiama una volta lo strumento `scaffold` con `example` impostato a `import-compose` e senza `dir`: scrive l’esempio in una nuova cartella `import-compose`, la cui cartella `source` contiene ciò che questo esempio importa. Poi chiama lo strumento `import` con `workspace_root` impostato a `import-compose/source`, `source` impostato a `compose.yaml` e `target` impostato a `compose`: legge le risposte di cui ha bisogno da `import-answers.yaml` accanto a `compose.yaml`, scrive le sue bozze in `import-compose/source` e scarica ciò di cui queste hanno bisogno. Poi chiama lo strumento `validate` con `workspace_root` impostato a `import-compose/source` e `release` impostato a `release.yaml`, e lo strumento `build` con `workspace_root` impostato a `import-compose/source`, `release` impostato a `release.yaml` e `write` impostato a true. Dimmi quali file ha scritto la build; si trovano in `import-compose/source/dist/`.Eseguire il test
Con lo stack in esecuzione come lo esegue la guida passo passo, e un’immagine che risponde in HTTP sulla porta 8080 indicata per l’API, interroga l’API sulla porta che la Release pubblica:
curl -sS http://127.0.0.1:8080/notesIl sostituto della guida passo passo risponde con una descrizione della richiesta che ha ricevuto:
{ "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]}Importata con --target helm e applicata a Kubernetes, come mostra la guida passo passo, l’API risponde alla stessa richiesta allo stesso indirizzo una volta inoltrata una porta locale al suo Service; lì non riceve ancora la password del database, perché il Secret raggiunge soltanto il database:
kubectl port-forward -n <namespace> svc/api-default 8080:8080