CLI-Referenz

Die edge-connector-CLI verwaltet Authentifizierung, Code-Generierung für Tools, Bundle-Paketierung und -Upload, Bundle-Zuweisung sowie den Lebenszyklus des Cloud-Connectors. Der Aufruf von edge-connector ohne Argumente öffnet ein interaktives Menü mit denselben Funktionen.

auth

Authentifiziert die CLI gegenüber Ihrer nara-Organisation.

edge-connector auth

Flag	Beschreibung
`-t, --token <token>`	Übergibt ein JWT direkt oder einen Pfad zu einer Token-Datei. Muss gültig sein und Org-Informationen enthalten.
`-i, --interactive`	Interaktive Eingabe (Standard).
`-b, --browser`	Geräte-Code-Flow im Browser.

--token und --browser können nicht kombiniert werden.

generate

Alias: g. Erzeugt TypeScript-Implementierungsvorlagen für die EDGE-Tools Ihrer Organisation. Erfordert Authentifizierung; lädt die Tool-Definitionen vom Tool-RPC-Server.

edge-connector generate -t myTool

Flag	Beschreibung
`-l, --language`	Zielsprache (nur `typescript`).
`-t, --tool <name>`	Nur ein bestimmtes Tool generieren.
`-o, --output <path>`	Ausgabeverzeichnis (Standard `./custom-implementations`).
`-i, --interactive`	Interaktive Eingabe.

package

Baut und paketiert Tool-Implementierungen in ein Bundle-Archiv. Jedes Tool muss in einer eigenen Datei unter tools/ liegen — ein einzelner index.ts-Einstiegspunkt wird nicht mehr unterstützt. Die Ausgabe ist edge-bundle-<orgId>-<timestamp>.tgz mit manifest.json und dist/.

edge-connector package

Flag	Beschreibung
`-i, --implementations <path>`	Verzeichnis der Implementierungen (Standard `./custom-implementations`).
`-o, --out <dir>`	Ausgabeverzeichnis (Standard `./artifacts`).
`--no-build`	Build-Schritt überspringen.

upload

Paketiert (sofern nicht -f angegeben ist) und lädt ein Bundle auf die Plattform hoch. Die maximale Bundle-Größe beträgt 50 MB. Ein erfolgreicher Upload aktualisiert currentBundleId.

edge-connector upload

Flag	Beschreibung
`-f, --file <tgz>`	Vorhandenes Bundle-Archiv hochladen.
`-i, --interactive`	Interaktive Eingabe.
`--no-build`	Build-Schritt überspringen.
`--api <url>`	Plattform-API-URL überschreiben.
`--name <text>`	Bundle-Name.
`--notes <text>`	Bundle-Notizen.

bundle

Verwaltet Tool-Bundles. Alle Unterbefehle akzeptieren --api <url>.

Unterbefehl	Beschreibung
`bundle list`	Bundles Ihrer Organisation auflisten.
`bundle checkout [id]`	Ein Bundle lokal auschecken; `--new` beginnt ein neues Bundle.
`bundle status`	Aktuell ausgechecktes Bundle anzeigen.
`bundle tools`	Tools im aktuellen Bundle auflisten.
`bundle ref <tool> --version <n>`	Serverseitig gehostete Tool-Version referenzieren statt lokaler Quellen.
`bundle set-default <id>`	Standard-Bundle der Organisation festlegen.
`bundle assign <id> --deployment <id> [--version <n>]`	Bundle einem Deployment zuweisen, optional auf eine Version gepinnt.
`bundle rename <id> <name>`	Bundle umbenennen.

cloud

Verwaltet den Cloud-Connector Ihrer Organisation (über /api/edge/cloud/*).

Unterbefehl	Beschreibung
`cloud provision --env <dev\|stage\|prod>`	Cloud-Connector bereitstellen.
`cloud start`	Cloud-Connector starten.
`cloud stop`	Cloud-Connector stoppen.
`cloud status`	Status des Connectors anzeigen.
`cloud force-complete`	Ausstehende Operation zwangsweise abschließen.
`cloud delete`	Cloud-Connector löschen.