Definir papéis e configurações de uma sandbox sob demanda

Objetivos de aprendizagem

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

• Descrever a diferença entre os papéis de sandboxes sob demanda.
  
• Explicar o sistema de crédito das sandboxes sob demanda.
  
• Explicar a finalidade da propriedade do tempo de vida (TTL) da ODS.
  
• Resumir os requisitos para um cliente de API e uma ID de realm.
  

Configurar papéis de usuário para sandboxes sob demanda

Para criar uma ODS do Commerce for B2C usando a opção API REST da sandbox de desenvolvedor do Commerce for B2C, você precisa de papéis e permissões específicas no ecossistema do Salesforce. Esses papéis e permissões garantem acesso seguro e autorizado às APIs e aos recursos necessários. Veja os principais requisitos.

O administrador do Commerce for B2C usa o Gerente de conta para atribuir papéis com um filtro de escopo. As configurações do filtro de escopo incluem:

• All sandboxes (Todas as sandboxes): o filtro concede acesso a todas as sandboxes, operações no nível de realm e criação ou exclusão de sandboxes.
  
• Individual sandboxes (Sandboxes individuais): o filtro concede acesso somente a essas sandboxes específicas e suas APIs. O filtro da sandbox individual não concede acesso no nível de realm nem a capacidade de criar novas sandboxes.
  

Para saber mais sobre como atribuir papéis a usuários novos ou existentes, consulte Criar uma conta de usuário no B2C Commerce ou Editar uma conta de usuário no B2C Commerce.

Gerenciar custos com créditos de sandboxes sob demanda

As sandboxes sob demanda operam em um sistema baseado em créditos. As organizações compram créditos de sandboxes para permitir a criação e o gerenciamento dessas sandboxes. O sistema de crédito oferece flexibilidade para que você possa usar os créditos adquiridos da maneira que desejar.

Por exemplo, dependendo das suas necessidades, você pode manter apenas algumas sandboxes em execução por um período prolongado ou criar várias sandboxes de curto prazo. Ao ser criada ou iniciada, a sandbox começa a consumir tempo de atividade em créditos por minuto. O número de créditos que uma sandbox consome por minuto depende da opção do perfil de recursos que ela utiliza. As opções do perfil de recursos incluem:

• médio: (Padrão) 1 CPU, 10 GB de armazenamento. Use esse nível para desenvolvimento padrão.
  
• grande: 2 CPUs, 20 GB de armazenamento. Use esse nível para grandes conjuntos de dados.
  
• extra Grande ou extra extra grande: até 8 CPUs e 100 GB de armazenamento. Use esses níveis para tarefas de desempenho intensivo.
  

Os desenvolvedores precisam de ambientes que espelhem as especificações de produção para garantir a compatibilidade e o desempenho do código. O perfil de recursos correto ajuda a sandbox a lidar com a carga de trabalho, como testes automatizados complexos ou atualizações simples de recursos, sem desperdiçar créditos.

Usuários com o papel Sandbox API User (Usuário da API Sandbox) podem controlar o consumo de créditos. Ao gerenciar sandboxes e créditos de sandbox, considere os seguintes pontos.

• Por padrão, as sandboxes usam um perfil de recursos médio. Uma sandbox com o perfil de recursos médio consome 1 crédito por minuto ou fração de minuto. Uma sandbox com um perfil de recursos grande ou extra grande consome créditos de disponibilidade em uma taxa maior.
  
• Sandboxes interrompidas consomem menos créditos por minuto. Quando interrompidas, independentemente do perfil de recursos que utilizam, todas as sandboxes consomem créditos de inatividade a uma taxa de 0,3 créditos por minuto ou fração de minuto.
  
• Quando uma sandbox é excluída, ela para de consumir créditos.
  
• Sandboxes que estão inativas devido a problemas técnicos não consomem créditos.
  

As sandboxes consomem créditos mesmo quando são interrompidas. Exclua as sandboxes que você não precisa e crie-as quando estiver pronto para usá-las novamente. Pare e reinicie uma sandbox somente quando quiser manter os dados exatos que você configurou nela.

Controlar créditos com um Agendador de operações

As sandboxes que funcionam 24 horas por dia, 7 dias por semana, consomem créditos desnecessariamente. Para gerenciar sandboxes em um realm de forma eficiente, você pode criar um Agendador de operações para iniciar e interromper sandboxes de modo que elas sejam executadas somente durante o horário comercial. Na interface do usuário do Swagger da API REST da sandbox do desenvolvedor do B2C Commerce, o exemplo para criar um agendador de operações com uma chamada de API PATCH/realms/{realm}/configuration sandbox especifica um agendamento para iniciar e interromper a sandbox todos os dias durante a semana.

{
  "emails": [
    "email1@example.com",
    "email2@example.com"
  ],
  "sandbox": {
    "sandboxTTL": {
      "maximum": 240,
      "defaultValue": 24
    },
    "startScheduler": {
      "weekdays": [
        "MONDAY",
        "TUESDAY",
        "WEDNESDAY",
        "THURSDAY",
        "FRIDAY"
      ],
      "time": "08:00:00+03:00"
    },
    "stopScheduler": {
      "weekdays": [
        "MONDAY",
        "TUESDAY",
        "WEDNESDAY",
        "THURSDAY",
        "FRIDAY"
      ],
      "time": "19:00:00Z"
    }
  }
}

O controle automatizado dos horários de início e término ajuda você a gerenciar o consumo de créditos garantindo que seus ambientes de sandbox permaneçam disponíveis para atividades críticas de desenvolvimento e teste, sem exceder os créditos alocados.

Gerenciar a vida útil do ODS com o tempo de vida

Ao criar uma sandbox sob demanda, você pode usar o valor opcional de tempo de vida (TTL) para especificar exatamente quantas horas a sandbox permanecerá ativa antes de ser excluída automaticamente pelo sistema.

Por exemplo, se você definir um TTL de 24 e sua sandbox durará 24 horas. Após esse temporizador expirar, o sistema excluirá a sandbox e todos os seus dados.

Definir o TTL do realm

A configuração do realm define o TTL padrão e máximo para todas as sandboxes dentro dela. Você pode ajustar o padrão de 24 horas ou o limite máximo (até 2.160 horas) usando uma chamada de API PATCH/realms/{realm}/configuration. Definir o TTL máximo como 0 permite que as sandboxes permaneçam ativas até serem excluídas manualmente.

Definir o TTL da sua sandbox

Para personalizar um ambiente específico, defina um TTL individual que substitua o padrão do realm. Os valores individuais não devem exceder o limite máximo do realm. Definir o TTL de uma sandbox como 0 mantém essa instância específica ativa indefinidamente, desde que esteja em conformidade com o nível máximo do realm.

Melhores práticas de TTL

Selecione uma estratégia de TTL que atenda às necessidades do seu projeto.

• Short-term (Curto prazo): no caso de tarefas rápidas, especifique um TTL que abranja apenas o tempo necessário.
  
• Uncertain timeline (Cronograma incerto): para projetos com duração indefinida, defina o TTL como 0 para que dure até que você o exclua.
  
• Safety net (Rede de segurança): como alternativa, use um TTL longo, como 2.100 horas, e exclua manualmente a sandbox ao terminar para economizar créditos.
  

Adicionar uma ID de cliente da API

O processo de autenticação da API REST da sandbox de desenvolvedor do Commerce for B2C exige uma ID de cliente da API. A ID de cliente ajuda a:

• Identificar o aplicativo cliente que está fazendo a solicitação.
  
• Garantir que a solicitação esteja vindo de uma fonte autorizada.
  
• Monitorar e gerenciar o uso da API.
  

Se você planeja usar scripts para automatizar chamadas de API, a ID de cliente da API exigirá a senha para autenticação.

Para adicionar uma ID de cliente da API para a API Sandbox, use o procedimento Adicionar um cliente da API no B2C Commerce. Os usuários com os papéis Account Administrator (Administrador de conta) ou API Administrator (Administrador de API) podem gerenciar IDs de cliente da API.

Obter a ID do seu realm

Um realm inclui um Grupo de instância primária (PIG) e um Grupo de instâncias secundárias (SIG). O SIG contém as sandboxes. Cada realm tem uma ID exclusiva de quatro caracteres que você pode obter com seu executivo de conta (AE - account executive) ou gerente de sucesso do cliente (CSM - customer success manager).

Próximas etapas

Nesta unidade, você viu como atribuir papéis de usuário. Você também aprendeu sobre créditos de sandbox e como gerenciá-los. Em seguida, você descobrirá como usar a API REST da sandbox de desenvolvedor do Commerce for B2C com a interface do Swagger para criar uma sandbox sob demanda do Commerce for B2C.

Recursos

• Ajuda do Salesforce: Gerente de conta do B2C Commerce
• GitHub:
• Agentforce Commerce: Gerente de conta (é necessário ter credenciais de Gerente de conta)