Clonar sandboxes sob demanda

Objetivos de aprendizagem

Descrever as principais características, inclusões e exclusões do clone de uma sandbox sob demanda.
Descrever os quatro principais estágios e etapas do processo de clonagem de sandboxes.
Realizar uma operação de clonagem de sandbox usando o Centro de controle
Identificar e atualizar as configurações personalizadas necessárias em uma sandbox recém-clonada.
Descrever as três principais operações de clonagem da API REST da sandbox sob demanda.

A clonagem de sandboxes sob demanda cria réplicas exatas de sandboxes existentes em minutos. As equipes trabalham mais rápido e reduzem os riscos ao atuarem em ambientes totalmente isolados para fluxos de trabalho de desenvolvimento, teste e operação. Cada sandbox clonada conta com recursos dedicados de computação, armazenamento e banco de dados.

Os casos de uso típicos incluem a reprodução segura de erros de produção, a validação de planos de recuperação de desastres e o fornecimento de ambientes de treinamento realistas.

Saiba o que uma sandbox clonada inclui e exclui

O clone de uma sandbox oferece uma cópia completa dos elementos essenciais do seu ambiente. Um clone inclui os seguintes elementos:

Esquema e dados do banco de dados
Código e cartridges personalizados
Loja virtual, dados do site e configurações
Catálogos e catálogos de preços
Pedidos e dados de conteúdo
Alternadores de recursos
Páginas de manutenção
Arquivos de configuração padrão da plataforma

O processo de clonagem exclui dados específicos para proteger a segurança, a privacidade e a integridade do locatário. Os itens excluídos incluem os seguintes elementos:

Logs e histórico de trabalhos
Dados de identificação pessoal (PII) do cliente e dados relacionados ao RGPD
Dados de análise
Dados de geolocalização
Atividade do pedido
Dados de taxa de câmbio
Logs de alterações
Configurações específicas do locatário

O sistema omite ou transforma dados confidenciais para garantir a conformidade com os requisitos de segurança e privacidade da plataforma.

Explorar como a clonagem de sandboxes funciona

O processo de clonagem agrupa seis etapas detalhadas em quatro fases principais.

Prep instance (Instância de preparação): valida o status, as permissões e a disponibilidade de recursos do sandbox de origem.
Data backup (Backup de dados): cria um instantâneo consistente do banco de dados de origem, dos dados compartilhados e das configurações.
Data restore (Restauração de dados): aloca recursos de computação, armazenamento e rede para a nova sandbox. O sistema copia tabelas, índices e arquivos do banco de dados para o ambiente clonado. Em seguida, atualiza os arquivos e credenciais do sistema para garantir a independência.
Post validation (Pós-validação): valida a integridade da sandbox, testa a conectividade e ativa o clone.

Para garantir a integridade dos dados e a consistência da configuração, a sandbox de origem entra temporariamente em um estado de interrupção protegida. Após a conclusão da clonagem, a sandbox de origem retoma a operação normal. A duração total geralmente varia de 10 a 30 minutos, dependendo do tamanho da sandbox e do volume de dados.

Verificar pré-requisitos antes de clonar uma sandbox

Antes de iniciar uma operação de clonagem, verifique estes requisitos.

O Gerente de conta atribui a você o papel Sandbox API User (Usuário da API Sandbox) com um filtro de locatário no formato <realm_id>_sbx.
A sandbox de origem tem um status ativo.
A sandbox de origem tem o estado em execução ou interrompido.
A sandbox de origem não tem operações pendentes.
Sua conta tem permissões para acessar dados da sandbox de origem.

Criar e gerenciar uma sandbox clonada no Centro de controle

Siga estas etapas para clonar uma sandbox sob demanda existente usando o Centro de controle.

Faça login no Centro de controle.
Selecione o realm no qual você planeja criar o clone.
Clique no botão Clone (Clonar) ao lado da instância que você pretende clonar.
Preencha o formulário Clone On-Demand Sandbox (Clonar sandbox sob demanda).

Tempo de vida (TTL): selecione o número de horas que a sandbox clonada permanecerá ativa. As opções incluem 24 (o padrão e limite mínimo), 48, 72, 168 (1 semana) ou 0 (tempo infinito).
Perfil de recursos: selecione a alocação de recursos (médio, grande, extra grande ou extra extra grande). O perfil de destino exige o mesmo tamanho ou um tamanho maior que o perfil da sandbox de origem.
Emails de notificação: insira um ou mais endereços de email para receber notificações ou deixe a opção Retain Email Addresses (Manter endereços de email) selecionada para usar os endereços de notificação da sandbox de origem.

Clique em Clone Instance (Clonar instância).

Assim que o processo começar, o status da sandbox de origem mudará para clonando. O Centro de controle desabilita todas as ações (iniciar, interromper, redefinir, clonar e excluir) para a sandbox de origem até que a clonagem seja concluída.

Gerenciar e monitorar seus clones

Acompanhe o progresso das operações de clonagem e visualize detalhes sobre as sandboxes clonadas diretamente no Centro de controle. A sandbox de destino aparece na lista de instâncias com o status Setting Up (Em configuração). Quando a configuração for concluída, o status será atualizado para Running (Em execução) (se bem-sucedido) ou Failed (Com falha).

Clique no emblema Clone (Clonar) ao lado da instância clonada para visualizar detalhes específicos, como os identificadores das instâncias de origem e de destino, o carimbo de data/hora da clonagem, a contagem de lojas virtuais, a versão do código personalizado, o tamanho do banco de dados e o tamanho do sistema de arquivos.

Para revisar todas as operações de clonagem associadas a uma sandbox específica, acesse a guia Activity Timeline (Linha do tempo de atividades) dessa sandbox. Essa guia lista as operações em ordem cronológica e mostra uma contagem resumida de clones por status (Completed [Concluído], Failed [Com falha] e In Progress [Em andamento]). Use as opções Filter & Search (Filtrar e pesquisar) para restringir os resultados por intervalo de datas ou status específico.

Após a conclusão da clonagem, teste todas as integrações e atualize os pontos de extremidade de terceiros ou as configurações personalizadas que fazem referência à sandbox de origem. Quando você já não precisar de uma sandbox clonada, exclua a sandbox para reduzir o consumo de créditos. Sempre salve qualquer trabalho aberto antes de acionar uma operação de clonagem, pois a sandbox de origem é interrompida durante o processo.

Após a conclusão de uma operação de clonagem, você atualizará manualmente vários itens para garantir que a nova sandbox funcione corretamente. O sistema atualiza automaticamente os arquivos padrão da plataforma, mas deixa as configurações personalizadas inalteradas. Revise e ajuste essas configurações personalizadas para manter um ambiente de trabalho.

Especificamente, atualize esses elementos, caso eles existam em seu ambiente:

Configurações personalizadas específicas do locatário
URLs codificadas localizadas em cartridges ou scripts personalizados
URLs de serviços de terceiros e pontos de extremidade de API externas
Referências do repositório de chaves e certificados personalizados vinculados à sandbox de origem
Tarefas ou agendamentos personalizados que fazem referência à instância de origem original
Personalizações do Business Manager

Clonar sandboxes com a API REST

Você pode clonar sandboxes por meio da API REST da sandbox sob demanda do Commerce for B2C. A API de clonagem oferece aos desenvolvedores controle programático sobre a criação, o provisionamento e o monitoramento de ambientes clonados.

A API REST da sandbox sob demanda do Commerce for B2C oferece três operações específicas para a clonagem de sandboxes.

Criar um clone

Inicie uma operação de clonagem usando o ponto de extremidade POST. A solicitação exige o elemento sandboxId exclusivo da sandbox de origem e o tamanho médio, grande, extra grande ou extra extra grande de um targetProfile. O perfil de destino deve ter um tamanho igual ou maior que o perfil da sandbox de origem. Parâmetros opcionais incluem uma lista de emails de notificação e um TTL em horas. Uma solicitação bem-sucedida retorna uma resposta 200 OK com um cloneId para rastrear o status da operação.

Monitorar as operações de clonagem de sandboxes

Acompanhe o progresso de uma operação de clonagem ativa ou recupere detalhes de uma sandbox clonada específica. Esta solicitação requer o elemento sandboxId de origem e o cloneId específico. Uma resposta 200 OK bem-sucedida retorna detalhes como o ID da instância de destino, carimbos de data/hora, tempo decorrido, porcentagem de progresso e o status atual (IN_PROGRESS [EM ANDAMENTO], COMPLETED [CONCLUÍDO] ou FAILED [COM FALHA]).

Listar todos os clones

Busque detalhes de todas as operações de clonagem associadas a uma sandbox de origem específica. Essa solicitação exige o sandboxId de origem. Você pode filtrar os resultados fornecendo as opções fromDate, toDate ou status específico, como Pending (Pendente), InProgress (Em andamento), Failed (Com falha) ou Completed (Concluído). A resposta 200 OK retorna uma lista completa de todas as operações de clonagem associadas e seus respectivos detalhes.

Acesse a documentação e faça chamadas à API diretamente da interface de usuário da API Sandbox em https://admin.dx.commercecloud.salesforce.com/, fazendo a autorização com sua ID de cliente da API.

Para saber mais sobre clonagem com a API REST da sandbox sob demanda, explore Clonar sandboxes sob demanda.

Finalização

Nesta unidade final, você viu como clonar uma ODS, que cria réplicas exatas de um ambiente para desenvolvimento e teste, incluindo o banco de dados, o código personalizado e as configurações, e excluindo dados confidenciais como PII e logs. Você também aprendeu como realizar essas operações de clonagem usando a interface do usuário do Centro de controle e a API REST da sandbox.

Ao longo deste emblema, você aprendeu como configurar e gerenciar ambientes de ODS para entrega e desenvolvimento rápidos de comércio eletrônico. Você também explorou as diferenças fundamentais entre sandboxes baseadas em ODS e POD, como configurar funções de usuário e gerenciar custos usando os sistemas de crédito e TTL, e como executar todas as operações do ciclo de vida da sandbox por meio da API Sandbox e do Centro de controle.

Tempo estimado

Tópicos

Procurando ajuda?