Configurando Etapas do Pipeline

Quando um novo pipeline é criado, ele inicialmente mostra um Início e Parar nó na aba Visão Geral. Para definir a lógica do pipeline, você adiciona etapas entre Início e Parar. Cada etapa pode executar operações específicas, como deployment, validação, rollback ou varredura de código.

Clique no ➕ (mais) ícone entre Início e Parar para adicionar sua primeira etapa.

Configuração da Etapa

Ao adicionar uma etapa, você define os seguintes campos:

• Nome – Um rótulo para identificar a etapa (por exemplo, “Deploy para Org de QA”).

• Operação – A ação que a etapa irá executar (Deploy, Validate, Rollback, WebHook, Etapa Manual, Code Scan, Execute Apex).

• Organização de Destino – Selecione a conexão Salesforce onde a etapa será executada.

• Executar Testes – Configure quais testes executar (padrão ou personalizados).

• Próxima Etapa – Defina o fluxo com base nos resultados:

  • Ao Passar – Escolha a próxima etapa a ser executada se esta etapa for bem-sucedida.

  • Ao Falhar – Escolha a próxima etapa se a etapa falhar (comumente configurada para Parar).

Após preencher os detalhes, clique em Adicionar. A etapa é adicionada ao pipeline e o diagrama visual é atualizado para mostrar o novo fluxo.

Operações Suportadas

Pipelines suportam múltiplas operações, permitindo automação de releases flexível:

• Deploy – Faz o deploy de metadados do branch para a organização de destino.

• Validate – Executa uma validação de deployment sem confirmar mudanças, útil para pré-verificações.

• Rollback – Retorna a um estado anterior usando o backup criado durante os deployments.

• WebHook – Aciona um webhook externo para integrações (por exemplo, notificando sistemas CI/CD ou de tickets).

• Etapa Manual – Pausa o pipeline até que uma aprovação ou ação manual seja realizada.

• Análise de Código – Executa análise estática de código (por exemplo, PMD) como parte da execução do pipeline.

• Executar Apex – Executa testes ou scripts Apex personalizados como parte do pipeline.

Exemplo

Um pipeline de QA é criado com Início → Parar.

Uma nova etapa é adicionada com:

• Nome: Validar para Org de QA

• Operação: Validar

• Organização de Destino: Conexão Sandbox de QA

• Executar Testes: Padrão

• Ao Passar: Deploy

• Ao Falhar: Rollback

Após clicar em Adicionar, o diagrama do pipeline é atualizado para mostrar: Início → Validate → Deploy → Rollback → Parar

Isso garante que o pipeline primeiro valide as mudanças, depois as deploye e, se a validação falhar, acione um rollback antes de parar.

Melhores Práticas

• Use Validação primeiro – Adicione uma etapa Validate antes do Deploy para detectar problemas cedo.

• Inclua Análise de Código – Garanta que os gates de qualidade de código sejam aplicados antes do deployment.

• Encadeie ambientes – Configure Ao Passar para mover de QA → UAT → Prod em sequência.

• Adicione Etapas Manuais – Insira aprovações para releases críticas antes da produção.

• Defina caminhos de Rollback – Sempre inclua uma opção de Rollback caso os deployments falhem.