> 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-es/codigo/devops-cli/actualizar-flosum-cli-y-la-extension-devops-cli.md).
# Actualizar Flosum CLI y la extensión DevOps-CLI
{% hint style="warning" %}
#### Problemas conocidos: actualización requerida
**Se requiere una actualización.** La versión actual de Flosum DevOps requiere las últimas versiones de Flosum CLI (**@flosum/cli** paquete) y el **Flosum DevOps-CLI Extension**. Las versiones anteriores de CLI no admiten topologías y no pueden funcionar con un tenant de DevOps que las use, por lo que las instalaciones existentes deben actualizarse.
**Se requiere Node.js 22.** En **Node.js 24**, los comandos de instalación y actualización parecen completarse con éxito, pero te dejan en una versión anterior. Cambia a Node.js 22 antes de instalar o actualizar.
{% endhint %}
{% hint style="success" %}
#### Compatibilidad con el sistema operativo
**Flosum CLI** y **Extensión Flosum DevOps-CLI** son compatibles con los siguientes sistemas operativos:
* **macOS**
* **Linux**
Estas herramientas actualmente no están diseñadas para funcionar con Windows.
{% endhint %}
##  Resumen
Este artículo explica cómo actualizar una instalación existente de Flosum CLI a la versión más reciente.
Flosum CLI permanece en la versión que instalaste hasta que ejecutas el comando de actualización, por lo que una instalación funcional puede quedar desactualizada sin ninguna indicación de que existe una versión más reciente.
La actualización usa el mismo comando que la instalación. Sin embargo, debes comprobar tu versión de Node.js antes de ejecutarlo.
{% hint style="warning" %}
#### Confirma tu versión de Node.js antes de actualizar
Ejecuta `node --version` y confirma que informa **v22.x** antes de actualizar nada.
En cualquier otra versión de Node.js, el comando de actualización reemplazará tu instalación funcional con una versión anterior sin informar de ningún error.
{% endhint %}
## Antes de actualizar
{% hint style="info" %}
Las instrucciones completas de los requisitos previos están en el artículo de instalación.
* [Instalación del paquete Node.js de Flosum CLI](/devops/devops-es/codigo/devops-cli/instalacion-del-paquete-node.js-de-flosum-cli.md)
{% endhint %}
{% stepper %}
{% step %}
### Anota tu versión de Flosum CLI
1. Registra la versión desde la que estás actualizando:
```
flosum --version
```
2. Comprueba la última versión publicada:
```
npm view @flosum/cli version
```
Si ambos muestran la misma versión, ya estás al día y no hace falta actualizar.
{% endstep %}
{% step %}
### Confirma Node.js y npm
1. Ejecuta los siguientes comandos:
```
node --version
npm --version
```
2. Confirma que `node --version` informa **v22.x** y que `npm --version` informa **10.x**.
3. Si alguno es diferente, corrígelo antes de continuar. El artículo de instalación explica los requisitos previos de Node.js y npm.
{% endstep %}
{% step %}
### Confirma que las herramientas de compilación siguen presentes
Flosum CLI incluye un componente nativo. Cuando una versión cambia ese componente, la actualización lo recompila y necesita **Python 3** y un **compilador de C++**.
1. Confirma **Python 3** está disponible:
```
python3 --version
```
2. Confirma que el compilador de C++ sigue instalado.
{% hint style="info" %}
Mantén instaladas las herramientas de compilación. No todas las actualizaciones recompilan el componente nativo, pero las que sí lo hacen fallarán sin ellas.
{% endhint %}
{% endstep %}
{% endstepper %}
## Actualización de Flosum CLI
{% stepper %}
{% step %}
### Ejecuta el comando de actualización
1. Abre una terminal.
2. Ejecuta el mismo comando usado para instalar la CLI:
```
npm i -g @flosum/cli
```
3. Espera a que el comando termine. Informará del número de paquetes que cambió, por ejemplo `changed 1656 packages`.
{% hint style="info" %}
Una actualización suele ser más rápida que una primera instalación. Tardará más cuando la versión cambie el componente nativo.
{% endhint %}
{% endstep %}
{% step %}
### Verifica la actualización
1. Ejecuta los siguientes comandos:
```
flosum --version
npm view @flosum/cli version
```
2. Confirma que ambos muestran la misma versión.
Si `flosum --version` sigue mostrando la versión anterior, la actualización no surtió efecto. Consulta Solución de problemas.
{% endstep %}
{% endstepper %}
## Actualización de la extensión
La **La extensión Flosum DevOps-CLI** se instala y actualiza por separado a través de **Visual Studio Code**, en lugar de mediante este comando.
1. En **Visual Studio Code**, abre la **Extensiones** vista.
2. Selecciona **La extensión Flosum DevOps-CLI** y confirma que no hay ninguna actualización disponible.
{% hint style="warning" %}
La extensión y Flosum CLI tienen cada una su propio número de versión. Los dos números no son iguales y no se supone que coincidan, así que comprueba cada uno en su propia fuente. Compara la CLI con `npm view @flosum/cli version`, y comprueba si hay una actualización disponible de la extensión en **Visual Studio Code**.
* [Instalación de la extensión Flosum DevOps-CLI](/devops/devops-es/codigo/devops-cli/instalacion-de-la-extension-flosum-devops-cli.md)
{% endhint %}
## Solución de problemas
La actualización informa de éxito, pero flosum --version no cambia
El comando de actualización instaló una versión anterior, algo que npm hace cuando tu versión de Node.js no coincide con la requerida por la última versión.
1. Ejecuta `node --version`.
2. Si no informa de **v22.x**instala **Node.js 22** como se describe en el artículo de instalación.
3. Vuelve a ejecutar el comando de actualización.
4. Compara `flosum --version` con `npm view @flosum/cli version` una vez más.
La actualización falla con un error de compilación o del compilador
La versión cambió el componente nativo, por lo que la actualización intentó recompilarlo y faltan las herramientas de compilación o están incompletas.
1. Completa el requisito previo de **Build Tools** en el artículo de instalación.
2. Elimina la instalación parcial usando los pasos de limpieza de ese artículo.
3. Vuelve a ejecutar el comando de actualización.
{% hint style="info" %}
Una actualización fallida deja la misma instalación parcial que una primera instalación fallida, así que se aplica la misma limpieza.
* [Instalación del paquete Node.js de Flosum CLI](/devops/devops-es/codigo/devops-cli/instalacion-del-paquete-node.js-de-flosum-cli.md)
{% endhint %}
El comando flosum deja de funcionar después de una actualización
La actualización no se completó, dejando los accesos directos de comandos en su lugar pero sin los archivos a los que apuntan.
1. Elimina la instalación por completo usando los pasos de limpieza del artículo de instalación.
2. Confirma que `flosum --version` informa `command not found`.
3. Instala la CLI de nuevo.
---
# 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-es/codigo/devops-cli/actualizar-flosum-cli-y-la-extension-devops-cli.md?ask=&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.