> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-de/code/devops-cli/flosum-cli-und-devops-cli-erweiterung-aktualisieren.md).

# Flosum CLI und DevOps-CLI-Erweiterung aktualisieren

{% hint style="warning" %}

#### 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.
{% endhint %}

{% hint style="success" %}

#### 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.
{% endhint %}

## ![](https://578823411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Ü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.

{% hint style="warning" %}

#### 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.
{% endhint %}

## Vor dem Aktualisieren

{% hint style="info" %}
Die vollständigen Voraussetzungen finden Sie im Installationsartikel.

* [Flosum CLI Node.js-Paket installieren](/devops/devops-de/code/devops-cli/flosum-cli-node.js-paket-installieren.md)
  {% endhint %}

{% stepper %}
{% step %}

### 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.
{% endstep %}

{% step %}

### 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.
   {% endstep %}

{% step %}

### 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.

{% hint style="info" %}
Lassen Sie die Build-Tools installiert. Nicht jede Aktualisierung kompiliert die native Komponente neu, aber die, die dies tun, schlagen ohne sie fehl.
{% endhint %}
{% endstep %}
{% endstepper %}

## Die Flosum CLI aktualisieren

{% stepper %}
{% step %}

### 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`.

{% hint style="info" %}
Eine Aktualisierung ist in der Regel schneller als eine Erstinstallation. Rechnen Sie mit einer längeren Dauer, wenn die Version die native Komponente ändert.
{% endhint %}
{% endstep %}

{% step %}

### Ü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.
{% endstep %}
{% endstepper %}

## Die Erweiterung aktualisieren

Die **Flosum DevOps-CLI-Erweiterung** wird separat über **Visual Studio Code**installiert 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.

{% hint style="warning" %}
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 version`und prüfen Sie die Erweiterung in **Visual Studio Code**.

* [Flosum DevOps-CLI-Erweiterung installieren](/devops/devops-de/code/devops-cli/flosum-devops-cli-erweiterung-installieren.md)
  {% endhint %}

## Fehlerbehebung

<details>

<summary>Die Aktualisierung meldet Erfolg, aber flosum --version bleibt unverändert</summary>

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.x**meldet, 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.

</details>

<details>

<summary>Die Aktualisierung schlägt mit einem Build- oder Compilerfehler fehl</summary>

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.

{% hint style="info" %}
Eine fehlgeschlagene Aktualisierung hinterlässt dieselbe unvollständige Installation wie eine fehlgeschlagene Erstinstallation, daher gilt dieselbe Bereinigung.

* [Flosum CLI Node.js-Paket installieren](/devops/devops-de/code/devops-cli/flosum-cli-node.js-paket-installieren.md)
  {% endhint %}

</details>

<details>

<summary>Der flosum-Befehl funktioniert nach einer Aktualisierung nicht mehr</summary>

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.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-de/code/devops-cli/flosum-cli-und-devops-cli-erweiterung-aktualisieren.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
