Bundles

Bundles .tgz-Artefakte

Was ist ein Bundle?

Ein Bundle ist ein .tgz‑Archiv mit:

deinen kompilierten Tool‑Implementierungen (dist/)
einer manifest.json mit Metadaten

Bundles sind organisations‑bezogen und werden über die CLI oder die Webapp hochgeladen. Die Plattform nutzt sie, um für jedes OS passende Connector‑Downloads zu erzeugen.

Bundles erstellen

edge-connector package \
  --implementations ./custom-implementations \
  --out ./artifacts

Dieser Befehl:

kompiliert TypeScript‑Implementierungen (falls nicht --no-build gesetzt ist),
sucht Tools in dist/tools/,
berechnet eine Checksumme des Distribution‑Verzeichnisses,
schreibt eine manifest.json,
erzeugt edge-bundle-<org>-<timestamp>.tgz im Ausgabeverzeichnis.

Manifest-Struktur

{
"schemaVersion": 1,
"orgId": "org_123",
"language": "typescript",
"tools": ["my_tool", "sync_customers"],
"builtAt": "2025-01-01T12:00:00.000Z",
"checksum": "..."
}

Bundles hochladen

Nutze den upload‑Befehl, um Bundles zur Plattform zu senden:

edge-connector upload \
  --file ./artifacts/edge-bundle-org-123.tgz \
  --api https://your-nara-webapp.example.com

Ohne --file kann upload zunächst das aktuelle Implementierungsverzeichnis packen und das resultierende Bundle direkt hochladen.