> 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/instalando-a-extensao-flosum-devops-cli.md).
# Instalando a extensão Flosum DevOps-CLI
{% 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 %}
##  Visão geral
Este artigo explica como instalar a extensão Flosum DevOps-CLI para o Visual Studio Code (VS Code). A extensão ajuda você a trabalhar em projetos DevOps, fornecendo acesso direto aos comandos do Flosum CLI no VS Code por meio de uma interface fácil de usar. Para obter mais informações sobre o DevOps CLI e como usá-lo, consulte os seguintes artigos.
* [Visão geral do DevOps CLI no VS Code](/devops/devops-pt-br/codigo/cli-do-devops/visao-geral-do-devops-cli-no-vs-code.md)
* [Usando o DevOps CLI no VS Code](/devops/devops-pt-br/codigo/cli-do-devops/usando-o-devops-cli-no-vs-code.md)
A extensão executa o Flosum CLI, que é instalado separadamente. Instale primeiro o Flosum CLI e depois a extensão.
* [Instalando o pacote Node.js do Flosum CLI](/devops/devops-pt-br/codigo/cli-do-devops/instalando-o-pacote-node.js-do-flosum-cli.md)
## Pré-requisitos
{% stepper %}
{% step %}
### Flosum CLI
O Flosum CLI deve estar instalado antes que a extensão possa ser usada. Ele tem seus próprios pré-requisitos, incluindo uma versão específica do Node.js e uma cadeia de ferramentas de compilação C++.
1. Conclua a instalação descrita no seguinte artigo.
2. Confirme que `flosum --version` retorna um número de versão e anote-o.
{% hint style="info" %}
As instruções completas, os pré-requisitos e a solução de problemas do CLI estão em um artigo separado.
* [Instalando o pacote Node.js do Flosum CLI](/devops/devops-pt-br/codigo/cli-do-devops/instalando-o-pacote-node.js-do-flosum-cli.md)
{% endhint %}
{% endstep %}
{% step %}
### Visual Studio Code
1. Confirme que você está executando **Visual Studio Code** versão **1.106.0** ou posterior.
2. Selecione **Ajuda > Verificar atualizações** e instale todas as atualizações disponíveis antes de continuar.
{% endstep %}
{% endstepper %}
## Instalando a extensão DevOps-CLI
{% stepper %}
{% step %}
### Instalar a extensão Flosum DevOps-CLI
1. Inicie o VS Code.
2. Abra a exibição Extensões selecionando o **Extensões** ícone na Barra de Atividade.
3. Na **Pesquisa** caixa, digite **Flosum DevOps-CLI Extension**.
4. Clique em **Instalar** para **Flosum DevOps-CLI Extension**.
5. Clique em **Confiar no editor e instalar** para confirmar.
6. Se a extensão Flosum DevOps-CLI for instalada com sucesso, você verá o inicializador da **Flosum** paleta de comandos no lado esquerdo da **Barra de Status**.
{% 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 %}
{% endstep %}
{% step %}
### Verifique se ambos estão atualizados
1. Na **Extensões** exibição, confirme que a **Flosum DevOps-CLI Extension** não mostra atualizações disponíveis.
2. Em um terminal, compare o Flosum CLI instalado com a versão mais recente publicada:
```
flosum --version
npm view @flosum/cli version
```
{% hint style="warning" %}
#### Reinicie o Visual Studio Code se o flosum não for encontrado
Se o terminal informar que `flosum` não foi encontrado, feche **Visual Studio Code** completamente e abra novamente; depois tente de novo. Abrir uma nova aba do terminal não funciona porque **Visual Studio Code** lê apenas o seu **PATH** quando ele é iniciado.
{% endhint %}
{% hint style="warning" %}
#### Mantenha ambos atualizados, mas não compare suas versões
A extensão e o Flosum CLI são numerados independentemente. Os números de versão não são os mesmos e não devem coincidir, então verifique cada um em sua própria fonte em vez de compará-los entre si.
O Flosum CLI não se atualiza sozinho, então ele fica desatualizado enquanto a extensão é atualizada automaticamente pelo Visual Studio Code. Um CLI desatualizado é mais comumente causado pela instalação em uma versão do Node.js diferente da 22, o que instala uma versão mais antiga sem relatar nenhum erro. Versões mais antigas não oferecem suporte ao Flosum DevOps atual e não funcionarão.
{% endhint %}
{% endstep %}
{% endstepper %}
## Solução de problemas
O inicializador do Flosum não aparece na Barra de Status
1. Selecione **Exibir > Aparência > Barra de Status** e confirme que o **Barra de Status** está ativado.
2. Na **Extensões** exibição, confirme que **Flosum DevOps-CLI Extension** está instalado e habilitado.
3. Recarregue a janela selecionando **Desenvolvedor: Recarregar janela** na paleta de comandos.
O Flosum CLI é uma versão mais antiga do que a publicada
A extensão e o CLI são numerados independentemente, então uma diferença entre os números de versão é esperada e não é um problema. Em vez disso, compare o CLI com a versão publicada:
```
flosum --version
npm view @flosum/cli version
```
Se `flosum --version` informar o número menor, o CLI está desatualizado.
1. Execute `node --version` e confirme se ele informa **v22.x**.
2. Se não informar, instale **Node.js 22** conforme descrito no artigo do CLI.
3. Remova o CLI existente, reinstale-o e depois compare os dois comandos novamente.
{% hint style="info" %}
Instalar o CLI em **Node.js 24** instala silenciosamente uma versão mais antiga sem relatar um erro. Este é o motivo mais comum de o CLI ficar desatualizado.
* [Instalando o pacote Node.js do Flosum CLI](/devops/devops-pt-br/codigo/cli-do-devops/instalando-o-pacote-node.js-do-flosum-cli.md)
{% endhint %}
Os comandos da extensão falham mesmo com a extensão instalada
A extensão executa o Flosum CLI, então um problema com o CLI aparece como um comando da extensão com falha.
1. Abra um terminal em **Visual Studio Code** e execute `flosum --version`.
2. Se o comando não for encontrado, feche **Visual Studio Code** completamente, abra novamente e execute o comando outra vez. Isso resolve na maioria dos casos, porque o editor só detecta **PATH** alterações quando ele é iniciado.
3. Se ainda não for encontrado, abra um terminal fora de **Visual Studio Code** e execute o mesmo comando. Um número de versão ali significa que o editor está sendo executado com um ambiente desatualizado. Nenhum número de versão significa que o CLI não está instalado corretamente.
4. Se o comando informar um módulo ausente, a instalação do CLI não foi concluída. Siga as etapas de solução de problemas no artigo do 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-pt-br/codigo/cli-do-devops/instalando-a-extensao-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.
