> 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/instalacion-de-la-extension-flosum-devops-cli.md).
# Instalación de la extensión Flosum 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 %}
##  Descripción general
Este artículo explica cómo instalar la extensión Flosum DevOps-CLI para Visual Studio Code (VS Code). La extensión le ayuda a trabajar en proyectos DevOps proporcionando acceso directo a los comandos de Flosum CLI en VS Code mediante una interfaz fácil de usar. Para obtener más información sobre DevOps CLI y cómo usarla, consulte los siguientes artículos.
* [Información general de DevOps CLI en VS Code](/devops/devops-es/codigo/devops-cli/informacion-general-de-devops-cli-en-vs-code.md)
* [Uso de DevOps CLI en VS Code](/devops/devops-es/codigo/devops-cli/uso-de-devops-cli-en-vs-code.md)
La extensión ejecuta Flosum CLI, que se instala por separado. Instale primero Flosum CLI y luego instale la extensió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)
## Requisitos previos
{% stepper %}
{% step %}
### Flosum CLI
Flosum CLI debe estar instalado antes de poder usar la extensión. Tiene sus propios requisitos previos, incluida una versión específica de Node.js y una cadena de herramientas de compilación de C++.
1. Complete la instalación descrita en el siguiente artículo.
2. Confirme que `flosum --version` devuelve un número de versión y tómelo en cuenta.
{% hint style="info" %}
Las instrucciones completas, los requisitos previos y la solución de problemas para la CLI están en un artículo aparte.
* [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 %}
{% endstep %}
{% step %}
### Visual Studio Code
1. Confirme que está ejecutando **Visual Studio Code** la versión **1.106.0** o posterior.
2. Seleccione **Ayuda > Buscar actualizaciones** e instale cualquier actualización disponible antes de continuar.
{% endstep %}
{% endstepper %}
## Instalar la extensión DevOps-CLI
{% stepper %}
{% step %}
### Instalar la extensión Flosum DevOps-CLI
1. Inicie VS Code.
2. Abra la vista Extensiones seleccionando el **icono Extensiones** en la barra de actividades.
3. En el **cuadro de búsqueda** escriba **Flosum DevOps-CLI Extension**.
4. Haga clic en **Instalar** para **Flosum DevOps-CLI Extension**.
5. Haga clic en **Confiar en el editor e instalar** para confirmar.
6. Si la extensión Flosum DevOps-CLI se instala correctamente, verá el **Flosum** iniciador de la paleta de comandos en el lado izquierdo de la **barra de estado**.
{% hint style="info" %}
#### Paleta de comandos de Flosum
Para acceder a la **Paleta de comandos de Flosum**, asegúrese de que la **Barra de estado** en VS Code sea visible. Controle su visibilidad a través de **Vista** > **Apariencia** > **Barra de estado**.
{% endhint %}
{% endstep %}
{% step %}
### Verificar que ambos estén actualizados
1. En el **icono Extensiones** vista, confirme que la **Flosum DevOps-CLI Extension** no muestra actualizaciones disponibles.
2. En una terminal, compare la CLI de Flosum instalada con la versión publicada más reciente:
```
flosum --version
npm view @flosum/cli version
```
{% hint style="warning" %}
#### Reiniciar Visual Studio Code si no se encuentra flosum
Si la terminal informa que `flosum` no se encuentra, cierre **Visual Studio Code** por completo y vuelva a abrirlo; luego intente de nuevo. Abrir una nueva pestaña de terminal no funciona porque **Visual Studio Code** solo lee su **PATH** cuando se inicia.
{% endhint %}
{% hint style="warning" %}
#### Mantenga ambos actualizados, pero no compare sus versiones
La extensión y Flosum CLI se numeran de forma independiente. Sus números de versión no son los mismos y no están pensados para coincidir, así que compruebe cada uno con su propia fuente en lugar de compararlos entre sí.
Flosum CLI no se actualiza por sí sola, por lo que queda desactualizada mientras la extensión se actualiza automáticamente a través de Visual Studio Code. La causa más común de que la CLI esté desactualizada es instalarla en una versión de Node.js distinta de 22, lo que instala una versión anterior sin informar de ningún error. Las versiones anteriores no admiten el Flosum DevOps actual y no funcionarán.
{% endhint %}
{% endstep %}
{% endstepper %}
## Solución de problemas
El iniciador de Flosum no aparece en la barra de estado
1. Seleccione **Ver > Apariencia > Barra de estado** y confirme que el **barra de estado** está activado.
2. En el **icono Extensiones** vista, confirme que **Flosum DevOps-CLI Extension** está instalado y habilitado.
3. Recargue la ventana seleccionando **Desarrollador: Recargar ventana** en la paleta de comandos.
Flosum CLI es una versión anterior a la publicada
La extensión y la CLI se numeran de forma independiente, por lo que se espera que haya una diferencia entre sus números de versión y no es un problema. En su lugar, compare la CLI con la versión publicada:
```
flosum --version
npm view @flosum/cli version
```
Si `flosum --version` muestra el número más bajo, la CLI está desactualizada.
1. Ejecute `node --version` y confirme que informa **v22.x**.
2. Si no es así, instale **Node.js 22** como se describe en el artículo de la CLI.
3. Elimine la CLI existente, vuelva a instalarla y luego compare de nuevo los dos comandos.
{% hint style="info" %}
Instalar la CLI en **Node.js 24** instala silenciosamente una versión anterior sin informar de un error. Esta es la razón más común por la que la CLI queda desactualizada.
* [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 %}
Los comandos de la extensión fallan aunque la extensión esté instalada
La extensión ejecuta Flosum CLI, por lo que un problema con la CLI aparece como un comando de la extensión que falla.
1. Abra una terminal en **Visual Studio Code** y ejecute `flosum --version`.
2. Si el comando no se encuentra, cierre **Visual Studio Code** por completo, vuelva a abrirlo y ejecute el comando de nuevo. Esto lo resuelve en la mayoría de los casos, porque el editor solo detecta **PATH** los cambios cuando se inicia.
3. Si todavía no se encuentra, abra una terminal fuera de **Visual Studio Code** y ejecute el mismo comando. Que allí aparezca un número de versión significa que el editor se está ejecutando con un entorno desactualizado. Si no aparece ningún número de versión, significa que la CLI no está instalada correctamente.
4. Si el comando informa de un módulo que falta, la instalación de la CLI no se completó. Siga los pasos de solución de problemas del artículo de la CLI.
---
# 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/instalacion-de-la-extension-flosum-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.
