Managed Runtime facilita la gestión de sus organizaciones, proyectos, entornos y paquetes asociados a su escaparate de PWA Kit. Esta guía describe la creciente lista de tareas de administración posibles con la herramienta web de Runtime Admin. (Todas las tareas de administración descritas en esta guía, y muchas más, también pueden llevarse a cabo con la Managed Runtime API).
Antes de continuar, asegúrese de tener acceso a Managed Runtime y a Runtime Admin. Para aprovisionar Managed Runtime, póngase en contacto con su Success Manager. Para el 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 a través del Account Manager: Usuario de Managed Runtime o Managed Runtime Admin.
Important
Los proyectos le ayudan a gestionar múltiples entornos dentro de una organización. Cada proyecto de PWA Kit necesita un proyecto correspondiente dentro de Managed Runtime para implementar y alojar el código del escaparate en la infraestructura de la nube pública de Salesforce.
Para crear un proyecto en Runtime Admin:
Al crear un proyecto por primera vez, el sitio no es accesible en la web hasta que se implementa la infraestructura necesaria en la nube. Este proceso de implementación puede tardar hasta 40 minutos.
Note
Las instrucciones para el resto de las tareas de administración en esta guía están planteadas asumiendo que se inicia desde la página de Overview (Visión general) del proyecto en Runtime Admin.
Para encontrar un proyecto existente y abrir la página de Overview (Visión general) de este, haga lo siguiente:
Para pasar rápidamente de un proyecto a otro, utilice el menú de proyectos situado en la parte superior de la página.
Desde la página de Project Settings (Configuración del proyecto) se pueden realizar las siguientes tareas:
Para acceder a la página de Project Settings (Configuración del proyecto), haga lo siguiente:
Para editar la configuración, haga clic en Edit (Editar), haga los cambios deseados y haga clic en Update (Actualizar). Para rechazar los cambios, haga clic en Cancel (Cancelar).
Para borrar un proyecto, haga clic en Delete (Eliminar), escriba el nombre del proyecto para confirmar la acción y haga clic en Yes, Delete (Sí, eliminar). Para conservar el proyecto, haga clic en No, Keep (No, conservar).
Puede elegir si desea recibir una notificación por correo electrónico cada vez que se produzca alguno de los siguientes eventos de implementación:
Para agregar una notificación, haga lo siguiente:
Para editar una notificación, haga lo siguiente:
Para quitar una notificación:
Los entornos se utilizan para separar su escaparate de producción de otros escaparates que se implementan para otros fines, como el desarrollo o la ejecución de pruebas. Para obtener más información sobre los entornos y otros conceptos relacionados, consulte la Visión general Managed Runtime.
Para crear un entorno en Runtime Admin, haga lo siguiente:
Vaya a la página Overview (Visión general) del proyecto.
Haga clic en New Environment (Nuevo entorno).
Escriba un nombre para el entorno.
Seleccione una región para la implementación en la infraestructura de nube pública de Salesforce.
Si el entorno es un entorno de producción:
Seleccione una instancia de Commerce Cloud para conectarse al entorno.
Haga clic en Completar configuración.
Note
Todas las regiones admitidas tienen una región de copia de seguridad emparejada para las conmutaciones por error. Usted es responsable de asegurarse de que la aplicación se ejecute correctamente en las regiones primaria y de copia de seguridad seleccionadas:
| Región primaria | Región de copia de seguridad |
|---|---|
us-east-1 - Este de EE. UU. (Norte de Virginia) |
us-east-2 - Este de EE. UU. (Ohio) |
us-east-2 - Este de EE. UU. (Ohio) |
us-east-1 - Este de EE. UU. (Norte de Virginia) |
us-west-1 - Oeste de EE. UU. (Norte de California) |
us-west-2 - Oeste de EE. UU. (Oregón) |
us-west-2 - Oeste de EE. UU. (Oregón) |
us-west-1 - Oeste de EE. UU. (Norte de California) |
ca-central-1 - Canadá (Central) |
us-east-2 - Este de EE. UU. (Ohio) |
sa-east-1 - América del Sur (São Paulo) |
us-east-1 - Este de EE. UU. (Norte de Virginia) |
ap-south-1 - Asia Pacífico (Bombay) |
ap-south-2 - Asia Pacífico (Hyderabad) |
ap-south-2 - Asia Pacífico (Hyderabad) |
ap-south-1 - Asia Pacífico (Bombay) |
ap-southeast-1 - Asia Pacífico (Singapur) |
ap-northeast-2 - Asia Pacífico (Seúl) |
ap-southeast-2 - Asia Pacífico (Sídney) |
ap-southeast-1 - Asia Pacífico (Singapur) |
ap-southeast-3 - Asia-Pacífico (Jakarta) |
ap-southeast-1 - Asia Pacífico (Singapur) |
ap-northeast-2 - Asia Pacífico (Seúl) |
ap-southeast-1 - Asia Pacífico (Singapur) |
ap-northeast-1 - Asia Pacífico (Tokio) |
ap-northeast-3 - Asia Pacífico (Osaka) |
ap-northeast-3 - Asia Pacífico (Osaka) |
ap-northeast-1 - Asia Pacífico (Tokio) |
eu-west-1 - UE (Irlanda) |
eu-west-3 - UE (París) |
eu-west-2 - UE (Londres) |
eu-west-1 - UE (Irlanda) |
eu-west-3 - UE (París) |
eu-central-1 - UE (Fráncfort) |
eu-central-1 - UE (Fráncfort) |
eu-west-3 - UE (París) |
eu-central-2 - UE (Zurich) |
eu-central-1 - UE (Fráncfort) |
eu-south-1 - UE (Milán) |
eu-central-1 - UE (Fráncfort) |
me-central-1 - Medio Oriente (Emiratos Árabes Unidos) |
eu-west-2 - UE (Londres) |
il-central-1 - Israel (Tel Aviv) |
eu-west-2 - UE (Londres) |
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.
Una vez que la implementación se haya completado con éxito, el paquete aparece debajo del encabezado Deployed Bundle (Paquete implementado). (Para su primera implementación en un nuevo entorno, el proceso puede tardar hasta una hora en completarse).
La página de Configuración del entorno es el lugar desde donde se pueden llevar a cabo muchas tareas de administración desde un solo lugar, incluidas las siguientes:
Para acceder a la página Environment Settings (Configuración del entorno), haga lo siguiente:
Para comenzar a editar, haga clic en el botón Edit (Editar) al lado de configuración General o Advanced (Avanzada). Al finalizar la edición, haga clic en Update (Actualizar) para guardar los cambios o en Cancel (Cancelar) para descartarlos.
Puede borrar parte o la totalidad del contenido almacenado en caché de un entorno en la red de entrega de contenido (CDN). Borrar la caché de la CDN ayuda a garantizar que los compradores vean la versión más reciente y precisa del contenido de su sitio.
Use la API para borrar todo el projects_target_invalidation_create contenido almacenado en caché, las URL específicas o los directorios.
No es posible borrar la caché de la CDN en el administrador de tiempo de ejecución. Sin embargo, cuando se vuelve a implementar un paquete, se borra todo el contenido almacenado en caché para el entorno asociado.
La invalidación de la caché de la CDN temporalmente resulta en un rendimiento más lento para los primeros compradores que acceden al sitio después de la invalidación.
Note
Consulte Variables de entorno.
Los encabezados de control de acceso le permiten restringir el acceso a un entorno para que solo se permita el tráfico de confianza procedente de la red de entrega de contenido (CDN) o del equipo de desarrollo. Restringir el acceso es importante para garantizar que los bots no eludan la configuración de seguridad del perímetro de su CDN y para garantizar que los rastreadores de búsqueda no indexen contenido del dominio o entorno incorrectos.
Si también se establecen las direcciones IP permitidas, se permite el paso de solicitudes con una dirección IP válida o un encabezado de control de acceso.
Establezca los encabezados de control de acceso mediante la Configuración avanzada del entorno o la API projects_target_access_control_header_create.
Las solicitudes entrantes solo se permiten si hay un x-sfdc-access-control encabezado de solicitud presente con un valor válido.
Un valor de encabezado se compone del conjunto de caracteres elegido. Cada valor de encabezado:
Usted es responsable de garantizar que el valor del encabezado de control de acceso se almacene de forma segura y se comparta solo con personas de confianza. Recomendamos encarecidamente rotar el cabezal de control de acceso de forma regular.
Para rotar un encabezado de control de acceso:
1curl https://myproject-mytarget.mobify-storefront.com/ -H "x-sfdc-access-control: 123456789" -o /dev/nullx-sfdc-access-control solicitud con el valor actualizado.Consulte también
Un redireccionamiento le permite reenviar una solicitud desde la URL solicitada a una URL diferente. Los redireccionamientos pueden ayudar a evitar alteraciones en la experiencia del usuario causadas por cambios aplicados al escaparate. Por ejemplo, imagine una página de campaña estacional para la primavera. Una vez que la campaña de primavera termina y esta se sustituye por una de verano, usted puede redirigir desde la URL de primavera a la de verano.
Los redireccionamientos son una característica poderosa que pueden tener consecuencias significativas para la seguridad de su escaparate, incluido el redireccionamiento a URL o activos maliciosos. Tenga cuidado al asignar roles a sus usuarios que les brinden acceso a Redireccionamiento.
Antes de crear un redireccionamiento en un entorno de producción, se recomienda crearlo primero en un entorno de staging.
Tip
También puede crear uno o más redireccionamientos mediante el punto de conexión de la projects_target_redirect_create API.
Para crear un redireccionamiento usando Runtime Admin:
www.example.com/winter, escriba /winter.Veamos las opciones para crear un redireccionamiento con mayor detalle.
El valor que se introduce en el campo Redirect From debe ser siempre una ruta relative. El campo Redirect To puede ser una ruta relativa o una URL completa. Por ejemplo, supongamos que queremos redirigir a los visitantes de www.example.com/spring a www.example.com/summer. El campo Redirect From debe ser /spring. El campo Redirect To puede ser /summer o www.example.com/summer.
Puede añadir un asterisco (*) al final de la URL de Redirect From a modo de comodín. Los comodines reemplazan cualquier carácter (0 o más) en la URL. Por ejemplo, un “redirigir desde” /a/* reemplazaría /a/, /a/b y /a/b/c.
Los caracteres comodín solo pueden usarse al final de la URL de Redirect From.
Managed Runtime procesa primero los redireccionamientos estándar y, luego, los redireccionamientos con comodines.
La mayoría de los redireccionamientos utilizan el código de estado permanente (301), pero también se puede seleccionar el temporal (302). Si no está seguro de qué código de estado HTTP debe utilizar, consulte esta explicación de código de estado de MOZ.com.
Algunas solicitudes contienen parámetros de cadenas de consulta que también debería incluir en la solicitud redirigida. Por ejemplo, a la ruta relativa /spring-landing-page se le puede adjuntar una cadena de consulta para el seguimiento analítico, como /spring-landing-page?gclid=123.
Para habilitar el reenvío de parámetros de consulta, vaya a la sección Forward (Reenviar) del formulario y seleccione Query Parameters (Parámetros de consulta). De lo contrario, los parámetros de la cadena de consulta de la URL de origen no se incluyen en la URL de redireccionamiento.
¿Qué ocurre cuando las URL de Redirect From y Redirect To tienen ambas cadenas de consulta y el reenvío está habilitado? En este caso, la URL de redireccionamiento incluye una combinación de ambas cadenas de consulta. Los parámetros de consulta de la URL de Redirect To se adjuntan a la cadena de consulta de la solicitud. Por ejemplo, suponga que su aplicación recibe una solicitud de la ruta relativa /spring?year=2019. Si eligió redirigir /spring a /summer?year=2020, la URL de redireccionamiento es /summer?year=2019&year=2020 cuando el reenvío está habilitado.
Puede incluir automáticamente cualquier ruta que aparezca después de la parte que actúa como comodín en la URL de Redirect From en la URL de Redirect To. Por ejemplo, si /a/* reemplaza a /a/b/c en la URL de Redirect From y la URL de Redirect To es /z/, la URL de redireccionamiento es /z/b/c.
Para habilitar el reenvío de rutas comodines, vaya a la sección Forward (Reenviar) del formulario y seleccione Wildcard Path (Ruta comodín).
Recomendamos crear siempre los redireccionamientos en un entorno de staging y clonarlos para su producción después de probarlos.
Tip
Puede copiar todos los redireccionamientos de un entorno a otro utilizando la característica de clonación de redireccionamientos.
También puede clonar redireccionamientos mediante el punto de conexión de la projects_target_redirect_clone_create API.
Para clonar redireccionamientos usando Runtime Admin:
Al clonar redireccionamientos, estará sustituyendo todos los redireccionamientos del entorno de destino por todos los redireccionamientos del entorno de origen.
Warning
También puede editar un redireccionamiento mediante el punto de conexión de la projects_target_redirect_partial_update API.
Para editar la configuración de un redireccionamiento existente mediante el administrador de tiempo de ejecución:
También puede eliminar un redireccionamiento mediante el punto de conexión de la projects_target_redirect_destroy API.
Para eliminar un redireccionamiento usando Runtime Admin:
Si algún redireccionamiento no tiene el resultado esperado, pruebe estos pasos para solucionar problemas:
Los redireccionamientos tienen las siguientes limitaciones técnicas:
ssr.js./mobify/redirect/$pathde conexión administrado.Esta es la forma de administrar sus usuarios.
Para agregar a un usuario a un proyecto, haga lo siguiente:
Para cambiar el rol de un usuario, haga lo siguiente:
Para ver una lista de capacidades de usuario asociadas con cada rol, consulte la Visión general de Managed Runtime.
Para quitar a un usuario de un proyecto, haga lo siguiente:
j