Documentación Commerce Guía de instalación

Clonar repositorios Git de datos de muestra

Última actualización: 18 de julio de 2024

Temas:

Creado para:

Experimentado
Administrador
Desarrollador

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:

Utiliza Magento Open Source
Usted clonó el repositorio de GitHub

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 el protocolo SSH
Clonar con el protocolo HTTPS

Clonar con SSH

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

En un explorador web, vaya a repositorio de datos de ejemplo.
Junto al nombre de la rama, haga clic en SSH en la lista.
Haga clic en Copiar al portapapeles

La siguiente figura muestra un ejemplo.
Cambie al directorio docroot del servidor web.

Normalmente, para Ubuntu, es /var/www y para CentOS es /var/www/html.
Escriba git clone y pegue el valor que obtuvo anteriormente.

A continuación se muestra un ejemplo:
git clone git@github.com:magento/magento2-sample-data.git
Espere a que el repositorio se clone en el servidor.

NOTE
Si se muestra el siguiente error, asegúrese de que compartió su clave SSH con GitHub:
Cloning into 'magento2'... Permission denied (publickey). fatal: The remote end hung up unexpectedly
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):
git checkout 2.4-develop
Cambiar a <app_root>.
Introduzca el siguiente comando para crear vínculos simbólicos entre los archivos clonados de modo que los datos de ejemplo funcionen correctamente:
php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"
Espere a que se complete el comando.
Consulte Establecer permisos y propiedad del sistema de archivos.
Ejecute el siguiente comando:
bin/magento setup:upgrade

Clonar con HTTPS

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

En un explorador web, vaya a repositorio de datos de ejemplo.
En el lado derecho de la página, en el campo clonar URL, haga clic en HTTPS.
Haga clic en Copiar al portapapeles.

La siguiente figura muestra un ejemplo.
Cambie al directorio docroot del servidor web.

Normalmente, para Ubuntu, es /var/www y para CentOS es /var/www/html.
Escriba git clone y pegue el valor que obtuvo anteriormente.

A continuación se muestra un ejemplo:
git clone https://github.com/magento/magento2-sample-data.git
Espere a que el repositorio se clone en el servidor.
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):
git checkout 2.4-develop
Cambiar a <magento_root>.

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

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

Por ejemplo,

php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="/var/www/magento2"

Espere a que se complete el comando.
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:

<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:

Cambie al directorio de clonación de datos de ejemplo.
Establecer propiedad:
chown -R :<your web server group name> .
Ejemplos habituales:
- CentOS: chown -R :apache .
- Ubuntu: chown -R :www-data .
Definir permisos:
find . -type d -exec chmod g+ws {} +

Borrar archivos estáticos:

cd <your Magento Open Source install dir>

rm -rf var/cache/* var/page_cache/* generated/*

Completar la instalación de datos de ejemplo

Solo PaaS

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