Documentación de la plataforma

Empezando

Configure su cuenta, monte la aplicación Magento y siga un cambio desde la prueba Beta a través de un implementación segura de Production.

Preparación de cuenta

Antes de su primera implementación

Antes de ejecutar su primera implementación, debe completar algunos pasos de configuración iniciales.

El primer grupo de tareas está relacionado con la seguridad de su cuenta. Abra la página de Configuración haciendo clic el ícono de ajustes en la esquina superior derecha de la pantalla y complete los siguientes pasos:

Verifica tu número de teléfono
Verifica tu dirección de correo electrónico
Configurar la autenticación de dos factores (2FA)

El siguiente paso es opcional y solo es necesario si planea implementar paquetes privados Composer o Git. Si lo haces, debe agregar las claves requeridas en la página de Configuración. Una vez que los guarda, los almacenamos en un lugar seguro. bóveda. Por razones de seguridad no podrás volver a ver las claves, pero permanecerán almacenadas de forma segura y disponible para la plataforma solo en una red privada.

A continuación, elija a plan de suscripción que se adapte a sus necesidades en la página de Configuración.

Después de completar estos pasos, nuestro equipo aprovisionará sus cuentas dedicadas AWS, lo que generalmente toma 3 a 5 días hábiles. Una vez que se complete este proceso, verá aparecer el elemento de menú "Pipeline" en UI.

En ese punto, estará listo para implementar su primera aplicación Magento. Abre tu Pipeline página, agregue los paquetes que desea implementar y haga clic en "Deploy".

Suscripciones

Para comenzar a utilizar nuestra plataforma, debes suscribirte a uno de nuestros planes. Puedes elegir entre tres planes:

Basic

Un punto de partida práctico para equipos pequeños y startups.

Premium

Límites de recursos más altos con un mayor nivel de soporte de nuestro equipo.

Enterprise

Configuración personalizada, funciones adicionales y soporte las 24 horas, los 7 días de la semana para organizaciones más grandes.

Para suscribirse, simplemente haga clic en el botón "Subscribe" en la página de Configuración.

Pipeline

La página Pipeline es la vista principal de nuestra plataforma. Muestra todas las implementaciones y sus estados, historial de pruebas, registros y enlaces directos a paneles de control CloudWatch con métricas. Puede retroceder a una versión anterior en caso de que de cualquier problema. También puede habilitar la promoción automatizada entre etapas para lograr CI/CD completo, o deshabilitarla y gestionar promociones manualmente. Cada cambio de implementación tiene su propia identificación única y usamos diferentes colores para hacer Es fácil identificar los últimos cambios y ver en qué etapa se encuentran actualmente.

Cada tarjeta de implementación muestra su ID de cambio y ID de compilación, el estado actual, el resultado de compatibilidad con versiones anteriores y el inicio. y tiempos de finalización, mensajes y los repositorios incluidos en esa compilación. Expanda los paneles Magento y Pruebas para acciones específicas del entorno o seleccione Ver en Registros para inspeccionar el resultado de esa etapa.

Paquetes

Nuestro proceso comienza agregando paquetes. Puede agregar paquetes desde los repositorios Composer o Git, con un principal paquete que normalmente es el propio Magento 2 CE. Puedes agregar tantos paquetes como necesites. Si estas usando paquetes privados, debe proporcionar las credenciales necesarias en la página de Configuración.

Utilice el botón de edición al lado de un repositorio para cambiar su fuente Git o Composer, seleccione una versión opcional o designarlo como el paquete principal. Un repositorio también se puede marcar como tema. Los tipos de temas admitidos incluyen Less, Sass y PWA, lo que permite que el proceso de implementación maneje cada paquete de interfaz de manera adecuada.

Beta

Una vez que sus cambios alcancen la etapa Beta, puede configurar pruebas automatizadas para su aplicación. Puedes habilitar API, UI y pruebas de rendimiento, y puede activar o desactivar cada una de ellas en cualquier momento.

La tarjeta de implementación Beta también muestra el estado de implementación en vivo, la compatibilidad, el tiempo, los mensajes, los repositorios, Magento enlaces y acciones, y el número de pruebas configuradas. Utilice el botón de engranaje para configurar un prueba individual y el botón de reproducción para ejecutarla bajo demanda.

Cada tipo de prueba tiene sus propias opciones de configuración:

API & UI pruebas
- Conjunto de pruebas
- Filtro de prueba
- reposiciones máximas
Pruebas de rendimiento
- Perfil del aparato
- Proporción de aciertos de caché objetivo
- Número de usuarios de la interfaz
- Número de usuarios administradores
- Número de bucles para ejecutar todas las pruebas habilitadas
- reposiciones máximas

Cuando esté satisfecho con los resultados en Beta, puede promover sus cambios a Production o habilitar la función automática. promoción para que el proceso esté totalmente impulsado por CI/CD.

Promoción

La promoción mueve un cambio probado exitosamente de Beta a Production. Puedes promocionar un cambio manualmente cuando esté listo, o habilite la promoción automática para que el proceso continúe después de que pasen todas las pruebas requeridas. Antes de promocionar, revise el estado de implementación y los resultados de las pruebas para asegurarse de que está moviendo el objetivo previsto. cambiar.

Los controles entre etapas incluyen botones de retroceso y despliegue forzado. La reversión devuelve el tráfico al implementación anterior cuando esa acción esté disponible. El despliegue forzado permite que un despliegue continúe manualmente; Úselo con cuidado porque puede evitar la progresión automatizada normal de la tubería.

Production

La implementación de Production es el paso final del proceso de CI/CD. Se puede activar automáticamente después de Beta pasan las pruebas. Las implementaciones se realizan sin tiempo de inactividad y puede volver a la versión anterior en caso de cualquier problema. El despliegue se divide en dos fases:

Despliegue de servicios: RDS, OpenSearch, ElastiCache, MQ, SES. No necesitas preocuparte por este paso: se trata principalmente de actualizar la configuración del clúster, habilitar funciones adicionales y actualizar a versiones más nuevas y seguras de los servicios subyacentes.
ECS implementación del clúster: aquí es donde el código de la aplicación se reemplaza sin tiempo de inactividad para cambios compatibles con versiones anteriores. Durante este paso, Admin para Magento se coloca en modo de mantenimiento, mientras el escaparate permanece en pleno funcionamiento.

Mientras se implementa Production, la tarjeta muestra un estado de ejecución y la duración transcurrida. La parada y La acción de reversión de implementación está disponible para implementaciones en curso admitidas. Después de completar, verifique las versiones del repositorio implementadas, el estado de Magento, los enlaces del escaparate y los registros antes de considerar el lanzamiento completo.

Aplicación para Magento

El bloque Magento proporciona acceso rápido a enlaces, credenciales y acciones específicas de la aplicación para el ambiente seleccionado. Incluye el escaparate URL para Magento, PWA URL, Admin para URL para Magento y Admin. credenciales. También puede usar este bloque para aplicar un tema, generar archivos estáticos Magento y borrar el caché de la aplicación después de cambios de configuración o escaparate.

Las etiquetas de estado muestran si Magento, generación estática y operaciones de caché están activas o en curso. Seleccione un tema configurado y haga clic en Aplicar para activarlo. Utilice Regenerar después de cambios de tema o interfaz. y Borrar cuando Magento ofrece contenido almacenado en caché obsoleto. Algunas acciones permanecen no disponibles mientras que otras La implementación o la operación Magento se están ejecutando.

Cómo agregar un tema personalizado

Agregar el paquete hace que el tema esté disponible para la implementación, pero Magento también debe asignarlo al vista de tienda prevista antes de que la canalización la aplique al entorno.

1
Agregar el paquete temático
Agregue el repositorio Git o Composer en la página Pipeline, márquelo como tema y seleccione el tipo de tema apropiado.
2
Implementar el paquete
Implemente el cambio en la etapa en la que desea configurar y verificar el tema y luego espere a que la implementación finalice correctamente.
3
Abrir Admin para Magento
Expanda el bloque Magento para esa etapa y use Admin URL y las credenciales para iniciar sesión en Admin para Magento.
4
Asignar el tema a la vista de la tienda.
En Admin para Magento, abra Contenido > Diseño > Configuración, edite la vista de tienda requerida, seleccione el tema personalizado y guarde la configuración.
5
Aplicar el tema del pipeline.
Regrese a la página Pipeline, elija el tema en el bloque Magento y haga clic en Aplicar.
6
Esperar a que finalice
Mantenga la página abierta mientras se ejecuta la operación del tema. Cuando su estado se complete correctamente, abra el escaparate y verifique la vista de la tienda seleccionada.

Repita la asignación de administrador Magento para cada vista de tienda que deba usar el tema personalizado. Pruebe el resultado en Beta antes de promover el cambio a Production.

Proceso de cambio de URL para Magento

Utilice los controles URL para Magento cuando desee que el entorno responda en un dominio personalizado. Ingrese el nuevo URL, confirme el cambio y siga las instrucciones de dominio y certificado que se muestran. DNS y cambios de certificado Puede tardar un tiempo en estar disponible, así que espere a que se complete el proceso antes de probar la nueva dirección.

Guarde el nuevo URL para Magento personalizado sin incluir el protocolo.
Implemente o actualice el certificado ACM CloudFront creado para el dominio.
Agregue el registro CNAME de validación de ACM mostrado en su proveedor DNS, espere a que se resuelva y ejecute Verificar. validación. Utilice los valores exactos de host y destino que se muestran en el cuadro de diálogo.
Implemente la CDN y luego apunte el dominio al nombre de host CloudFront que se muestra. Utilice un registro ALIAS para una raíz dominio cuando sea compatible, o un registro CNAME para un subdominio.
Cambie la base URL para Magento después de que el certificado y los pasos de CDN informen que se realizaron correctamente.

No resuelva un nombre de host CloudFront en sus direcciones IP actuales y cree registros A o AAAA fijos a partir de esas valores, porque las direcciones CloudFront pueden cambiar. La propagación de DNS también puede diferir entre autoridad y resolutores públicos, para que la verificación de validación autorizada pueda tener éxito antes de que el registro aparezca en todas partes.

El siguiente ejemplo muestra el registro de enrutamiento CNAME de validación y CloudFront configurado en Namecheap. Otro Los proveedores de DNS usan etiquetas diferentes, pero los tipos de registros, nombres de host y valores de destino siguen el mismo proceso.

Registros

La sección Registros le ayuda a investigar compilaciones, implementaciones, pruebas y problemas de aplicaciones. Seleccione el relevante ejecución de canalización o entorno para ver su salida, luego use marcas de tiempo y mensajes de estado para identificar dónde ocurrió la falla. Es posible que haya enlaces a los registros CloudWatch relacionados para una solución de problemas más detallada.

Los registros incluyen marcas de tiempo e identificadores, como ID de implementación, que ayudan a correlacionar un evento con su canalización. tarjeta y despliegue AWS. Utilice Actualizar para cargar una salida más nueva mientras se ejecuta un trabajo y Copiar para capturar el registro para buscar, compartir o adjuntar a una solicitud de soporte. Al solucionar problemas, comience cerca del primer error explícito en lugar del mensaje final de falla de la tubería, que a menudo es solo un resumen de un problema anterior.