Atualizando o Flosum CLI e a extensão DevOps-CLI

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.

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.

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.

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.

Antes de atualizar

As instruções completas de pré-requisitos estão no artigo de instalação.

• Instalando o pacote Node.js do Flosum CLI

1

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.

2

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.

3

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.

Mantenha as ferramentas de compilação instaladas. Nem toda atualização recompila o componente nativo, mas aquelas que o fazem falharão sem elas.

Atualizando o Flosum CLI

1

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.

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.

2

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.

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.

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

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.

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

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.