Implante seu código

Para executar seu aplicativo de comércio no Managed Runtime, primeiro você deve enviar por push um pacote de códigos e implantá-lo em um ambiente de destino.

Esse guia mostra como:

Configurar sua chave de API.
Usar um script de linha de comando para enviar um pacote ao Managed Runtime.
Usar o aplicativo da web Runtime Admin para implantar um pacote em um ambiente de Production.

Antes de usar o Managed Runtime e o Runtime Admin, eles devem estar habilitados e você deve solicitar acesso a eles. Para habilitar o Managed Runtime e o Runtime Admin para sua organização, entre em contato com a equipe de contas do Salesforce. Para ter acesso, peça ao administrador do Commerce Cloud que adicione uma das seguintes funções à sua conta usando Account Manager: Managed Runtime User ou Managed Runtime Admin.

Important

Salvar suas credenciais

Se você já tem um arquivo .mobify no seu diretório home, ignore esta seção.

Note

Antes que você possa enviar um pacote, autorize seu computador primeiro.

Inicie o processo de autorização buscando sua chave pessoal de API:

Faça logon no Runtime Admin.
Clique no ícone de perfil do usuário (canto superior direito) e depois em Account Settings (Configurações da conta).
Role até a seção chamada API Key (Chave da API) e busque a Personal API Key (Chave pessoal da API).
- Caso você ainda não tenha criado uma chave da API, clique no link Generate (Gerar).
- Se já tiver uma chave da API, clique no link Reset (Redefinir) e depois em Reset my API Key (Redefinir minha chave da API) quando for solicitada a confirmação.
Copie o comando para usar sua chave da API.

Por segurança, quando você volta à página Account Settings (Configurações da conta), a chave da API não é mostrada na íntegra. Sendo assim, será preciso redefinir a chave para copiar o texto completo da chave da API novamente.

Na linha de comando, acesse o diretório do seu projeto do PWA Kit e execute o comando que você copiou.

Execute o comando novamente em todos os computadores que queira usar para transmitir pacotes.

Enviar um pacote por push

Transmitir um pacote envolve a e execução de um script que empacota seu código em um pacote Webpack e o carrega no Runtime Manager.

Verificar a configuração do projeto

Antes de enviar seu primeiro pacote, verifique se o arquivo package.json no diretório do seu projeto criado com o PWA Kit está configurado corretamente:

Faça logon no Runtime Admin.
Clique no link do projeto.
No menu de navegação à esquerda, clique em Project Settings (Configurações do projeto).
Copie a string Project ID (ID do projeto). Exemplo: my-project.
Cole-a no campo name em package.json..

Configurar proxies de ambiente

Para garantir que o pacote funcione corretamente após a implantação, configure os proxies em seu ambiente do Runtime Admin.

Configurar variáveis de ambiente

Se você estiver usando um cliente privado SLAS, deverá definir o segredo do cliente por meio de uma variável de ambiente.

Os projetos gerados a partir do PWA Kit 3.5 e superior serão configurados para usar um cliente privado SLAS por padrão.

Para saber mais sobre como usar clientes privados SLAS, consulte Usar um cliente privado SLAS.

Note

Executar o script de envio por push

Para transmitir um pacote, na linha de comando e do diretório de seu projeto, execute o comando a seguir:

1npm run push -- -m "Message to help you recognize this bundle"

Para ver a lista com outras opções que você pode fornecer ao script de transmissão, execute npm run push -- --help.

Solucionar erros na transmissão de pacotes

Quando um pacote é transmitido com sucesso, a mensagem Beginning upload… aparece no terminal seguida da mensagem Bundle Uploaded!.

Se algo sai errado, busque por uma das três mensagens de erro possíveis (com base nos códigos de estado da resposta HTTP em seu terminal depois da mensagem Beginning upload….

Veja aqui como solucionar cada mensagem de erro.

Erro HTTP 404

Um erro HTTP 404 é retornado no terminal quando um projeto não existe com o nome especificado em package.json ou quando você não tem autorização para modificar o projeto.

Para corrigir o erro:

Repita as etapas para transmitir um pacote e garanta que o endereço de e-mail e as configurações da chave de API dadas ao script de transmissão coincidam com as configurações no Runtime Admin.
Verifique que seu projeto apareça na página inicial do Runtime Admin, em Projetos.
- Se seu projeto não aparece, entre em contato com o suporte para se certificar de que seu projeto tenha sido criado e que você recebeu direito de acesso a ele como membro da equipe.
Abra o projeto no Runtime Admin.
No menu de navegação à esquerda, clique em Configurações do projeto.
Copie a string Project ID (ID do projeto). Exemplo: my-project.
Abra o package.json dentro do diretório de seu projeto.
Verifique que os valores de name e projectSlug coincidam com a string da ID do projeto que você copiou.

Erro HTTP 401

Um erro HTTP 401 é retornado no terminal quando você não tem autorização para transmitir pacotes. Para corrigir esse erro, entre em contato com o administrador do Commerce Cloud Account Manager e solicite que a transmissão de pacotes esteja entre as ações que você pode realizar.

Erro HTTP 413

Um erro HTTP 413 é retornado no terminal quando seu pacote é muito extenso. O tamanho máximo de pacotes é 400 MB, e o tamanho máximo de todos os arquivos ssr_only e ssr_shared no pacote é 249 MB. Para corrigir esse erro, verifique o tamanho de seu pacote ao inspecionar a pasta de build de seu projeto. Se seu projeto estiver perto do tamanho máximo ou o exceder, reduza-o por meio de uma das soluções abaixo:

Remova ativos em desuso
Remova ativos desnecessários
Reduza o tamanho das imagens

Depois de reduzir o tamanho dos arquivos de projeto, tente transmitir o pacote novamente.

Erros HTTPS

Os erros HTTPS podem ocorrer quando os proxies de sua rede ou computador local, como uma VPN ou firewall corporativo, não foram configurados para se comunicar com a API do Managed Runtime, hospedada em cloud.mobify.com.

Esses erros podem incluir mensagens como unable to get local issuer certificate ou self signed certificate in certificate chain.

Para resolver esses erros, trabalhe com a equipe de TI da empresa para configurar sua instalação do Node.js no ambiente da rede corporativa.

Implantar um pacote

Depois de transmitir um pacote com sucesso, você pode implantá-lo no ambiente de destino.

Para qualquer site que usa PWA Kit e Managed Runtime, só é possível designar um pacote por vez como implantado para cada ambiente. Por padrão, cada projeto vem com um ambiente exclusivo, chamado production. Você pode criar mais ambientes usando o Runtime Admin ou o Managed Runtime API.

Para implantar um pacote:

Faça logon no Runtime Admin.
Clique no link do projeto.
Em Environments (Ambientes), clique no nome do ambiente onde deseja implantar (exemplo: Production).
Em Bundles (Pacotes), clique no botão Deploy (Implantar) ao lado do pacote.
Clique em Confirm Deploy (Confirmar implantação).
Espere até que a implantação seja concluída.

Quando a implantação for concluída, o pacote aparecerá sob o cabeçalho Deployed Bundle (Pacote implantado).

Para sua primeira implantação em um novo ambiente, o processo pode levar até uma hora para ser concluído. As implantações subsequentes levam cerca de um minuto, a menos que seja necessário fazer alterações à CDN. Uma mudança da CDN leva cerca de quinze minutos e é necessária quando a implantação contém alterações às configurações do proxy ou do processador de solicitações.

Note