Flosum CLI und DevOps-CLI-Erweiterung aktualisieren

Bekannte Probleme: Erforderliches Update

Ein Update ist erforderlich. Die aktuelle Version von Flosum DevOps erfordert die neuesten Versionen der Flosum CLI (@flosum/cli Paket) und der Flosum DevOps-CLI-Erweiterung. Frühere CLI-Versionen unterstützen keine Topologien und können nicht mit einem DevOps-Tenant arbeiten, der sie verwendet, daher müssen vorhandene Installationen aktualisiert werden.

Node.js 22 ist erforderlich. Bei Node.js 24, scheinen die Installations- und Aktualisierungsbefehle zwar erfolgreich zu sein, belassen Sie jedoch auf einer früheren Version. Wechseln Sie vor der Installation oder Aktualisierung zu Node.js 22.

Kompatibilität mit Betriebssystemen

Flosum CLI und Flosum DevOps-CLI-Erweiterung sind mit den folgenden Betriebssystemen kompatibel:

• macOS
• Linux

Diese Tools sind derzeit nicht für die Verwendung mit Windows vorgesehen.

Überblick

Dieser Artikel erklärt, wie Sie eine vorhandene Flosum-CLI-Installation auf die neueste Version aktualisieren.

Die Flosum CLI bleibt auf der von Ihnen installierten Version, bis Sie den Aktualisierungsbefehl ausführen. Daher kann eine funktionierende Installation veraltet werden, ohne dass ein Hinweis darauf erscheint, dass eine neuere Version verfügbar ist.

Für das Aktualisieren wird derselbe Befehl wie für die Installation verwendet. Allerdings sollten Sie vor dem Ausführen Ihre Node.js-Version überprüfen.

Bestätigen Sie Ihre Node.js-Version, bevor Sie aktualisieren

Führen Sie aus node --version und bestätigen Sie, dass ausgegeben wird v22.x bevor Sie etwas aktualisieren.

Bei jeder anderen Node.js-Version ersetzt der Aktualisierungsbefehl Ihre funktionierende Installation durch eine ältere Version, ohne Fehler zu melden.

Vor dem Aktualisieren

Die vollständigen Voraussetzungen finden Sie im Installationsartikel.

• Flosum CLI Node.js-Paket installieren

1

Notieren Sie Ihre Flosum-CLI-Version

1. Notieren Sie die Version, von der Sie aktualisieren:

   flosum --version

2. Prüfen Sie die neueste veröffentlichte Version:

   npm view @flosum/cli version

Wenn beide dieselbe Version melden, sind Sie bereits auf dem neuesten Stand, und es ist keine Aktualisierung erforderlich.

2

Bestätigen Sie Node.js und npm

1. Führen Sie die folgenden Befehle aus:

   node --version
   npm --version

2. Bestätigen Sie, dass node --version meldet v22.x und dass npm --version meldet 10.x.
3. Wenn einer von beiden anders ist, korrigieren Sie das, bevor Sie fortfahren. Der Installationsartikel erklärt die Voraussetzungen für Node.js und npm.

3

Bestätigen Sie, dass die Build-Tools noch vorhanden sind

Die Flosum CLI enthält eine native Komponente. Wenn eine Version diese Komponente ändert, kompiliert die Aktualisierung sie neu und benötigt Python 3 und einen C++-Compiler.

1. Bestätigen Sie, dass Python 3 verfügbar ist:

   python3 --version

2. Bestätigen Sie, dass der C++-Compiler noch installiert ist.

Lassen Sie die Build-Tools installiert. Nicht jede Aktualisierung kompiliert die native Komponente neu, aber die, die dies tun, schlagen ohne sie fehl.

Die Flosum CLI aktualisieren

1

Führen Sie den Aktualisierungsbefehl aus

1. Öffnen Sie ein Terminal.
2. Führen Sie denselben Befehl aus, der zur Installation der CLI verwendet wurde:

   npm i -g @flosum/cli

3. Warten Sie, bis der Befehl abgeschlossen ist. Er meldet die Anzahl der Pakete, die geändert wurden, zum Beispiel 1656 Pakete geändert.

Eine Aktualisierung ist in der Regel schneller als eine Erstinstallation. Rechnen Sie mit einer längeren Dauer, wenn die Version die native Komponente ändert.

2

Überprüfen Sie die Aktualisierung

1. Führen Sie die folgenden Befehle aus:

   flosum --version
   npm view @flosum/cli version

2. Bestätigen Sie, dass beide dieselbe Version melden.

Wenn flosum --version immer noch die frühere Version meldet, wurde die Aktualisierung nicht wirksam. Siehe Fehlerbehebung.

Die Erweiterung aktualisieren

Die Flosum DevOps-CLI-Erweiterung wird separat über Visual Studio Codeinstalliert und aktualisiert, nicht über diesen Befehl.

1. In Visual Studio Codeöffnen Sie die Erweiterungen Ansicht.
2. Wählen Sie Flosum DevOps-CLI-Erweiterung und bestätigen Sie, dass keine Aktualisierung verfügbar ist.

Die Erweiterung und die Flosum CLI haben jeweils ihre eigene Versionsnummer. Die beiden Nummern sind nicht gleich und sollen es auch nicht sein. Prüfen Sie daher jede anhand ihrer eigenen Quelle. Vergleichen Sie die CLI mit npm view @flosum/cli versionund prüfen Sie die Erweiterung in Visual Studio Code.

• Flosum DevOps-CLI-Erweiterung installieren

Fehlerbehebung

Die Aktualisierung meldet Erfolg, aber flosum --version bleibt unverändert

Der Aktualisierungsbefehl hat eine ältere Version installiert, was npm tut, wenn Ihre Node.js-Version nicht mit der von der neuesten Version benötigten übereinstimmt.

1. Führen Sie aus node --version.
2. Wenn es nicht v22.xmeldet, installieren Sie Node.js 22 wie im Installationsartikel beschrieben.
3. Führen Sie den Aktualisierungsbefehl erneut aus.
4. Vergleichen Sie flosum --version mit npm view @flosum/cli version noch einmal.

Die Aktualisierung schlägt mit einem Build- oder Compilerfehler fehl

Die Version hat die native Komponente geändert, daher hat die Aktualisierung versucht, sie neu zu kompilieren, und die Build-Tools fehlen oder sind unvollständig.

1. Erfüllen Sie die Build-Tools Voraussetzung im Installationsartikel.
2. Entfernen Sie die unvollständige Installation mithilfe der Bereinigungsschritte in diesem Artikel.
3. Führen Sie den Aktualisierungsbefehl erneut aus.

Eine fehlgeschlagene Aktualisierung hinterlässt dieselbe unvollständige Installation wie eine fehlgeschlagene Erstinstallation, daher gilt dieselbe Bereinigung.

• Flosum CLI Node.js-Paket installieren

Der flosum-Befehl funktioniert nach einer Aktualisierung nicht mehr

Die Aktualisierung wurde nicht abgeschlossen, sodass die Befehlsverknüpfungen bestehen blieben, ohne dass die Dateien vorhanden sind, auf die sie verweisen.

1. Entfernen Sie die Installation vollständig mithilfe der Bereinigungsschritte im Installationsartikel.
2. Bestätigen Sie, dass flosum --version meldet Befehl nicht gefunden.
3. Installieren Sie die CLI erneut.