Início rápido: Usar o Salesforce CLI com o DevOps Center

Configurar um pipeline

Crie um pipeline, adicione e configure seus estágios, ative o pipeline e anexe seu projeto.

1. Liste seus projetos para localizar o ID do projeto.

   sf devops project list --target-org my-devops-org

   Copie o ID do projeto que você deseja anexar ao pipeline. Os exemplos neste início rápido usam 0Hn000000000001.

2. Crie um pipeline inativo e conecte-o ao seu repositório.

   sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo

   Copie o ID do pipeline da saída do comando. Os exemplos neste início rápido usam 0XB000000000001.

   O pipeline permanece inativo até que você configure seus estágios e o ative.

   Para criar um repositório ao criar o pipeline, use --create-repo com --repo-type github|bitbucket.

3. Adicione estágios ao seu pipeline. Um novo pipeline inclui um estágio final padrão. Adicione cada novo estágio antes de um estágio existente especificando esse estágio existente com --next-stage-id.

   Por exemplo, adicione um estágio de integração.

   sf devops pipeline stage add --target-org my-devops-org --pipeline-id 0XB000000000001 --name "Integration" --next-stage-id 0Xc000000000001

   Copie o ID do estágio da saída do comando. Os exemplos restantes utilizam 0Xc000000000005 para a fase de integração. Repita o comando para cada estágio adicional, como UAT.

   

   Dica Visualize seu pipeline na interface do usuário do DevOps Center para obter os IDs de estágio para comandos subsequentes. Ou execute sf devops pipeline get --pipeline-id 0XB000000000001.
4. Configure cada estágio. Cada estágio requer uma ramificação e um ambiente. Configure os estágios da direita para a esquerda, pois o estágio final deve ter uma ramificação para que você possa configurar os estágios antes dele.

   Adicione uma ramificação ao estágio de Integração. O sinalizador de --create-vcs-branch cria a ramificação no repositório se ela não existir.

   sf devops stage branch add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --branch-name integration --create-vcs-branch

   Adicione um ambiente de sandbox ao estágio.

   sf devops stage environment add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --environment-name Integration_Org --org-type Sandbox

   Uma janela do navegador é aberta para que você possa se autenticar no ambiente. Use --org-type Production para organizações de produção. Em um ambiente autônomo, adicione --no-browser e siga as instruções de autenticação retornadas pelo comando.

   Repita os comandos de ramificação e ambiente para cada estágio. Use o nome da agência, o nome do ambiente e o tipo de organização apropriado para cada estágio.

5. Ative o pipeline.
   

   Importante Não é possível modificar o estágio do pipeline depois de promover alterações por meio dele. Certifique-se de que todos os estágios estejam configurados corretamente antes de executar esse comando.

   sf devops pipeline update --target-org my-devops-org --pipeline-id 0XB000000000001 --activate

6. Anexe seu projeto do DevOps Center ao pipeline.

   sf devops pipeline project add --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001

   O pipeline está pronto. Crie itens de trabalho na IU do DevOps Center ou execute o comando sf devops work-item create.

Gerenciar um item de trabalho

Conclua um ciclo de desenvolvimento iniciando um item de trabalho, confirmando suas alterações, criando uma revisão e marcando o item de trabalho como pronto para promoção.

1. Defina o status do item de trabalho como Em andamento. O DevOps Center cria uma ramificação de recurso para o item de trabalho.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "In Progress"

2. Recupere a ramificação do recurso do repositório conectado e verifique-a em seu projeto local.

   git fetch origin
   git checkout WI-000042

3. Recupere as alterações da sua organização de desenvolvimento. Este exemplo recupera uma classe do Apex da organização com o alias my-sandbox.

   sf project retrieve start --target-org my-sandbox --metadata ApexClass:MyNewClass

4. Revise os arquivos recuperados, prepara-os, confirme-os e envie por push a ramificação do recurso.

   git status
   git add force-app
   git commit -am "Implement new feature"
   git push origin WI-000042

   Ajuste o caminho passado para git add se o projeto do Salesforce DX usar um diretório de pacote diferente.

5. Crie uma solicitação de alteração (solicitação de pull) para mesclar a ramificação de recurso na ramificação de destino.

   sf devops review create --target-org my-devops-org --work-item-name WI-000042

6. Aguarde sua equipe aprovar e mesclar a solicitação de alteração.
7. Atualize o status do item de trabalho para indicar que ele está pronto para promoção.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "Ready to Promote"

Promover um item de trabalho

Promova o item de trabalho para o próximo estágio do pipeline. O DevOps Center valida a promoção, executa os pacotes de teste configurados para o estágio de destino e implementa as alterações se os testes forem aprovados.

1. Promova o item de trabalho usando o ID do item de trabalho e o ID do estágio de destino.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --target-stage-id 0Xc000000000002

   A saída do comando inclui um ID de solicitação. Use-o para verificar o status da promoção.

   Status: Completed
   Message: Work items successfully promoted to UAT.
   Request ID: a0B000000000001
   
   Promoted Work Items
   ───────────────────
   0Wx000000000042

2. Use o ID da solicitação para verificar o status da promoção.

   sf devops request status --target-org my-devops-org --request-token a0B000000000001

Tarefas comuns

Use esses comandos durante seu fluxo de trabalho de desenvolvimento diário.

1. Promova vários itens de trabalho para o mesmo estágio. Especifique a --work-item-id uma vez para cada item de trabalho.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --work-item-id 0Wx000000000043 --target-stage-id 0Xc000000000002

2. Implemente alterações mescladas externamente em um estágio fora de sincronia com o DevOps Center.

   sf devops promotion complete --target-org my-devops-org --target-stage-id 0Xc000000000002

Casos de uso avançados

Depois de concluir o fluxo de trabalho básico, use estes comandos para promoções que exigem mais controle.