Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Importar un proyecto Compose — una API de notas con PostgreSQL y Redis

Un archivo Compose que ejecuta una API, la base de datos PostgreSQL en la que guarda sus notas y una caché Redis, convertido en borradores de archivos Aggrega por aggrega import — trasladando las conexiones, la configuración de la base de datos, la contraseña como referencia a una variable y la etiqueta de cada imagen — y compilado para Docker Compose.

Importar un proyecto Compose lo recorre paso a paso: el comando, los archivos que escribe y por qué está ahí cada línea, la compilación y el stack en ejecución. Esta carpeta contiene cada etapa de ese recorrido:

carpeta o archivoqué contiene
source/el proyecto Compose, compose.yaml, el .aggrega-config.yaml que convierte la carpeta en un espacio de trabajo, y import-answers.yaml, el único valor que necesita una compilación para Kubernetes y que ningún archivo Compose contiene
draft/los archivos que escribió aggrega import compose.yaml --target compose, sin cambios, incluido release.lock, y lo que imprimió: stdout.txt en la salida estándar, import.txt en la salida de error estándar

En un checkout del repositorio de la documentación, check.sh vuelve a ejecutar la importación, compara lo que escribe e imprime con draft/, compara los bloques que cita el recorrido con estos archivos, y valida y compila lo que escribió la importación. Necesita el catálogo de la biblioteca estándar (dónde conseguir uno) descargado junto a este repositorio, o su directorio indicado en AGGREGA_CATALOG_DIRS.

Generar el ejemplo

Puedes ejecutar la importación de este ejemplo con los comandos de abajo, o hacer que tu asistente de IA la ejecute por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

Terminal window
aggrega scaffold --example import-compose

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd import-compose

Compilación

La importación redacta los borradores de los archivos Aggrega junto al proyecto, en source/. Evalúa el proyecto frente al catálogo de la biblioteca estándar, que el registro predeterminado del espacio de trabajo publica como una instantánea firmada: la primera importación lo descarga, lo verifica, lo guarda en la caché de contenido del espacio de trabajo y lo identifica por su digest en el archivo de constancia que escribe junto a los borradores. Un espacio de trabajo que indica sus propias carpetas de catálogo — en AGGREGA_CATALOG_DIRS, o bajo workspace.catalog_dirs — importa en cambio frente a esas. Luego la importación descarga aquello de lo que depende la Release redactada, de modo que la compilación sigue de inmediato:

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

La compilación escribe dist/compose/docker-compose.yaml; cómo ejecutarlo se explica en el recorrido enlazado arriba.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `import-compose`, llama una vez a la herramienta `scaffold` con `example` establecido en `import-compose` y sin `dir`: escribe el ejemplo en una nueva carpeta `import-compose`, cuya carpeta `source` contiene lo que este ejemplo importa. Después llama a la herramienta `import` con `workspace_root` establecido en `import-compose/source`, `source` establecido en `compose.yaml` y `target` establecido en `compose`: lee las respuestas que necesita de `import-answers.yaml`, junto a `compose.yaml`, escribe sus borradores en `import-compose/source` y descarga lo que necesitan. Después llama a la herramienta `validate` con `workspace_root` establecido en `import-compose/source` y `release` establecido en `release.yaml`, y a la herramienta `build` con `workspace_root` establecido en `import-compose/source`, `release` establecido en `release.yaml` y `write` establecido en true. Dime qué archivos escribió la compilación; están en `import-compose/source/dist/`.

Probarlo

Con la pila en ejecución tal como la ejecuta la guía paso a paso, y una imagen que responde HTTP en el puerto 8080 indicada para la API, consulta la API en el puerto que publica la Release:

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

El sustituto de la guía paso a paso responde con una descripción de la solicitud que recibió:

{
"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]
}

Importada con --target helm y aplicada a Kubernetes, como muestra la guía paso a paso, la API responde a la misma solicitud en la misma dirección una vez que se reenvía un puerto local a su Service; allí aún no recibe la contraseña de su base de datos, ya que el Secret solo llega a la base de datos:

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