> 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-pt-br/codigo/cli-do-devops/usando-o-devops-cli-no-vs-code.md).

# Usando o DevOps CLI no VS Code

{% hint style="warning" %}

#### Problemas conhecidos: atualização obrigatória

**Uma atualização é necessária.** A versão atual do Flosum DevOps requer as versões mais recentes do Flosum CLI (**@flosum/cli** pacote) e o **Flosum DevOps-CLI Extension**. Versões anteriores do CLI não oferecem suporte a topologias e não podem funcionar com um tenant do DevOps que as use, portanto as instalações existentes devem ser atualizadas.

**O Node.js 22 é necessário.** Em **Node.js 24**, os comandos de instalação e atualização parecem ser concluídos com sucesso, mas deixam você em uma versão anterior. Mude para o Node.js 22 antes de instalar ou atualizar.
{% endhint %}

{% hint style="success" %}

#### Compatibilidade do sistema operacional

**Flosum CLI** e **Extensão Flosum DevOps-CLI** são compatíveis com os seguintes sistemas operacionais:

* **macOS**
* **Linux**

Essas ferramentas atualmente não foram projetadas para funcionar com o Windows.
{% endhint %}

## ![](https://2465342021-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) Visão geral

Este artigo mostra como usar a extensão DevOps CLI no Visual Studio Code (VS Code) para acessar os comandos disponíveis. As seções abaixo explicam cada comando e fornecem instruções de uso. Os comandos disponíveis dependem de haver ou não um projeto DevOps aberto no VS Code: alguns funcionam apenas dentro de um projeto DevOps, enquanto outros são usados para criar um. Os comandos estão divididos nas seguintes seções:

* **Comandos \[Nenhum projeto DevOps aberto]**
* **Comandos \[Projeto DevOps aberto]**

{% hint style="info" %}

#### Melhores práticas

* Use aliases claros para credenciais de login no tenant DevOps, como `prod-admin`, `sandbox-dev`, ou `customer-xyz`, para facilitar a troca.
* Quando possível, use o **Clonar projeto DevOps** comando ao iniciar um projeto, pois ele configura automaticamente as credenciais do projeto.
* Execute **Atualizar branch** antes de confirmar para evitar enviar alterações desatualizadas.
* Use **Ver alterações pendentes** antes de confirmar para verificar exatamente o que será enviado.
* Se os comandos do DevOps pararem de funcionar, confirme se seu projeto ainda tem as credenciais corretas definidas para se conectar ao seu tenant DevOps. Se necessário, execute o **Login** comando novamente.
  {% endhint %}

## Acessando a Paleta de Comandos do Flosum

{% hint style="info" %}

#### Paleta de Comandos do Flosum

Para acessar o **Paleta de Comandos do Flosum**, certifique-se de que a **Barra de status** no VS Code esteja visível. Controle sua visibilidade por meio de **Exibir** > **Aparência** > **Barra de status**.
{% endhint %}

1. Clique no iniciador da **Flosum** paleta de comandos no lado esquerdo da Barra de status. 

   <div align="left"><figure><img src="https://2465342021-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. A **Paleta de Comandos do Flosum** é aberta na parte superior da janela do VS Code.
3. Os comandos disponíveis diferem dependendo de um projeto DevOps estar aberto ou não.
   1. Paleta de Comandos do Flosum sem projeto DevOps aberto.&#x20;

      <div align="left"><figure><img src="https://2465342021-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 do Flosum com projeto DevOps aberto.&#x20;

      <div align="left"><figure><img src="https://2465342021-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 \[Nenhum projeto DevOps aberto]

<table><thead><tr><th width="220">Comando</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Login</strong></td><td>Este comando cria credenciais para se conectar ao seu tenant DevOps.</td></tr><tr><td><strong>Logout</strong></td><td>Este comando exclui as credenciais selecionadas da extensão DevOps CLI.</td></tr><tr><td><strong>Inicializar projeto DevOps</strong></td><td>Este comando inicializa um projeto Salesforce vazio com os arquivos de sistema da CLI do Flosum. </td></tr><tr><td><strong>Clonar projeto DevOps</strong></td><td>Este comando inicializa um projeto Salesforce e clona a <strong>main</strong> branch do seu tenant DevOps.</td></tr></tbody></table>

### <img src="https://2465342021-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: Login

Este comando cria credenciais com um Token de API gerado no aplicativo Flosum Global Settings. As credenciais são usadas para se conectar ao seu tenant DevOps. Para instruções sobre como criar um Token de API, consulte o artigo a seguir.

* [Criando um token de API](/global-settings/global-settings-docs-pt-br/seguranca/tokens-de-api/criando-um-token-de-api.md)

{% hint style="warning" %}
Certifique-se de copiar seu Token de API para a área de transferência antes de iniciar o processo de login, pois clicar fora do VS Code fechará a Paleta de Comandos.
{% endhint %}

Você pode ter várias credenciais de login. Ao fazer login, será solicitado que você insira um alias para a credencial, para ajudar a distingui-la das demais. O alias não afeta a autenticação, então é melhor escolher um nome que indique a qual tenant a credencial pertence.

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

***

### <img src="https://2465342021-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: Logout

Este comando exclui as credenciais selecionadas da extensão DevOps CLI. As credenciais podem ser adicionadas novamente por meio do comando Login.

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

***

### <img src="https://2465342021-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 projeto DevOps

Este comando inicializa um projeto Salesforce vazio com os arquivos de sistema da CLI do Flosum.&#x20;

{% hint style="info" %}
Quando este projeto é inicializado, nenhuma credencial fica associada a ele. Depois que o projeto for criado, execute o **Flosum: Login** comando de dentro do projeto para se conectar ao tenant DevOps desejado. Consulte o [#flosum-login-1](#flosum-login-1 "mention") comando para mais detalhes.
{% endhint %}

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

***

### <img src="https://2465342021-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 projeto DevOps

Este comando inicializa um projeto Salesforce e usa as credenciais de login selecionadas para clonar a **main** branch do seu tenant DevOps.

{% hint style="info" %}
O tenant DevOps ao qual você se conecta é determinado pelas credenciais que você seleciona. Consulte o [#flosum-login-1](#flosum-login-1 "mention") comando para mais detalhes sobre as credenciais de login e como criar um Token de API.
{% endhint %}

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

***

## Comandos \[Projeto DevOps aberto]

<table><thead><tr><th width="220">Comando</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Login [Modo de projeto]</strong></td><td>Este comando seleciona as credenciais que o projeto aberto usará para se conectar ao tenant DevOps.</td></tr><tr><td><strong>Logout [Modo de projeto]</strong></td><td>Este comando remove as credenciais configuradas para o projeto aberto.</td></tr><tr><td><strong>Fazer checkout da branch</strong></td><td>Este comando obtém uma branch do seu tenant DevOps e copia todos os componentes para o seu projeto local.</td></tr><tr><td><strong>Atualizar branch</strong></td><td>Este comando obtém as alterações mais recentes do seu tenant DevOps para a branch atual.</td></tr><tr><td><strong>Ver alterações pendentes</strong></td><td>Este comando exibe todas as alterações locais que ainda não foram confirmadas no seu tenant DevOps.</td></tr><tr><td><strong>Descartar alterações</strong></td><td>Este comando cancela todas as alterações locais que ainda não foram confirmadas no seu tenant DevOps.</td></tr><tr><td><strong>Confirmar alterações</strong></td><td>Este comando confirma todas as alterações locais no seu tenant DevOps.</td></tr></tbody></table>

### ![](https://2465342021-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: Login \[Modo de projeto]

Este comando seleciona as credenciais que o projeto aberto usará para se conectar ao tenant DevOps.&#x20;

{% hint style="info" %}
Este comando também pode criar novas credenciais, mas as instruções abaixo mostram apenas a seleção de credenciais existentes. Consulte o [#flosum-login](#flosum-login "mention") comando para detalhes sobre como criar novas credenciais.
{% endhint %}

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

***

### ![](https://2465342021-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: Logout \[Modo de projeto]

Este comando remove as credenciais configuradas para o projeto aberto. Você deve usar o [#flosum-login-project-mode](#flosum-login-project-mode "mention") comando antes de poder usar os outros comandos DevOps para este projeto.

{% hint style="info" %}
Este comando não exclui as credenciais, ao contrário do [#flosum-logout](#flosum-logout "mention") comando quando nenhum projeto está aberto.
{% endhint %}

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

***

### ![](https://2465342021-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: Fazer checkout da branch

Este comando obtém uma branch do seu tenant DevOps, copia todos os componentes para o seu projeto local e define a branch como a branch atual do projeto.

{% hint style="info" %}
Este comando também pode ser usado para criar uma nova branch, que também será criada no seu tenant DevOps. No entanto, as instruções a seguir mostram apenas como fazer checkout de uma branch existente.
{% endhint %}

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

***

### ![](https://2465342021-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: Atualizar branch

Este comando obtém as alterações mais recentes do seu tenant DevOps para a branch atual. Se você tiver alterações não confirmadas, será necessário confirmá-las ou reverter-las antes de atualizar a partir do DevOps.

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

***

### ![](https://2465342021-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 alterações pendentes

Este comando exibe todas as alterações locais que ainda não foram confirmadas no seu tenant DevOps.

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

***

### ![](https://2465342021-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 alterações

Este comando reverte todas as alterações locais que ainda não foram confirmadas no seu tenant DevOps.

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

***

### ![](https://2465342021-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 alterações

Este comando confirma todas as alterações locais no seu tenant DevOps.

{% hint style="warning" %}

#### Mesclagem manual

Atualmente, a extensão DevOps CLI não oferece suporte à mesclagem de bases de código quando seu projeto local tem alterações não confirmadas e um histórico de commits que está atrás da branch remota do DevOps. Nesse estado, tanto **Flosum: Confirmar alterações** quanto **Flosum: Atualizar branch** falharão.

Para resincronizar com a branch remota sem perder seu trabalho:

1. Copie os arquivos afetados (ou as alterações específicas) para um local fora do projeto para que você possa reaplicá-las depois de atualizar.
2. Reverta suas alterações locais com **Flosum: Descartar alterações**. Isso redefine o projeto para seu último estado confirmado, para que a extensão possa fazer a atualização corretamente.
3. Obtenha os commits mais recentes do DevOps com **Flosum: Atualizar branch**. Agora seu projeto local está sincronizado com a branch remota.
4. Reaplique as edições salvas sobre a base de código atualizada, resolvendo quaisquer conflitos que surjam de alterações sobrepostas.
5. Confirme suas alterações com **Flosum: Confirmar alterações** para enviá-las de volta para a branch do 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-pt-br/codigo/cli-do-devops/usando-o-devops-cli-no-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.