Actualizar Flosum CLI y la extensión DevOps-CLI

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.

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.

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.

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.

Antes de actualizar

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

1

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.

2

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.

3

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.

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.

Actualización de Flosum CLI

1

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.

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.

2

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.

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.

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

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

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

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.