Ctrlk
Suporte ao Cliente
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instalando a extensão Flosum 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 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.

A extensão executa o Flosum CLI, que é instalado separadamente. Instale primeiro o Flosum CLI e depois a extensão.

Pré-requisitos

1

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.

As instruções completas, os pré-requisitos e a solução de problemas do CLI estão em um artigo separado.

2

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.

Instalando a extensão DevOps-CLI

1

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.

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.

2

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:

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.

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.

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:

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.

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.

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.

AnteriorInstalando o pacote Node.js do Flosum CLI
PróximoUsando o DevOps CLI no VS Code

Atualizado

Isto foi útil?