Clonar repositorios Git de datos de muestra

En este tema se explica cómo clonar y agregar datos de ejemplo si ha clonado el repositorio de GitHub de Magento Open Source. Este método está diseñado únicamente para desarrolladores colaboradores (es decir, desarrolladores que planean contribuir al código base de Magento Open Source).

Si no es un desarrollador colaborador, elija una de las otras opciones que se muestran en la tabla de contenido de la izquierda de la página.

Los desarrolladores colaboradores pueden utilizar este método para instalar datos de ejemplo solamente si se cumple lo siguiente:

WARNING
Puede utilizar datos de ejemplo con la rama develop (más actual) o con una rama liberada (como 2.4 (más estable)). Le recomendamos que utilice una rama liberada porque es más estable. Si está contribuyendo código al repositorio y necesita el código más reciente, utilice la rama develop. Independientemente de la rama que elija, debe clonar la rama correspondiente del repositorio de GitHub del Magento Open Source. Por ejemplo, los datos de ejemplo de la rama develop se pueden usar solamente con la rama del Magento Open Source develop.

Clonar el repositorio de datos de ejemplo

En esta sección se explica cómo instalar datos de ejemplo mediante la clonación del repositorio de datos de ejemplo. Puede clonar el repositorio de datos de ejemplo de cualquiera de las siguientes maneras:

Clonar con SSH

Para clonar el repositorio de GitHub de datos de ejemplo utilizando el protocolo SSH:

  1. En un explorador web, vaya a repositorio de datos de ejemplo.

  2. Junto al nombre de la rama, haga clic en SSH en la lista.

  3. Haga clic en Copiar al portapapeles

    La siguiente figura muestra un ejemplo.

    Clonar el repositorio de GitHub mediante SSH

  4. Cambie al directorio docroot del servidor web.

    Normalmente, para Ubuntu, es /var/www y para CentOS es /var/www/html.

  5. Escriba git clone y pegue el valor que obtuvo anteriormente.

    A continuación se muestra un ejemplo:

    code language-bash
    git clone git@github.com:magento/magento2-sample-data.git
    
  6. Espere a que el repositorio se clone en el servidor.

    note note
    NOTE
    Si se muestra el siguiente error, asegúrese de que compartió su clave SSH con GitHub:
    code language-none
    Cloning into 'magento2'...
    Permission denied (publickey).
    fatal: The remote end hung up unexpectedly
    
  7. Asegúrese de desproteger la rama del repositorio de datos de ejemplo que corresponda a la rama utilizada del repositorio principal magento2.

    Por ejemplo:

    Si ha utilizado la rama 2.4-develop del repositorio de GitHub del Magento Open Source, la rama de datos de ejemplo debe ser 2.4-develop.

    Para extraer la rama correcta, ejecute el siguiente comando desde el directorio raíz del repositorio de datos de ejemplo (suponiendo que necesite la rama 2.4-develop):

    code language-bash
    git checkout 2.4-develop
    
  8. Cambiar a <app_root>.

  9. Introduzca el siguiente comando para crear vínculos simbólicos entre los archivos clonados de modo que los datos de ejemplo funcionen correctamente:

    code language-bash
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"
    
  10. Espere a que se complete el comando.

  11. Consulte Establecer permisos y propiedad del sistema de archivos.

  12. Ejecute el siguiente comando:

    code language-bash
    bin/magento setup:upgrade
    

Clonar con HTTPS

Para clonar el repositorio de GitHub de datos de ejemplo utilizando el protocolo HTTPS:

  1. En un explorador web, vaya a repositorio de datos de ejemplo.

  2. En el lado derecho de la página, en el campo clonar URL, haga clic en HTTPS.

  3. Haga clic en Copiar al portapapeles.

    La siguiente figura muestra un ejemplo.

    Clonar el repositorio de GitHub mediante HTTPS

  4. Cambie al directorio docroot del servidor web.

    Normalmente, para Ubuntu, es /var/www y para CentOS es /var/www/html.

  5. Escriba git clone y pegue el valor que obtuvo anteriormente.

    A continuación se muestra un ejemplo:

    code language-bash
    git clone https://github.com/magento/magento2-sample-data.git
    
  6. Espere a que el repositorio se clone en el servidor.

  7. Asegúrese de desproteger la rama del repositorio de datos de ejemplo que corresponda a la rama utilizada del repositorio principal magento2.

    Por ejemplo:

    Si ha utilizado la rama 2.4-develop del repositorio de GitHub del Magento Open Source, la rama de datos de ejemplo debe ser 2.4-develop.

    Para extraer la rama correcta, ejecute el siguiente comando desde el directorio raíz del repositorio de datos de ejemplo (suponiendo que necesite la rama 2.4-develop):

    code language-bash
    git checkout 2.4-develop
    
  8. Cambiar a <magento_root>.

  9. Introduzca el siguiente comando para crear vínculos simbólicos entre los archivos clonados de modo que los datos de ejemplo funcionen correctamente:

    code language-bash
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"
    

    Por ejemplo,

    code language-bash
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="/var/www/magento2"
    
  10. Espere a que se complete el comando.

  11. Consulte la siguiente sección.

WARNING
Si va a instalar los datos de ejemplo después de de instalar Adobe Commerce, también debe ejecutar el siguiente comando para actualizar la base de datos y el esquema:
code language-bash
<magento_root>/bin/magento setup:upgrade

Establecer propiedad y permisos del sistema de archivos

Dado que el script php build-sample-data.php crea enlaces simbólicos entre el repositorio de datos de ejemplo y el repositorio de Magento Open Source, debe establecer los permisos y la propiedad del sistema de archivos en el repositorio de datos de ejemplo. Si no se hace esto, se producen errores al acceder a la tienda.

Para establecer los permisos y la propiedad del sistema de archivos en el repositorio de datos de ejemplo:

  1. Cambie al directorio de clonación de datos de ejemplo.

  2. Establecer propiedad:

    code language-bash
    chown -R :<your web server group name> .
    

    Ejemplos habituales:

    • CentOS: chown -R :apache .

    • Ubuntu: chown -R :www-data .

  3. Definir permisos:

    code language-bash
    find . -type d -exec chmod g+ws {} +
    
  4. Borrar archivos estáticos:

    code language-bash
    cd <your Magento Open Source install dir>
    
    code language-bash
    rm -rf var/cache/* var/page_cache/* generated/*
    

Completar la instalación de datos de ejemplo

Después de descargar los paquetes de datos de ejemplo, inicie sesión en el servidor de aplicaciones como propietario del sistema de archivos o cambie a e introduzca el siguiente comando en el directorio <app_root>:

bin/magento setup:upgrade
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995