> 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/uso-de-devops-cli-en-vs-code.md).

# Uso de DevOps CLI en VS Code

{% 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 %}

## ![](https://2574462044-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) Descripción general

Este artículo le muestra cómo usar la extensión CLI de DevOps en Visual Studio Code (VS Code) para acceder a los comandos disponibles. Las secciones siguientes explican cada comando y proporcionan instrucciones para usarlos. Los comandos disponibles dependen de si actualmente hay un proyecto de DevOps abierto en VS Code: algunos solo funcionan dentro de un proyecto de DevOps, mientras que otros se usan para crear uno. Los comandos se dividen en las siguientes secciones:

* **Comandos \[Sin proyecto DevOps abierto]**
* **Comandos \[Proyecto DevOps abierto]**

{% hint style="info" %}

#### Prácticas recomendadas

* Use alias claros para las credenciales de inicio de sesión del inquilino DevOps, como `prod-admin`, `sandbox-dev`, o `customer-xyz`, para facilitar el cambio.
* Cuando sea posible, use el **Clonar proyecto DevOps** comando al iniciar un proyecto, ya que configura automáticamente las credenciales del proyecto.
* Ejecute **Obtener rama** antes de confirmar para evitar enviar cambios desactualizados.
* Use **Ver cambios pendientes** antes de confirmar para comprobar exactamente qué se enviará.
* Si los comandos de DevOps dejan de funcionar, confirme que su proyecto sigue teniendo configuradas las credenciales correctas para conectarse a su inquilino de DevOps. Si es necesario, ejecute de nuevo el **Iniciar sesión** comando.
  {% endhint %}

## Acceder a la paleta de comandos de Flosum

{% 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 %}

1. Haga clic en el **Flosum** iniciador de la paleta de comandos en el lado izquierdo de la barra de estado. 

   <div align="left"><figure><img src="https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FLbznZ4Lo3O3PF1sHiIUc%2FUsingDevopsCli-AccessCommands-01.png?alt=media&amp;token=04e5d54a-e3e1-40c3-9fc8-0a94a2b25c9d" alt="" width="563"><figcaption></figcaption></figure></div>
2. La **Paleta de comandos de Flosum** se abre en la parte superior de la ventana de VS Code.
3. Los comandos disponibles varían según si hay un proyecto DevOps abierto.
   1. Paleta de comandos de Flosum sin un proyecto DevOps abierto.&#x20;

      <div align="left"><figure><img src="https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FNb1JhXYvE94m2ZGlIkv2%2FUsingDevopsCli-AccessCommands-02.png?alt=media&amp;token=52f44be6-2698-4f03-80cb-f8093e1d92dc" alt="" width="563"><figcaption></figcaption></figure></div>
   2. Paleta de comandos de Flosum con un proyecto DevOps abierto.&#x20;

      <div align="left"><figure><img src="https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FPZnDmQvukayJWF3JD8kr%2FUsingDevopsCli-AccessCommands-03.png?alt=media&amp;token=6f67ce54-9f70-498f-84a4-36b76e25ad9f" alt="" width="563"><figcaption></figcaption></figure></div>

## Comandos \[Sin proyecto DevOps abierto]

<table><thead><tr><th width="220">Comando</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>Iniciar sesión</strong></td><td>Este comando crea credenciales para conectarse a su inquilino de DevOps.</td></tr><tr><td><strong>Cerrar sesión</strong></td><td>Este comando elimina las credenciales seleccionadas de la extensión DevOps CLI.</td></tr><tr><td><strong>Inicializar proyecto DevOps</strong></td><td>Este comando inicializa un proyecto de Salesforce vacío con los archivos del sistema de Flosum CLI. </td></tr><tr><td><strong>Clonar proyecto DevOps</strong></td><td>Este comando inicializa un proyecto de Salesforce y clona la <strong>main</strong> rama de su inquilino de DevOps.</td></tr></tbody></table>

### <img src="https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media&amp;token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f" alt="" data-size="original"> Flosum: Iniciar sesión

Este comando crea credenciales con un token de API generado en la aplicación Flosum Global Settings. Las credenciales se usan para conectarse a su inquilino de DevOps. Para obtener instrucciones sobre cómo crear un token de API, consulte el siguiente artículo.

* [Crear un token de API](/global-settings/global-settings-docs-es/seguridad/tokens-de-api/crear-un-token-de-api.md)

{% hint style="warning" %}
Asegúrese de copiar su token de API al portapapeles antes de iniciar el proceso de inicio de sesión, ya que hacer clic fuera de VS Code cerrará la Paleta de comandos.
{% endhint %}

Puede tener varias credenciales de inicio de sesión. Cuando inicia sesión, se le solicita que introduzca un alias para la credencial para ayudar a distinguirla de las demás. El alias no afecta a la autenticación, así que lo mejor es elegir un nombre que indique a qué inquilino pertenece la credencial.

{% @arcade/embed flowId="T1syWzv6kmyCpTkzpl5I" url="<https://app.arcade.software/share/T1syWzv6kmyCpTkzpl5I>" %}

***

### <img src="https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media&amp;token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f" alt="" data-size="original"> Flosum: Cerrar sesión

Este comando elimina las credenciales seleccionadas de la extensión DevOps CLI. Las credenciales se pueden agregar de nuevo mediante el comando Iniciar sesión.

{% @arcade/embed flowId="MSu0Yw4Cs62MdPXK0s6i" url="<https://app.arcade.software/share/MSu0Yw4Cs62MdPXK0s6i>" %}

***

### <img src="https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media&amp;token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f" alt="" data-size="original"> Flosum: Inicializar proyecto DevOps

Este comando inicializa un proyecto de Salesforce vacío con los archivos del sistema de Flosum CLI.&#x20;

{% hint style="info" %}
Cuando se inicializa este proyecto, no hay credenciales asociadas a él. Después de crear el proyecto, ejecute el **Flosum: Iniciar sesión** comando desde dentro del proyecto para conectarse al inquilino de DevOps deseado. Consulte el [#flosum-login-1](#flosum-login-1 "mention") comando para obtener más detalles.
{% endhint %}

{% @arcade/embed flowId="Sacd0bJ17dHMJiwPIUhH" url="<https://app.arcade.software/share/Sacd0bJ17dHMJiwPIUhH>" %}

***

### <img src="https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media&amp;token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f" alt="" data-size="original"> Flosum: Clonar proyecto DevOps

Este comando inicializa un proyecto de Salesforce y usa las credenciales de inicio de sesión seleccionadas para clonar la **main** rama de su inquilino de DevOps.

{% hint style="info" %}
El inquilino de DevOps al que se conecta lo determinan las credenciales que seleccione. Consulte el [#flosum-login-1](#flosum-login-1 "mention") comando para obtener más detalles sobre las credenciales de inicio de sesión y cómo crear un token de API.
{% endhint %}

{% @arcade/embed flowId="tsDs9iOnDVjuTLaHquJR" url="<https://app.arcade.software/share/tsDs9iOnDVjuTLaHquJR>" %}

***

## Comandos \[Proyecto DevOps abierto]

<table><thead><tr><th width="220">Comando</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>Iniciar sesión [Modo proyecto]</strong></td><td>Este comando selecciona las credenciales que el proyecto abierto usará para conectarse al inquilino de DevOps.</td></tr><tr><td><strong>Cerrar sesión [Modo proyecto]</strong></td><td>Este comando quita las credenciales configuradas para el proyecto abierto.</td></tr><tr><td><strong>Hacer checkout de la rama</strong></td><td>Este comando recupera una rama de su inquilino de DevOps y copia todos los componentes a su proyecto local.</td></tr><tr><td><strong>Obtener rama</strong></td><td>Este comando recupera los cambios más recientes de su inquilino de DevOps para la rama actual.</td></tr><tr><td><strong>Ver cambios pendientes</strong></td><td>Este comando muestra todos los cambios locales que no se han confirmado en su inquilino de DevOps.</td></tr><tr><td><strong>Descartar cambios</strong></td><td>Este comando cancela todos los cambios locales que no se han confirmado en su inquilino de DevOps.</td></tr><tr><td><strong>Confirmar cambios</strong></td><td>Este comando confirma todos los cambios locales en su inquilino de DevOps.</td></tr></tbody></table>

### ![](https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media\&token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f) Flosum: Iniciar sesión \[Modo proyecto]

Este comando selecciona las credenciales que el proyecto abierto usará para conectarse al inquilino de DevOps.&#x20;

{% hint style="info" %}
Este comando también puede crear nuevas credenciales, pero las instrucciones siguientes solo muestran cómo seleccionar credenciales existentes. Consulte el [#flosum-login](#flosum-login "mention") comando para obtener detalles sobre cómo crear nuevas credenciales.
{% endhint %}

{% @arcade/embed flowId="VfvanHtRX99BabxNpSBg" url="<https://app.arcade.software/share/VfvanHtRX99BabxNpSBg>" %}

***

### ![](https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media\&token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f) Flosum: Cerrar sesión \[Modo proyecto]

Este comando quita las credenciales configuradas para el proyecto abierto. Debe usar el [#flosum-login-project-mode](#flosum-login-project-mode "mention") comando antes de poder usar los otros comandos de DevOps para este proyecto.

{% hint style="info" %}
Este comando no elimina las credenciales, a diferencia del [#flosum-logout](#flosum-logout "mention") comando cuando no hay ningún proyecto abierto.
{% endhint %}

{% @arcade/embed flowId="cLb1TL9g3a2ibtjTJHtw" url="<https://app.arcade.software/share/cLb1TL9g3a2ibtjTJHtw>" %}

***

### ![](https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media\&token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f) Flosum: Hacer checkout de la rama

Este comando recupera una rama de su inquilino de DevOps, copia todos los componentes a su proyecto local y establece la rama como la rama actual del proyecto.

{% hint style="info" %}
Este comando también se puede usar para crear una nueva rama, que también se creará en su inquilino de DevOps. Sin embargo, las siguientes instrucciones solo le muestran cómo hacer checkout de una rama existente.
{% endhint %}

{% @arcade/embed flowId="TPs3HvXZxS4B9rUhLWTk" url="<https://app.arcade.software/share/TPs3HvXZxS4B9rUhLWTk>" %}

***

### ![](https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media\&token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f) Flosum: Obtener rama

Este comando recupera los cambios más recientes de su inquilino de DevOps para la rama actual. Si tiene cambios sin confirmar, debe confirmarlos o revertirlos antes de obtenerlos desde DevOps.

{% @arcade/embed flowId="1oitCCDErIYn964RhOHF" url="<https://app.arcade.software/share/1oitCCDErIYn964RhOHF>" %}

***

### ![](https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media\&token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f) Flosum: Ver cambios pendientes

Este comando muestra todos los cambios locales que no se han confirmado en su inquilino de DevOps.

{% @arcade/embed flowId="wUkCjzfoQ0ZX6omIItAd" url="<https://app.arcade.software/share/wUkCjzfoQ0ZX6omIItAd>" %}

***

### ![](https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media\&token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f) Flosum: Descartar cambios

Este comando revierte todos los cambios locales que no se han confirmado en su inquilino de DevOps.

{% @arcade/embed flowId="rWz5xiEskdTk1mNBcZRU" url="<https://app.arcade.software/share/rWz5xiEskdTk1mNBcZRU>" %}

***

### ![](https://2574462044-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FEYsn6XHjDMDT9xIRIzSz%2FProgramming-Browser-1--Streamline-Ultimate.svg?alt=media\&token=0d3c11fe-3e3a-45be-8af4-0858ad862e2f) Flosum: Confirmar cambios

Este comando confirma todos los cambios locales en su inquilino de DevOps.

{% hint style="warning" %}

#### Fusión manual

La extensión DevOps CLI actualmente no admite fusionar bases de código cuando su proyecto local tiene tanto cambios sin confirmar como un historial de confirmaciones que está por detrás de la rama remota de DevOps. En este estado, tanto **Flosum: Confirmar cambios** y **Flosum: Obtener rama** fallarán.

Para resincronizar con la rama remota sin perder su trabajo:

1. Copie los archivos afectados (o los cambios específicos) a una ubicación fuera del proyecto para poder reaplicarlos después de obtener los cambios.
2. Revierta sus cambios locales con **Flosum: Descartar cambios**. Esto restablece el proyecto a su último estado confirmado para que la extensión pueda obtener los cambios correctamente.
3. Obtenga los últimos commits de DevOps con **Flosum: Obtener rama**. Su proyecto local ahora está sincronizado con la rama remota.
4. Vuelva a aplicar sus ediciones guardadas sobre la base de código actualizada, resolviendo cualquier conflicto que surja por cambios superpuestos.
5. Confirme sus cambios con **Flosum: Confirmar cambios** para enviarlos de nuevo a la rama de DevOps.
   {% endhint %}

{% @arcade/embed flowId="baJ6nvEYXkOwVJWOiYhq" url="<https://app.arcade.software/share/baJ6nvEYXkOwVJWOiYhq>" %}


---

# 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/uso-de-devops-cli-en-vs-code.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.