Clonar repositorios Git de datos de muestra
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
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 ser2.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 ser2.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.
<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
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