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

Importación de biblioteca de Workload — un cuerpo de Workload compartido mediante `$import`

Un único servicio web sin estado cuya Recipe sintetiza su Workload de Kubernetes a partir de una entrada de biblioteca compartida en lugar de un cuerpo en línea. Este es el tercer modo de autoría de spec.workload en una Recipe:

  • Modo 1 (en línea): un Workload en plantilla Go escrito directamente en la Recipe.
  • Modo 2 (importación de archivo): $import: ./relative/path.yaml — un archivo local.
  • Modo 3 (importación de biblioteca): $import: <Library>#/workloads/<Entry> — una entrada de WorkloadLibrary referenciada mediante una identidad de nombre simple.

Aquí la Recipe web-service usa el modo 3:

spec:
capability: helm
implements: example/compute/web-service
workload:
$import: BaseWorkloads#/workloads/StatelessService

Escribe la referencia como un único token ininterrumpido: sin espacios ni saltos de línea en ningún punto, desde el nombre de la biblioteca hasta el fragmento. Una referencia que contiene espacios en blanco se rechaza en lugar de recortarse, y la compilación se detiene — consulta errors/fatal-halts.md «A reference to a library entry carries whitespace (Una referencia a una entrada de biblioteca contiene espacios en blanco)».

BaseWorkloads es una WorkloadLibrary publicada en el catálogo del hub (workloadlibrary/base-workloads). Su entrada StatelessService es una plantilla Go evaluada en el contexto de renderizado de esta Recipe, así que .values.image (del Component/Aggregate) y .infra.* (réplicas, puerto, cómputo — de la Release) fluyen en ella exactamente como lo harían en un cuerpo en línea. Factorizar el Workload en una biblioteca no cambia nada de lo que se despliega: la salida renderizada es idéntica byte a byte al Workload en línea equivalente.

La versión de la biblioteca la proporciona el archivo de bloqueo de cada Release — ningún host de registro aparece en la referencia. Con aggrega pull, BaseWorkloads se fija en la sección workload_libraries del archivo de bloqueo; con aggrega build, la biblioteca fijada se resuelve y su entrada se renderiza.

Generar el ejemplo

Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

Terminal window
aggrega scaffold --example workload-library-import

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

Terminal window
cd workload-library-import

Compilación

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega build --release release.yaml

El catálogo se resuelve a partir del registro del hub nombrado en .aggrega-config.yaml (que proporciona BaseWorkloads y el proveedor helm) más el catalog/ local de este ejemplo (el Component y la Recipe web-service). Los Manifests quedan en dist/app/helm/ — el directory: del límite seguido de la capacidad del proveedor.

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 `workload-library-import`, llama una vez a la herramienta `scaffold` con `example` establecido en `workload-library-import` y sin `dir`: escribe el ejemplo en una nueva carpeta `workload-library-import`. Luego llama a la herramienta `build` con `workspace_root` establecido en `workload-library-import`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `workload-library-import/dist/`.

Verificar la afirmación de identidad byte a byte

Sustituye el workload: { $import: … } de la Recipe por un bloque workload: | que contenga literalmente el cuerpo de StatelessService, vuelve a compilar y compara con diff los dos árboles dist/. Coinciden exactamente: la referencia de biblioteca se resuelve en el mismo texto de plantilla, evaluado en el mismo contexto de renderizado, así que la importación es una factorización de la superficie de autoría sin ningún efecto en los bytes renderizados.