Installation

Installieren Sie Integration CLI über den von Optimus für Ihre Umgebung bereitgestellten Distributionskanal. Nach der Installation sollte der Befehl als optimus verfügbar sein.

Installation prüfen:

optimus --version

Unter Windows heißt die ausführbare Datei optimus.exe:

.\optimus.exe --version

Befehlshilfe anzeigen:

optimus --help
optimus check --help

Runtime-Anforderungen

Die CLI wird aus einem .NET 9 Projekt gebaut.

Aktuelle Release-Builds werden als self-contained Single-File-Anwendungen veröffentlicht. Die .NET Runtime ist in die veröffentlichte ausführbare Datei eingebettet, sodass die Zielmaschine für das veröffentlichte CLI-Artefakt keine separate .NET-Installation benötigt.

Es ist kein Installer erforderlich. Legen Sie die ausführbare Datei in einen Ordner, auf den Ihre Automatisierung zugreifen kann, und führen Sie sie von dort aus.

Endbenutzer müssen das Projektlayout normalerweise nicht kennen, aber das Quellprojekt ist:

api/tools/Optimus.Cli/Optimus.Cli.csproj

Betriebssystem

Wählen Sie das Paket, das zum Zielbetriebssystem und zur CPU-Architektur passt.

Paket	Ausführbare Datei	Ziel
optimus-cli-<version>-linux-x64.tar.gz	optimus	64-bit Linux
optimus-cli-<version>-win-x64.tar.gz	optimus.exe	64-bit Windows
optimus-cli-<version>-osx-x64.tar.gz	optimus	macOS auf Intel
optimus-cli-<version>-osx-arm64.tar.gz	optimus	macOS auf Apple Silicon

Jedes Paket enthält außerdem:

optimus-cli-<version>-<runtime>.sha256
manifest.json

Verwenden Sie die Checksum-Datei, um das heruntergeladene Archiv zu prüfen, wenn Ihr Installationsprozess Integritätsprüfungen verlangt.

Verwenden Sie kein Paket für eine andere Runtime. Zum Beispiel läuft das linux-x64-Paket nicht unter Windows, und das osx-x64-Paket ist nicht das Apple-Silicon-Paket.

Netzwerkanforderungen

Die CLI benötigt ausgehenden HTTPS-Zugriff auf Port 443 zum Optimus API Host, der für den Lauf ausgewählt wurde.

Umgebung	Host
Produktion	app.optimussoftware.de
Test	dev.app.optimussoftware.de

Wenn Firewall, Allowlist oder Proxy verwendet werden, erlauben Sie den Host für die Umgebung, gegen die Sie ausführen.

Wenn --base-url oder OPTIMUS_BASE_URL gesetzt ist, erlauben Sie stattdessen den Custom Host.

Die CLI verwendet den Standard-.NET-HTTP-Stack. In typischen Umgebungen folgt das Proxy-Verhalten der Betriebssystem- oder Umgebungs-Proxy-Konfiguration.

Aktualisieren

Wenn Optimus eine neuere CLI-Version bereitstellt, ersetzen Sie die installierte Binary oder das Paket und prüfen Sie die Version erneut:

optimus --version

Wenn ein Befehlsbeispiel aus dieser Dokumentation mit Ihrer installierten Version nicht funktioniert, prüfen Sie zuerst die installierte Version.