aggrega push-artifact
Publier un artefact de données autonome (tel qu’un lot de documentation) dans un registry OCI
Synopsis
aggrega push-artifact <file> [flags]Description
Publish a standalone data artifact — a documentation bundle or any other non-entity blob — to an OCI registry under the reserved docs/ namespace. Unlike push, which bundles a catalog entity and dispatches on its kind, push-artifact carries opaque bytes: it reads the file, packs it under the given media type (defaulting to the documentation-bundle media type), and tags it at docs/<name>:<tag>. The published artifact is signed separately by reference with aggrega sign. Beside it, push-artifact states when it published, as a small published-at attachment carrying this machine's clock in UTC to the second; the attachment moves no digest and changes no tag.Options
| Option | Par défaut | Description |
|---|---|---|
--dry-run | false | Calcule la référence et affiche le |
--media-type | application/vnd.aggrega.docs.v1beta1+tar+gz | Type de média de l’artefact OCI ; par défaut, le type de média du bundle de documentation |
--name | — | Nom de l’artefact dans l’espace de noms réservé docs/ (par ex. « aggrega-docs » publie dans docs/aggrega-docs) |
--registry | — | Hôte du registre de destination (remplace le default_registry du workspace) |
--tag | — | Tag de version sous lequel publier l’artefact (obligatoire) |
L’artefact du bundle de documentation
Un bundle de documentation est un artefact de données autonome — une archive tar compressée avec gzip de documentation rendue — plutôt qu’une entité de catalogue. Il porte le type de média application/vnd.aggrega.docs.v1beta1+tar+gz, qui est le type d’artefact qu’un consommateur voit lorsqu’il récupère le bundle depuis le registre.
Les bundles sont publiés sous le segment de dépôt docs/ : --name aggrega-docs place l’artefact dans docs/aggrega-docs, et --tag sélectionne la version, de sorte que la coordonnée de pull est <registry>/docs/<name>:<tag> — par exemple, hub.aggrega.ai/docs/aggrega-docs:1.0.0. Comme le bundle est un simple artefact de données et non une entité de catalogue, il est récupéré avec n’importe quel client compatible OCI à l’aide de cette référence et de ce type de média. Le fichier publié porte le nom donné avec --name, de sorte qu’un client qui écrit les fichiers par nom l’écrit sous ce nom : oras pull hub.aggrega.ai/docs/aggrega-docs:1.0.0 laisse aggrega-docs dans le répertoire courant, octet pour octet tel qu’il a été publié.
Lorsque le registre fait échouer une écriture
La publication écrit dans le registre par étapes — le fichier, le manifeste qui le nomme, le tag, puis la date de publication à côté — et chacune de ces écritures est retentée lorsque le registre ou le réseau la fait échouer d’une manière qui permet à une tentative ultérieure de réussir, comme une erreur serveur, un délai d’expiration ou une connexion réinitialisée ; aggrega push liste ces échecs. Une écriture est tentée au plus trois fois, à une demi-seconde puis à une seconde d’intervalle, et chaque tentative est un nouvel envoi des mêmes octets plutôt qu’un renvoi de la requête qui a échoué, de sorte qu’une écriture retentée dépose ce qu’une seule tentative aurait déposé.
Une écriture qui échoue encore après sa dernière tentative fait échouer la commande, et l’erreur nomme l’étape. Un échec de l’ajout de la date survient après que l’artefact a été déposé : l’artefact reste publié, et la commande se termine avec un code non nul en indiquant que sa date de publication n’a pas pu être ajoutée. Exécuter à nouveau la même publication la termine : l’artefact est signalé comme déjà publié, rien n’est envoyé, et la date est ajoutée là où l’artefact n’en porte aucune, indiquant l’horloge de cette exécution — le moment où la publication a été terminée. Un artefact qui indique déjà une date ne reçoit rien, et une liste qui ne peut pas être lue se termine avec un code non nul sans rien ajouter.
Hors ligne
Publier un artefact implique un aller-retour réseau ; en mode hors ligne — la clé de premier niveau offline dans un fichier de configuration, AGGREGA_OFFLINE ou --offline —, cette commande refuse donc avant de lire le fichier, et le refus nomme lequel de ces trois éléments a activé le mode. --dry-run continue de fonctionner, car il calcule la référence et n’effectue aucun appel. Pour publier le temps d’une exécution depuis un workspace hors ligne, passez --offline=false.
Voir aussi
- ./aggrega-sign.md — un artefact de données est signé après coup, par référence ; cette commande n’ajoute aucune signature qui lui soit propre.
- ./aggrega-serve.md — le daemon propose la même publication sur
aggrega/publishArtifact, de sorte qu’un éditeur peut l’exécuter sans quitter la session. - ./aggrega-mcp.md — la même capacité sous la forme de l’outil
publish-artifact, qu’un assistant peut appeler. Lisez ce que cette page dit de son autorisation avant de l’autoriser.