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.

Antes de poder utilizar Managed Runtime, este debe estar habilitado para su organización. Si aún no se ha habilitado Managed Runtime, póngase en contacto con su equipo de cuentas de Salesforce. Antes de poder enviar e implementar paquetes de código a Managed Runtime, debe solicitar acceso a la aplicación web Runtime Admin. Póngase en contacto con su administrador de Commerce Cloud y pídale que añada alguno de los siguientes roles a su cuenta mediante Account Manager: Managed Runtime User o 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 vuelva a la página de Configuración de la cuenta, la clave de API no se mostrará 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 150 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.

Una vez que haya 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.