> 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/atualizando-o-flosum-cli-e-a-extensao-devops-cli.md).
# Atualizando o Flosum CLI e a extensão 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 atualizar uma instalação existente do Flosum CLI para a versão mais recente.
O Flosum CLI permanece na versão que você instalou até executar o comando de atualização, então uma instalação funcional pode ficar desatualizada sem qualquer indicação de que existe uma versão mais recente.
A atualização usa o mesmo comando da instalação. No entanto, você deve verificar sua versão do Node.js antes de executá-lo.
{% hint style="warning" %}
#### Confirme sua versão do Node.js antes de atualizar
Execute `node --version` e confirme se ele informa **v22.x** antes de atualizar qualquer coisa.
Em qualquer outra versão do Node.js, o comando de atualização substituirá sua instalação em funcionamento por uma versão anterior sem relatar nenhum erro.
{% endhint %}
## Antes de atualizar
{% hint style="info" %}
As instruções completas de pré-requisitos estão no artigo de instalaçã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)
{% endhint %}
{% stepper %}
{% step %}
### Anote sua versão do Flosum CLI
1. Registre a versão da qual você está atualizando:
```
flosum --version
```
2. Verifique a versão mais recente publicada:
```
npm view @flosum/cli version
```
Se ambos informarem a mesma versão, você já está atualizado e nenhuma atualização é necessária.
{% endstep %}
{% step %}
### Confirme o Node.js e o npm
1. Execute os seguintes comandos:
```
node --version
npm --version
```
2. Confirme que `node --version` informa **v22.x** e que `npm --version` informa **10.x**.
3. Se qualquer um deles for diferente, corrija antes de continuar. O artigo de instalação explica os pré-requisitos do Node.js e do npm.
{% endstep %}
{% step %}
### Confirme se as Build Tools ainda estão presentes
O Flosum CLI inclui um componente nativo. Quando uma versão altera esse componente, a atualização o recompila e precisa de **Python 3** e um **compilador C++**.
1. Confirme **Python 3** está disponível:
```
python3 --version
```
2. Confirme que o compilador C++ ainda está instalado.
{% hint style="info" %}
Mantenha as ferramentas de compilação instaladas. Nem toda atualização recompila o componente nativo, mas aquelas que o fazem falharão sem elas.
{% endhint %}
{% endstep %}
{% endstepper %}
## Atualizando o Flosum CLI
{% stepper %}
{% step %}
### Execute o comando de atualização
1. Abra um terminal.
2. Execute o mesmo comando usado para instalar o CLI:
```
npm i -g @flosum/cli
```
3. Aguarde o comando terminar. Ele informa o número de pacotes alterados, por exemplo `1656 pacotes alterados`.
{% hint style="info" %}
Uma atualização geralmente é mais rápida do que uma primeira instalação. Espere que ela demore mais quando a versão alterar o componente nativo.
{% endhint %}
{% endstep %}
{% step %}
### Verifique a atualização
1. Execute os seguintes comandos:
```
flosum --version
npm view @flosum/cli version
```
2. Confirme que ambos informam a mesma versão.
Se `flosum --version` ainda informa a versão anterior, a atualização não entrou em vigor. Consulte Solução de problemas.
{% endstep %}
{% endstepper %}
## Atualizando a extensão
A **Flosum DevOps-CLI Extension** é instalada e atualizada separadamente por meio de **Visual Studio Code**, em vez de por meio deste comando.
1. Em **Visual Studio Code**, abra a **Extensões** visualização.
2. Selecione **Flosum DevOps-CLI Extension** e confirme que nenhuma atualização está disponível.
{% hint style="warning" %}
A extensão e o Flosum CLI têm seus próprios números de versão. Os dois números não são iguais e não foram feitos para coincidir, portanto verifique cada um em sua própria fonte. Compare o CLI com `npm view @flosum/cli version`, e verifique se há uma atualização disponível para a extensão em **Visual Studio Code**.
* [Instalando a extensão Flosum DevOps-CLI](/devops/devops-pt-br/codigo/cli-do-devops/instalando-a-extensao-flosum-devops-cli.md)
{% endhint %}
## Solução de problemas
A atualização informa sucesso, mas flosum --version não mudou
O comando de atualização instalou uma versão anterior, o que o npm faz quando sua versão do Node.js não corresponde à exigida pela versão mais recente.
1. Execute `node --version`.
2. Se não informar **v22.x**, instale **Node.js 22** conforme descrito no artigo de instalação.
3. Execute o comando de atualização novamente.
4. Compare `flosum --version` com `npm view @flosum/cli version` mais uma vez.
A atualização falha com um erro de build ou compilação
A versão alterou o componente nativo, então a atualização tentou recompilá-lo e as ferramentas de compilação estão ausentes ou incompletas.
1. Conclua o **Build Tools** pré-requisito no artigo de instalação.
2. Remova a instalação parcial usando as etapas de limpeza nesse artigo.
3. Execute o comando de atualização novamente.
{% hint style="info" %}
Uma atualização com falha deixa a mesma instalação parcial que uma primeira instalação com falha, portanto a mesma limpeza se aplica.
* [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 %}
O comando flosum para de funcionar após uma atualização
A atualização não foi concluída, deixando os atalhos de comando no lugar sem os arquivos para os quais apontam.
1. Remova a instalação completamente usando as etapas de limpeza no artigo de instalação.
2. Confirme que `flosum --version` informa `comando não encontrado`.
3. Instale o CLI novamente.
---
# 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/atualizando-o-flosum-cli-e-a-extensao-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.