Configurar a replicação de código

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

• Listar os quatro tipos de processo de replicação de código.
  
• Descrever como transferir uma nova versão de código de uma sandbox para uma instância de desenvolvimento.
  
• Listar os métodos de ativação da replicação de código.
  
• Listar três etapas em um processo manual de replicação de código.
  

Desenvolvedores verificam regularmente o código em um sistema de controle de versão e, em seguida, usam uma ferramenta de integração contínua e implantação contínua (CI/CD) para colocar uma nova versão de código na instância de preparação. Dependendo dos processos da sua empresa, o desenvolvedor ou administrador do B2C transfere a nova versão do código da instância de preparação para uma instância de desenvolvimento e, em seguida, para uma instância de produção, e, em seguida, ativa-a.

A replicação de código, como a replicação de dados, tem uma origem e um destino. A replicação de dados lida com dependências entre objetos de dados, complicando as coisas. A replicação de código é simples. Quando você replica uma versão de código, o Salesforce B2C Commerce atribui à versão na instância de destino o mesmo nome da versão de origem na fase de preparação. Se o nome já existir, ele anexa um carimbo de data/hora e número de índice ao nome.

Por exemplo, o nome da nova versão do código é versão-19b. Uma versão com esse nome já existe na instância de destino, então o B2C Commerce nomeia a nova versão como versão-19b_01202019-1.

Assim como a replicação de dados, a replicação de código é um processo de duas etapas.

• O B2C Commerce transfere uma versão de código da instância de preparação para a instância de destino.
  
• Ele ativa o código na instância de destino.
  

Execute ambas as etapas como um único processo de replicação, ou execute-as separadamente. Executá-las separadamente ajudará a identificar possíveis fontes de falha. Todos os processos de replicação de código são executados na instância de preparação, até mesmo ativar código e desfazer, que afetam apenas a instância de destino.

Existem quatro tipos de processos de replicação de código.

• Transferência de código: o B2C Commerce transfere a versão de código selecionada na instância de origem para a instância de destino, mas não a ativa.
  
• Transferência e ativação de código: o B2C Commerce transfere a versão de código selecionada na instância de origem para a instância de destino e, em seguida, ativa-a.
  
• Ativação de código: este processo só estará disponível após a realização bem-sucedida de um processo de transferência de código. A ativação torna a versão de código transferida a versão ativa na instância de destino. Se a nova versão de código já está ativa, nada acontece. Se ela não existir na instância de destino, a replicação falha.
  
• Desfazer: este processo só estará disponível após a realização bem-sucedida de um processo de replicação de transferência e ativação de código ou apenas de ativação de código. Ele reverte a versão de código ativa na instância de destino para a versão que estava ativa antes do último processo de replicação de código. Se a versão que você quer reverter não está mais ativa, nada acontece. Se ela não existir mais na instância de destino ou se a versão de código anteriormente ativa não existir mais, o processo de replicação falhará.
  

Selecionar métodos de ativação

Você especifica como deseja executar um processo de replicação. Suas opções são:

• Manual: o processo é executado quando você o aciona.
  
• Automatic (Automático): você agenda um dia e hora para execução do processo.
  
• Job Step (Etapa do trabalho): o processo é executado como parte de um trabalho. Falamos sobre trabalhos no módulo Trabalhos agendados do Salesforce B2C Commerce.
  

Criar um processo de replicação de código

Digamos que você queira lançar um novo código o mais rápido possível, e já passou da hora do expediente, um bom momento para esse tipo de tarefa. Veja como criar um processo de replicação de código que você pode acionar manualmente.

1. No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Administration (Administração) | Replication (Replicação) | Code Replication (Replicação de código). 
   

2. Clique em Novo. (Você deve estar em uma instância de preparação para ver este botão.)
   
3. O B2C Commerce cria uma ID de processo ou você pode inserir o texto que quiser.
   
4. Selecione a instância de destino Desenvolvimento.
   
5. Insira uma descrição opcional. A descrição ajuda você a encontrar o processo posteriormente.
   
6. Para o tipo de ativação, selecione Manual.
   
7. Selecione um acionador de e-mail de notificação e insira vários endereços de e-mail de destino separados por vírgulas. O e-mail contém a hora de início e término do processo, o sistema de destino, tipo de replicação e tarefas de replicação. Se o processo falhar, a notificação por e-mail inclui um código de erro. Cada processo em uma série recorrente envia sua própria notificação.
   
8. Especifique o que acontece com esses eventos.
   

• Nenhum: nenhum email enviado
  
• O processo é concluído: o B2C Commerce envia um e-mail para os endereços quando o processo termina, não importa se ele teve êxito ou não. Se ele travar, não envia um e-mail.
  
• O processo falha: se o processo falhar, o B2C Commerce enviará um email para os endereços. Se o processo tiver êxito ou travar, ele não envia um e-mail.
  
• Periodicamente: envia emails em um intervalo especificado enquanto o processo está em execução e também quando ele é concluído.
  

9. Clique em Próximo.
   
10. Para o tipo de replicação, selecione Transferência e ativação de código.
    
11. Clique em Avançar e revise os detalhes do processo. Depois de criar o processo, você não poderá alterá-lo.
    
12. Clique em Iniciar para criar o processo e executá-lo imediatamente.
    

Você e o desenvolvedor testam o novo código na instância de desenvolvimento. Quando tudo parece estar bem, você replica a mesma versão de código da instância de preparação para a instância de produção.

Próximas etapas

Nesta unidade, você aprendeu que a replicação de código é bastante simples e requer apenas um número de versão exclusivo. Depois que seu desenvolvedor carregou o código para a instância de preparação, replique-o da instância de preparação para a de desenvolvimento e, em seguida, para a instância de produção. Você também aprendeu sobre os tipos de processos de replicação de código e os métodos de ativação, além de como executar uma replicação de código manual. A seguir, saiba mais sobre a replicação de dados granular.

Recursos

• Trailhead: anunciantes do Agentforce Commerce for B2C
• Trailhead: Arquitetura do Salesforce B2C Commerce
• Ajuda do Salesforce: Replicação de código