Usando Correção Pré-Deploy de Branch

A Correção Pré-Deploy detecta e resolve proativamente dependências ausentes antes da implantação.

Visão geral

O PreDeploy Fix é um processo de validação que inspeciona seu branch em busca de possíveis problemas antes da implantação, tais como:

• Incompatibilidades de versão da API

• Componentes ausentes

• Referências quebradas

• Dependências não atendidas

Se forem detectados problemas, eles são listados com opções para resolução. Esse processo ajuda a prevenir falhas de implantação ao:

• Verificar e atualizar as versões da API dos componentes

• Recuperar metadados ausentes

• Remover ou atualizar referências a componentes problemáticos

Ao tratar esses aspectos, sua implantação fica mais limpa e com menos propensão a erros.

Melhores práticas

• Sempre execute um PreDeploy Fix antes de Validar ou Implantar para reduzir a chance de falhas.

• Para Dependências Ausentes, use Recuperar quando possível para garantir que todas as dependências estejam corretamente incluídas. Use Remover somente quando você tiver certeza de que a referência está obsoleta ou não é necessária.

• Insira mensagens de commit. Estas aparecerão na aba Commits para acompanhamento futuro.

• Execute novamente o PreDeploy Fix após resolver os problemas até que as listas estejam vazias.

• Use filtros (status, tipo, intervalo de datas) em Atividades para rastrear rapidamente seus jobs de PreDeploy Fix.

• Revise os logs sempre que um job terminar com Exceção ou Ação necessária para entender o que precisa ser consertado.

Executar PreDeploy Fix no branch

1

Selecionar branch e executar PreDeploy Fix

1. Clique Código no menu lateral esquerdo.

2. Selecione um branch da lista.

   
3. Clique no Três pontos verticais ⋮ menu suspenso ao lado de Implantar.

4. Clique PreDeploy fix.

   

2

Selecionar conexão

1. Clique Selecione para a conexão da organização Salesforce na qual executar o PreDeploy Fix.

2. Clique Executar.

   
3. Após iniciar o job do PreDeploy Fix, ele será exibido na Atividades aba.

   

Resultados do PreDeploy Fix

1

Ver resultados

1. Clique no Atividades aba.

2. Verifique se o Pesquisa Pre Deploy Fix status do job está Concluído.

3. Clique no Pesquisa Pre Deploy Fix job.

   

Para ajudar a encontrar um job do PreDeploy Fix, você pode clicar no Todos os tipos menu de filtro suspenso e selecionar Pesquisa Pre Deploy Fix. Isso filtrará os jobs para mostrar apenas jobs de PreDeploy Fix.

2

Erros de versão da API

Se o PreDeploy Fix detectar quaisquer erros de versão da API, eles aparecerão na Erros de versão da API tabela. Esta tabela mostra cada componente com erro de versão da API. À direita de cada componente há duas versões da API: a Versão da API do componente e a Versão da API da organização. A versão da API do componente é a que o componente usa no branch, e a versão da API da organização é a que é usada na organização Salesforce conectada para este PreDeploy Fix.

Veja a Usando Correção Pré-Deploy de Branch seção abaixo para aprender como resolver esses erros.

1. Clique no erros de versão da API aba.

   

3

Dependências ausentes

Se o PreDeploy Fix identificar dependências ausentes, elas serão mostradas na Componentes ausentes tabela. Esta tabela exibe cada dependência de metadado ausente juntamente com o componente que a referencia. Para corrigir componentes ausentes, você pode escolher entre duas opções e aplicá-las a cada componente conforme necessário.

• Recuperar: Esta opção recupera o componente ausente e o commita no branch.

• Remover: Esta opção remove a referência ao componente ausente e deve ser usada apenas se estiver confirmado que implantar sem o componente no branch é seguro.

Veja a Usando Correção Pré-Deploy de Branch seção abaixo para aprender como resolver esses erros.

1. Clique no dependências ausentes aba.

   

Se a dependências ausentes aba não estiver visível, isso significa que não há dependências ausentes.

4

Ver logs do job

Você pode visualizar os logs do job do PreDeploy Fix para verificar quaisquer problemas de processamento do job e para confirmar em qual organização Salesforce o job foi executado.

1. Clique Ver logs.

   
2. Veja o status do job e o log.

   

5

Reexecutar PreDeploy Fix

Depois de corrigir todos os erros de versão da API e resolver dependências ausentes, reexecute o job do PreDeploy Fix para garantir que não restem problemas. As capturas de tela a seguir mostram um job do PreDeploy Fix que foi concluído sem encontrar problemas.

Ambas as erros de versão da API e a tabelas de componentes ausentes exibem Nenhum componente.

Corrigindo erros de versão da API

Se a PreDeploy Fix encontrou erros de versão da API, você pode corrigi-los atualizando para a versão correta.

1

Atualizar versões

1. Clique Atualizar versões.

   
2. Clique Adicionar para cada componente para atualizar a versão da API.

3. Clique Atualizar.

   
4. Insira uma Mensagem de commit para as alterações no branch.

5. Clique Resolver.

   
6. Após iniciar o job de atualização da API, ele será exibido na Atividades aba como um Atualização Pre Deploy Fix job.

   

2

Ver resultados

1. Clique no Atualização Pre Deploy Fix job.

   
2. Veja o status do job e o log.

   

Corrigindo dependências ausentes

1

Recuperar componentes ausentes

Os metadados selecionados serão recuperados para o seu branch e adicionados como um commit.

Se você já removeu componentes dependentes, não os selecione para recuperar. Se não tiver certeza, você pode reexecutar o job do PreDeploy Fix.

1. Clique Recuperar.

   
2. Clique Adicionar para cada componente de dependência a recuperar.

3. Clique Recuperar.

   
4. Insira uma Mensagem de commit para as alterações no branch.

5. Clique no Conexão menu suspenso.

6. Selecione a organização Salesforce para recuperar os componentes dependentes.

   
7. Clique Executar.

   
8. Após iniciar o job Recuperar dependências ausentes, ele será exibido na Atividades aba como um Atualização Pre Deploy Fix job.

   

2

Remover componentes ausentes

As referências a esses componentes são removidas do seu branch, evitando erros de implantação.

Se você já recuperou componentes dependentes, não os selecione para remover. Se não tiver certeza, você pode reexecutar o job do PreDeploy Fix.

1. Clique Remover.

   
2. Clique Adicionar para cada componente de dependência a recuperar.

3. Clique Remover.

   
4. Insira uma Mensagem de commit para as alterações no branch.

5. Clique Executar.

   
6. Após iniciar o job Remover dependências ausentes, ele será exibido na Atividades aba como um Pre Deploy Fix Remover job.

   

3

Ver resultados

1. Clique no Pre Deploy Fix Recuperar job para recuperar componentes ou Pre Deploy Fix Remover job para remover componentes.

   
2. Veja o status do job e o log.