Configurando Etapas do Pipeline

Esta página explica como configurar etapas dentro de um pipeline após sua criação, incluindo operações disponíveis, resultados das etapas e como essas etapas constroem um diagrama visual.

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 Iniciar e Parar. Cada etapa pode executar operações específicas, como implantação, validação, rollback ou varredura de código.

Clique no ➕ (mais) ícone entre Iniciar 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 executará (Deploy, Validate, Rollback, WebHook, Etapa Manual, Code Scan, Execute Apex).

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

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

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

  • Em Caso de Sucesso – Escolha a próxima etapa a ser executada se esta etapa for bem-sucedida.

  • Em Caso de Falha – Escolha a próxima etapa se a etapa falhar (comumente definido como Parar).

Depois de preencher os detalhes, clique 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 release flexível:

• Deploy – Implanta metadados do branch na org de destino.

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

• Rollback – Reverte para um estado anterior usando o backup criado durante as implantações.

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

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

• Varredura 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 Iniciar → 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

• Em Caso de Sucesso: Deploy

• Em Caso de Falha: 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 alterações, depois as implante e, se a validação falhar, acione um rollback antes de parar.

Melhores práticas

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

• Incluir Varredura de Código – Garanta que portas de qualidade de código sejam aplicadas antes da implantação.

• Encadear ambientes – Configure Em Caso de Sucesso para mover de QA → UAT → Prod em sequência.

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

• Definir caminhos de Rollback – Sempre inclua uma opção de Rollback caso as implantações falhem.