Cette page a été traduite automatiquement. Lire l’original en anglais.

Component

core/ai-agent/agenta-migrations

The schema-migration step of an agent workspace — the run that creates and updates the platform's tables. It applies the migration history the platform ships to both of its databases: the one holding the platform's own model, and the one holding traces. It runs to completion and exits, which is what makes it a different operational shape from every other tier of this platform. It reaches the relational backend through the `backend` socket, using the two database names given on that edge, and it declares nothing else: the run reads no cache, takes no queue work, writes no files, and authenticates no user, so giving it a cache, queue, object-store or authentication socket would be declaring a dependency it does not have. Wire this in because the platform's services do not create their own tables. Without this run the databases stay empty and every service starts, connects, and then fails on its first query — a failure that reads as a broken installation rather than as a missing step, which is why the step is a declared component rather than something a reader is expected to remember. It serves no port and nothing connects to it, so it publishes no provides contract. Because it exits, an Aggregate sequences it ahead of the services that need the schema; it is written to be safe to run again, so re-running it on an already-migrated database applies nothing and succeeds. Realized on Kubernetes via its Helm Recipe, which synthesizes the step as a run-to-completion workload rather than a Deployment, running the platform image under its migration entry point.

Provenance

OfficielSigné par une identité de signature que ce catalogue reconnaît comme éditeur officiel.
Empreinte du contenu
sha256:9450af80a213a43551864c97867f66589819d956a4bac6391d19d7f2cb86fab7
Publié
2026-11-10T10:07:17Z
Identité de signature
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officielapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:8dd056cd777a5f7b2e7c157ceee295143ad361e8ead33cca8e3fa7c7cd843c78

Référence à cette version

oci://hub.aggrega.ai/component/core/ai-agent/agenta-migrations:1.0.0

Paramètres du développeur

Valeurs que le développeur définit dans l’Aggregate.

NomTypeValeur par défautObligatoireDescription
apply_on_startbooleantruenonApply any migration the databases are behind on. Turned off, the run reports what it would apply and changes nothing, which is how an installation that migrates its databases by another route keeps this step in place without it acting.

Dimensionnement de l’opérateur

Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.

NomTypeValeur par défautObligatoireDescription
engine_versionstringv0.114.1nonPlatform API container image tag. The migration history is shipped inside this image, so it is the same tag the services run and a Release moves them together.
log_levelstring (DEBUG | INFO | WARNING | ERROR | CRITICAL)INFOnonLog verbosity the run emits.
computeobject—non—
overridesobject (open)—nonProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contrat de sortie

Valeurs que ce composant publie vers les consommateurs via la topologie uses.

Aucune valeur de sortie déclarée.

Sockets uses

Les sockets de dépendance par lesquels ce composant se connecte. La cible de chaque connexion câblée via un socket doit satisfaire son sélecteur d’étiquettes, et chaque connexion peut porter une attache dans les emplacements que le socket déclare. Un emplacement obligatoire doit être rempli par chaque connexion que l’Aggregate ou la Release câble via le socket.

backend

Sélecteur
component.aggrega.ai/category=datastore
Injection
env

Emplacements que chaque connexion passant par ce socket peut remplir

EmplacementSélecteurObligatoireInjectionSensibleDescription
credentialfeature.aggrega.ai/kind=secretnonenvouiPassword the run authenticates to the relational backend this connection reaches with, delivered as an env secret reference and substituted into the connection URL at run time. The same credential is attached to the control-plane API's backend connection, because both reach the same server. Unattached, the Recipe emits the development literal `apppass`, the default the standard-library relational Recipes leave in place; this catalog publishes it, so every Release that leaves the slot unattached shares that password.

Emplacements d’attache

Points de liaison nommés auxquels une Feature s’attache à ce composant. Le sélecteur d’un emplacement restreint la Feature qui peut le remplir, et sa liste inject indique comment le matériel de la Feature peut être livré. Un emplacement obligatoire doit être lié sur chaque instance, par une attache sur l’instance ou à une portée supérieure, et un emplacement sensible est déclaré pour traiter du matériel secret. Une Feature peut aussi s’attacher sous un nom qu’aucun emplacement ne déclare.

Aucun emplacement d’attache déclaré.

Liste d’autorisation d’auto-injection

env

Relations

Arêtes typées vers et depuis d’autres entités publiées. Une référence sans cible publiée s’affiche comme une arête rompue plutôt que comme un lien.

Utilise

Utilisé par

Référence du concept Component →

Le catalogue Aggrega — un index ouvert de composants, de fonctionnalités, de recettes et des plugins qui en assurent le rendu.

Conçu avec le système de design partagé d’Aggrega.

Confidentialité