Enviar e implementar paquetes

Para ejecutar su aplicación de comercio en Managed Runtime, primero debe enviar un paquete de código e implementarlo en un entorno de destino.

Esta guía le muestra cómo hacer lo siguiente:

  • Configurar su clave de API.
  • Utilizar un script de línea de comandos para enviar un paquete a Managed Runtime.
  • Utilizar la aplicación web Runtime Admin para implementar un paquete en el entorno de producción.

Before you can use Managed Runtime and Runtime Admin, they must be enabled and you must request access to them. To enable Managed Runtime and Runtime Admin for your organization, reach out to your Salesforce account team. For access, ask your Commerce Cloud administrator to add either one of the following roles to your account using Account Manager: Managed Runtime User or Managed Runtime Admin.

Si ya tiene un archivo .mobify en su directorio principal, puede saltarse esta sección.

Antes de que enviar un paquete, primero debe darle autorización a su computadora.

Inicie el proceso de autorización buscando su clave personal de API:

  1. Inicie sesión en Runtime Admin.
  2. Haga clic en el ícono del perfil de usuario (arriba a la derecha) y haga clic en Configuración de la cuenta.
  3. Desplácese hacia abajo en la sección Clave de API y busque Clave de API personal.
    • Si aún no creó una clave de API, haga clic en el vínculo Generar.
    • Si ya tiene una clave de API, haga clic en el vínculo Restablecer y haga clic en Restablecer mi clave de API cuando se le pida confirmar.
  4. Copie el comando para usar su clave de API.

Por seguridad, cuando vuelve a la página de Configuración de la cuenta, la clave de API no se muestra completa, por lo que deberá restablecerla para copiar de nuevo el texto completo de la clave de API.

Desde la línea de comandos, vaya al directorio de su proyecto de PWA Kit y ejecute el comando que copió.

Vuelva a ejecutar el comando en cualquier otra computadora que desee utilizar para enviar paquetes.

El envío de un paquete implica la ejecución de un script que empaqueta el código en un paquete de Webpack y lo sube a Runtime Manager.

Antes de enviar su primer paquete, verifique que el archivo package.json del directorio de su proyecto PWA Kit esté configurado correctamente:

  1. Inicie sesión en Runtime Admin.
  2. Haga clic en el nombre de su proyecto.
  3. Desde el menú de navegación izquierda, haga clic en Configuración del proyecto.
  4. Copie la cadena de código de identificación del proyecto. Ejemplo: my-project.
  5. Péguela en el campo name en package.json..

Para garantizar que su paquete funcione correctamente cuando se implemente, debe configurar sus conexiones de proxy en su entorno en Runtime Admin.

Para enviar un paquete, vaya a la línea de comandos y ejecute el siguiente comando desde el directorio de su proyecto:

Para obtener una lista de otras opciones que puede suministrar al script de envío, ejecute npm run push -- --help.

Una vez que un paquete se envía de manera exitosa, el mensajeBeginning upload… aparece en la terminal seguido del mensaje Bundle Uploaded!.

Si algo sale mal, fíjese cuál de los tres posibles mensajes de error (basados en los códigos de estado de respuesta de HTTP) se muestran en su terminal luego del mensaje Beginning upload….

A continuación se explica cómo solucionar cada mensaje de error.

El error HTTP 404 aparece en la terminal cuando no existe un proyecto con el nombre especificado en package.json o cuando no se está autorizado a modificar el proyecto.

Cómo solucionar el error:

  1. Repita los pasos para enviar un paquete y asegúrese de que la dirección de correo electrónico y la configuración de la clave de API que pasa al script de envío coinciden con la configuración del Runtime Admin.
  2. Compruebe que su proyecto aparezca en la página de inicio del Runtime Admin en la pestaña Proyectos.
    • Si su proyecto no aparece, póngase en contacto con el servicio de asistencia técnica para asegurarse de que se haya creado el proyecto y de que se le ha concedido acceso a él como miembro del equipo.
  3. Abra el proyecto en el Runtime Admin.
  4. Desde el menú de navegación izquierda, haga clic en Configuración del proyecto.
  5. Copie la cadena de código de identificación del proyecto. Ejemplo: my-project.
  6. Abra el archivo package.json en el directorio del proyecto.
  7. Compruebe que los valores de name y projectSlug coincidan con la cadena de identificación del proyecto que ha copiado.

El error HTTP 401 aparece en la terminal cuando no tiene permiso para enviar paquetes. Para solucionar este error, póngase en contacto con el Commerce Cloud Account Manager y solicite que se eleven sus permisos para incluir el envío de paquetes.

El error HTTP 413 aparece en la terminal cuando el paquete es demasiado grande. El tamaño máximo de los paquetes es de 400 MB y el tamaño máximo de todos los archivos ssr_only y ssr_shared dentro del paquete es de 249 MB. Para solucionar este error, compruebe el tamaño de su paquete inspeccionando la carpeta de construcción dentro de su proyecto. Si su proyecto se acerca al tamaño máximo o ya lo ha superado, esto es lo que puede hacer para reducirlo:

  • Eliminar los activos no utilizados
  • Eliminar los activos innecesarios
  • Escalar imágenes hacia abajo

Después de reducir el tamaño de los archivos de su proyecto, intente enviar el paquete de nuevo.

Los errores de HTTPS pueden producirse cuando las conexiones de proxy de su computadora o red locales, como una VPN o un firewall corporativos, no se configuraron para comunicarse con la API de Managed Runtime que está alojada en cloud.mobify.com.

Estos errores pueden incluir mensajes como unable to get local issuer certificate o self signed certificate in certificate chain.

Para solucionar estos errores, trabaje con su equipo de TI corporativo para configurar la instalación de Node.js para su entorno de red corporativa.

Después de haber enviado un paquete con éxito, puede implementarlo en un entorno de destino.

Para cualquier sitio que utilice un PWA Kit y Managed Runtime, solo se puede designar un paquete a la vez para su implementación en cada entorno. Por defecto, cada proyecto viene con un único entorno llamado production. Puede crear más entornos utilizando el Runtime Admin o la Managed Runtime API.

Para implementar un paquete, haga lo siguiente:

  1. Inicie sesión en Runtime Admin.
  2. Haga clic en el nombre de su proyecto.
  3. En Entornos, haga clic en el nombre del entorno en el que quiere implementar el paquete (ejemplo: Producción).
  4. En Paquetes, haga clic en el botón Implementar al lado del paquete.
  5. Haga clic en Confirmar implementación.
  6. Espere a que la implementación se haya completado.

Una vez que la implementación se haya completado con éxito, el paquete aparece bajo el título Paquete implementado.

Para su primera implementación en un nuevo entorno, el proceso puede tardar hasta una hora en completarse. Las implementaciones posteriores tardan alrededor de un minuto, a menos que se requieran cambios en la CDN. Un cambio de CDN tarda unos 15 minutos y es necesario cuando la implantación contiene cambios en el procesador de solicitudes o en la configuración del proxy.