Usando o DevOps CLI no VS Code

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 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]

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.

Acessando a Paleta de Comandos do Flosum

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.

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

   
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.

      
   2. Paleta de Comandos do Flosum com projeto DevOps aberto.

      

Comandos [Nenhum projeto DevOps aberto]

Comando	Descrição
Login	Este comando cria credenciais para se conectar ao seu tenant DevOps.
Logout	Este comando exclui as credenciais selecionadas da extensão DevOps CLI.
Inicializar projeto DevOps	Este comando inicializa um projeto Salesforce vazio com os arquivos de sistema da CLI do Flosum.
Clonar projeto DevOps	Este comando inicializa um projeto Salesforce e clona a main branch do seu tenant DevOps.

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

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.

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.

---

Flosum: Logout

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

---

Flosum: Inicializar projeto DevOps

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

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 Usando o DevOps CLI no VS Code comando para mais detalhes.

---

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.

O tenant DevOps ao qual você se conecta é determinado pelas credenciais que você seleciona. Consulte o Usando o DevOps CLI no VS Code comando para mais detalhes sobre as credenciais de login e como criar um Token de API.

---

Comandos [Projeto DevOps aberto]

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

Flosum: Login [Modo de projeto]

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

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 comando para detalhes sobre como criar novas credenciais.

---

Flosum: Logout [Modo de projeto]

Este comando remove as credenciais configuradas para o projeto aberto. Você deve usar o Usando o DevOps CLI no VS Code comando antes de poder usar os outros comandos DevOps para este projeto.

Este comando não exclui as credenciais, ao contrário do Flosum: Logout comando quando nenhum projeto está aberto.

---

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.

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.

---

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.

---

Flosum: Ver alterações pendentes

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

---

Flosum: Descartar alterações

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

---

Flosum: Confirmar alterações

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

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.