Usando o PreDeploy Fix da branch

O PreDeploy Fix detecta e resolve proativamente dependências ausentes antes da implantação.

Escrito para a interface antiga

Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o Para onde foi artigo.

Visão geral

O PreDeploy Fix é um processo de validação que inspeciona sua branch em busca de possíveis problemas antes da implantação, 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 de resolução. Esse processo ajuda a evitar 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 desses aspectos, sua implantação fica mais limpa e menos propensa 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 sempre que possível para garantir que todas as dependências sejam incluídas corretamente. Use Remover somente quando tiver certeza de que a referência está obsoleta ou não é necessária.
• Insira mensagens de commitclaras e descritivas. Elas aparecerão na aba Commits para rastreamento 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 acompanhar rapidamente seus jobs do PreDeploy Fix.
• Revise os logs sempre que um job terminar com Exceção ou Ação necessária para entender o que precisa ser corrigido.

Executar PreDeploy Fix da Branch

1

Selecione a Branch e execute o PreDeploy Fix

1. Clique em Código no menu da barra lateral esquerda.
2. Selecione uma branch na lista.

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

   

2

Selecionar conexão

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

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

   

Resultados do PreDeploy Fix

1

Ver resultados

1. Clique no Atividades .
2. Verifique se o Pesquisa de Pre Deploy Fix status do job é Concluído.
3. Clique no Pesquisa de Pre Deploy Fix job.

   

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

2

Erros de versão da API

Se o PreDeploy Fix detectar erros de versão da API, eles aparecerão na Erros de versão da API tabela. Esta tabela mostra cada componente com um 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 na branch, e a versão da API da organização é a que ele usa na organização Salesforce usada como conexão para este PreDeploy Fix.

Veja a Usando o PreDeploy Fix da branch seção abaixo para aprender como resolver esses erros.

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

   

3

Dependências ausentes

Se o PreDeploy Fix identificar quaisquer dependências ausentes, elas serão mostradas na Componentes ausentes tabela. Esta tabela exibe cada dependência de metadados 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 envia como commit para a branch.
• Remover: Esta opção remove a referência ao componente ausente e só deve ser usada se for confirmado que implantar sem o componente na branch é seguro.

Veja a Usando o PreDeploy Fix da branch seção abaixo para aprender como resolver esses erros.

1. Clique no dependências ausentes .

   

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 confirmar com qual organização Salesforce o job foi executado.

1. Clique em Ver logs.

   
2. Veja o status e o log do job.

   

5

Executar novamente o PreDeploy Fix

Depois de corrigir todos os erros de versão da API e resolver as dependências ausentes, execute novamente o job do PreDeploy Fix para garantir que nenhum problema permaneça. As capturas de tela a seguir mostram um job do PreDeploy Fix que foi concluído sem encontrar nenhum problema.

Ambas as erros de versão da API e a dependências ausentes tabelas 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 em Atualizar versões.

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

   
4. Insira uma mensagem de commit para as alterações na branch.
5. Clique em Resolver.

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

   

2

Ver resultados

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

   
2. Veja o status e o log do job.

   

Corrigindo dependências ausentes

1

Recuperar componentes ausentes

Os metadados selecionados serão recuperados para sua 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 executar novamente o job do PreDeploy Fix.

1. Clique em Recuperar.

   
2. Clique em Adicionar para cada componente de dependência a ser recuperado.
3. Clique em Recuperar.

   
4. Insira uma mensagem de commit para as alterações na branch.
5. Clique no Conexão menu suspenso.
6. Selecione a organização Salesforce da qual recuperar os componentes dependentes.

   
7. Clique em Executar.

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

   

2

Remover componentes ausentes

As referências a esses componentes são removidas da sua 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 executar novamente o job do PreDeploy Fix.

1. Clique em Remover.

   
2. Clique em Adicionar para cada componente de dependência a ser recuperado.
3. Clique em Remover.

   
4. Insira uma mensagem de commit para as alterações na branch.
5. Clique em Executar.

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

   

3

Ver resultados

1. Clique no Recuperação do Pre Deploy Fix job para recuperar componentes ou Remoção do Pre Deploy Fix job para remover componentes.

   
2. Veja o status e o log do job.