DocumentaciónCommerceGuía de Commerce en la infraestructura en la nube

Implementar en ensayo y producción

Last update: Tue Jul 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Administrador
  • Desarrollador

El proceso de implementación y lanzamiento comienza con el desarrollo, continúa con el ensayo y termina con el lanzamiento en producción. Adobe proporciona una solución de entorno integral para garantizar configuraciones coherentes. Todos los entornos admiten el acceso directo por URL a la tienda y el acceso Admin y SSH para los comandos CLI.

Cuando esté listo para implementar su tienda, debe completar la implementación y las pruebas en el entorno de ensayo antes de implementarlo en producción. Esta sección proporciona instrucciones e información detalladas sobre el proceso de generación e implementación, la migración de datos y contenido, y las pruebas.

TIP
El Adobe recomienda crear una copia de seguridad del entorno antes de las implementaciones.

Además, puede habilitar Rastrear implementaciones con New Relic para supervisar eventos de implementación y ayudarle a analizar el rendimiento entre implementaciones.

Flujo de implementación de inicio

El Adobe recomienda crear una rama staging desde la rama master para admitir mejor el desarrollo y la implementación del plan de inicio. A continuación, tiene listos dos de los cuatro entornos activos: master para producción y staging para ensayo.

Para obtener información detallada del proceso, consulte Iniciar desarrollo e implementación del flujo de trabajo.

Flujo de implementación de Pro

Pro incluye un entorno de integración de gran tamaño con dos ramas activas, una rama master global, las ramas Ensayo y Producción. Al crear el proyecto, el código está listo para ramificarse, desarrollarse e insertarse para crear e implementar el sitio. Aunque el entorno de integración puede tener muchas ramas, Ensayo y Producción solo tienen una rama para cada entorno.

Para obtener información detallada del proceso, consulte Desarrollo e implementación de flujo de trabajo de Pro.

Implementar código en ensayo

El entorno de ensayo proporciona un entorno casi de producción que incluye una base de datos, un servidor web y todos los servicios, incluidos Fastly y New Relic. Puede insertar, combinar e implementar completamente a través de Cloud Console o comandos de CLI de nube a través de una aplicación de terminal.

Implementar código con Cloud Console

Cloud Console proporciona características para crear, administrar e implementar código en los entornos de integración, ensayo y producción para los planes Starter y Pro.

En proyectos Pro, implemente la rama de integración en ensayo:

  1. Inicia sesión en tu proyecto.

  2. Seleccione la rama integration.

  3. Seleccione la opción Merge para implementarla en Ensayo.

    Combinar {width="150"}

  4. Complete todas las pruebas en el entorno de ensayo.

  5. Cuando el ensayo esté listo, seleccione la opción Merge para implementarla en el entorno de producción.

Para empezar, implemente la rama de desarrollo en el ensayo:

  1. Inicia sesión en tu proyecto.

  2. Seleccione la rama de código preparada.

  3. Seleccione la opción Merge para implementarla en Ensayo.

    Combinar {width="150"}

  4. Complete todas las pruebas en el entorno de ensayo.

  5. Cuando el ensayo esté listo, seleccione la opción Merge para implementarla en el entorno de producción (master).

Implementar código con la línea de comandos

La CLI de la nube proporciona comandos para implementar código. Necesita SSH y acceso Git a su proyecto.

Paso 1: Implementación y prueba del entorno de integración

  1. Después de iniciar sesión en el proyecto, compruebe el entorno de integración:

    code language-bash 
    magento-cloud environment:checkout <environment-ID>

  2. Sincronice el entorno de integración local con el entorno remoto:

    code language-bash 
    magento-cloud environment:synchronize <environment-ID>

  3. Cree una instantánea del entorno como copia de seguridad:

    code language-bash 
    magento-cloud snapshot: create -e <environment-ID>

  4. Actualice el código en la rama local según sea necesario.

  5. Agregar, confirmar e insertar cambios en el entorno.

    code language-bash 
    git add -A && git commit -m "Commit message" && git push origin <environment-ID>

  6. Prueba completa del sitio.

Paso 2: Combinar cambios en Ensayo e implementación

  1. Consulte el entorno de ensayo:

    code language-bash 
    magento-cloud environment:checkout <environment-ID>

  2. Sincronice el entorno de ensayo local con el entorno remoto:

    code language-bash 
    magento-cloud environment:synchronize <environment-ID>

  3. Cree una instantánea del entorno como copia de seguridad:

    code language-bash 
    magento-cloud snapshot: create -e <environment-ID>

  4. Combine el entorno de integración en Ensayo para implementar:

    code language-bash 
    magento-cloud environment:merge <integration-ID>

  5. Prueba completa del sitio.

Paso 3: Implementación en producción

  1. Consulte, sincronice y cree una instantánea de su entorno de producción local.

  2. Combine el entorno de ensayo con el de producción para implementar:

    code language-bash 
    magento-cloud environment:merge <staging-ID>

  3. Prueba completa del sitio.

Migrar archivos estáticos

Los archivos estáticos se almacenan en mounts. Existen dos métodos para migrar archivos desde una ubicación de montaje de origen, como el entorno local, a una ubicación de montaje de destino. Ambos métodos utilizan la utilidad rsync, pero el Adobe recomienda utilizar la CLI magento-cloud para mover archivos entre el entorno local y el remoto. Y el Adobe recomienda usar el método rsync al mover archivos desde un origen remoto a una ubicación remota diferente.

Migración de archivos mediante la CLI

Puede utilizar los comandos CLI mount:upload y mount:download para migrar archivos entre el entorno local y el remoto. Ambos comandos utilizan la utilidad rsync, pero los comandos de CLI proporcionan opciones y mensajes adaptados al entorno de Adobe Commerce en la nube. Por ejemplo, si utiliza el comando simple sin opciones, la CLI le pide que seleccione el montaje o los montajes que desea cargar o descargar.

magento-cloud mount:download

Respuesta de ejemplo:

Enter a number to choose a mount to download from:
  [0] app/etc
  [1] pub/static
  [2] var
  [3] pub/media
  [4] All mounts
 > 3

Target directory: ~/pub/media/

Downloading files from the remote mount pub/media to pub/media

Are you sure you want to continue? [Y/n] Y

Para cargar archivos de una carpeta pub/media/ local a la carpeta pub/media/ remota para el entorno actual:

magento-cloud mount:upload --source /path/to/project/pub/media/ --mount pub/media/

Respuesta de ejemplo:

Uploading files from pub/media to the remote mount pub/media

Are you sure you want to continue? [Y/n] Y

  building file list ...   done
  ./
  sample-file.jpeg

  sent 8.43K bytes  received 48 bytes  3.39K bytes/sec
  total size is 154.57K  speedup is 18.23

Utilice la opción --help para los comandos mount:upload y mount:download para ver más opciones. Por ejemplo, existe la opción --delete de quitar los archivos superfluos durante la migración.

Migrar archivos mediante rsync

También puede usar la utilidad rsync para migrar archivos.

rsync -azvP <source> <destination>

Este comando utiliza las siguientes opciones:

  • a-archivo
  • z: comprimir archivos durante la migración
  • v: detallado
  • P: progreso parcial

Ver la ayuda de rsync.

NOTE
Para transferir medios directamente de entornos remotos a remotos, debe habilitar el reenvío de agentes SSH; consulte las directrices de GitHub.

Para migrar archivos estáticos de entornos remotos a remotos directamente (enfoque rápido):

  1. Utilice SSH para iniciar sesión en el entorno de origen. No utilice la CLI magento-cloud. El uso de la opción -A es importante porque habilita el reenvío de la conexión del agente de autenticación.

    note tip
    TIP
    Para encontrar el vínculo SSH access en tu Cloud Console, selecciona el entorno y haz clic en Acceder al sitio.
    code language-bash 
    ssh -A <environment_ssh_link@ssh.region.magento.cloud>

  2. Utilice el comando rsync para copiar el directorio pub/media de su entorno de origen en un entorno remoto diferente.

    code language-bash 
    rsync -azvP pub/media/ <destination_environment_ssh_link@ssh.region.magento.cloud>:pub/media/

  3. Inicie sesión en el otro entorno remoto para comprobar que los archivos se migraron correctamente.

Migración de la base de datos

WARNING
Las operaciones de importación y exportación de bases de datos pueden tardar mucho tiempo, lo que puede afectar al rendimiento y la disponibilidad del sitio. Programe operaciones de importación y exportación durante las horas de menor actividad para evitar interrupciones o bajo rendimiento en los sitios de producción.
recommendation-more-help

Requisito previo: Un volcado de base de datos (consulte el Paso 3) debe incluir déclencheur de base de datos. Para descargarlos, confirme que tiene el privilegio DÉCLENCHEUR.

IMPORTANT
La base de datos del entorno de integración se utiliza estrictamente para pruebas de desarrollo y puede incluir datos que no desea migrar a Ensayo y Producción.

Para implementaciones de integración continua, el Adobe no recomienda migrar datos de integración a ensayo y producción. Puede pasar datos de prueba o sobrescribir datos importantes. Las configuraciones esenciales se pasan mediante el comando archivo de configuración y setup:upgrade durante la generación e implementación.

style
shade-box

El Adobe recomienda migrar los datos de producción a ensayo para probar por completo el sitio y almacenarlos en un entorno casi de producción con todos los servicios y la configuración.

NOTE
Para transferir medios directamente de entornos remotos a remotos, debe habilitar el reenvío de agentes ssh. Consulte las directrices de GitHub.

Realizar copia de seguridad de la base de datos

Se recomienda crear una copia de seguridad de la base de datos. El siguiente procedimiento usa las instrucciones de Hacer una copia de seguridad de la base de datos.

Para volcar la base de datos:

  1. Use SSH para iniciar sesión en el entorno remoto que contiene la base de datos que se va a copiar.

  2. Enumere las relaciones de entorno y anote la información de inicio de sesión de la base de datos.

    code language-bash 
    php -r 'print_r(json_decode(base64_decode($_ENV["MAGENTO_CLOUD_RELATIONSHIPS"]))->database);'

    Para Ensayo y Producción Pro, el nombre de la base de datos se encuentra en la variable MAGENTO_CLOUD_RELATIONSHIPS (normalmente es el mismo que el nombre de la aplicación y el nombre de usuario).

  3. Cree una copia de seguridad de la base de datos. Para elegir un directorio de destino para el volcado de la base de datos, utilice la opción --dump-directory.

    Para entornos Starter y entornos de integración Pro, use main como nombre de la base de datos:

    code language-bash 
    php vendor/bin/ece-tools db-dump main

    Opciones de volcado:

    • --dump-directory=<dir>: elija un directorio de destino para el volcado de la base de datos
    • --remove-definers: quita las instrucciones DEFINER del volcado de la base de datos

  4. Aunque se prefiere el método ECE-Tools, otro método es crear un archivo de volcado de base de datos utilizando MySQL nativo en formato GZIP.

    code language-bash 
    mysqldump -h <database-host> --user=<database-username> --password=<password> --single-transaction --triggers <database-name> | gzip - > /tmp/database.sql.gz

    Si ha configurado la autenticación de doble factor en el entorno de destino, es mejor excluir las tablas 2FA relacionadas para evitar volver a configurarla después de la migración de la base de datos:

    code language-bash 
    mysqldump -h <database-host> --user=<database-username> --password=<password> --single-transaction --triggers --ignore-table=<database-name>.tfa_user_config --ignore-table=<database-name>.tfa_country_codes <database-name> | gzip - > /tmp/database.sql.gz

  5. Escriba logout para finalizar la conexión SSH.

Soltar y volver a crear la base de datos

Al importar datos, debe soltar y crear una base de datos.

Para soltar y volver a crear la base de datos:

  1. Establezca un túnel SSH al entorno remoto.

  2. Conéctese al servicio de base de datos.

    code language-bash 
    mysql --host=127.0.0.1 --user='<database-username>' --pass='<user-password>' --database='<name>' --port='<port>'

  3. En el símbolo del sistema MariaDB [main]>, suelte la base de datos.

    Para la integración de Starter y Pro:

    code language-shell 
    drop database main;

    Para la producción:

    code language-shell 
    drop database <cluster-id>;

    Para Ensayo:

    code language-shell 
    drop database <cluster-ID_stg>;

  4. Vuelva a crear la base de datos.

    Para la integración de Starter y Pro:

    code language-shell 
    create database main;

  5. Importe la base de datos.

    Importar para producción:

    code language-shell 
    zcat <cluster-ID>.sql.gz | sed -e 's/DEFINER[ ]*=[ ]*[^*]*\*/\*/' | mysql -h 127.0.0.1 -p -u <database-username> <database-name>;

    Importar para ensayo:

    code language-shell 
    zcat <cluster-ID_stg>.sql.gz | sed -e 's/DEFINER[ ]*=[ ]*[^*]*\*/\*/' | mysql -h 127.0.0.1 -p -u <database-username> <database-name>;

    Estos comandos descomprimen el archivo de volcado de la base de datos, quitan las instrucciones DEFINER e importan la base de datos con las credenciales especificadas.

05f2f56e-ac5d-4931-8cdb-764e60e16f26