DocumentationCommerceGuide d’installation

Clonage des exemples de référentiels Git de données

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Cette rubrique explique comment cloner et ajouter des données d’exemple si vous avez cloné le référentiel GitHub Magento Open Source. Cette méthode est destinée uniquement aux développeurs qui contribuent (c’est-à-dire aux développeurs qui prévoient de contribuer au code base du Magento Open Source).

Si vous n’êtes pas un développeur contributeur, sélectionnez l’une des autres options affichées dans la table des matières du côté gauche de la page.

Les développeurs contributeurs peuvent utiliser cette méthode pour installer des exemples de données uniquement si ce qui suit est vrai :

WARNING
Vous pouvez utiliser des exemples de données avec la branche develop (plus actuelle) ou une branche publiée (comme 2.4 (plus stable)). Nous vous recommandons d’utiliser une branche publiée, car elle est plus stable. Si vous contribuez du code au référentiel et que vous avez besoin du code le plus récent, utilisez la branche develop. Quelle que soit la branche choisie, vous devez cloner la branche correspondante du référentiel GitHub du Magento Open Source. Par exemple, des exemples de données pour la branche develop peuvent être utilisés uniquement avec la branche develop du Magento Open Source.

Clonage du référentiel de données d’exemple

Cette section explique comment installer des exemples de données en clonant le référentiel de données d’exemple. Vous pouvez cloner le référentiel de données d’exemple de l’une des manières suivantes :

Clonage avec SSH

Pour cloner le référentiel GitHub de données d’exemple à l’aide du protocole SSH :

  1. Dans un navigateur web, accédez au référentiel de données d’exemple.

  2. En regard du nom de la branche, cliquez sur SSH dans la liste.

  3. Cliquez sur Copier vers le presse-papiers

    La figure suivante illustre un exemple.

    Cloner le référentiel GitHub à l’aide de SSH

  4. Modifiez le répertoire docroot de votre serveur web.

    En règle générale, Ubuntu est /var/www et CentOS /var/www/html.

  5. Saisissez git clone et collez la valeur obtenue précédemment.

    Voici un exemple :

    code language-bash 
    git clone git@github.com:magento/magento2-sample-data.git

  6. Attendez que le référentiel soit cloné sur votre serveur.

    note note
    NOTE
    Si l’erreur suivante s’affiche, assurez-vous que vous avez partagé votre clé SSH avec GitHub:
    code language-none 
    Cloning into 'magento2'...
Permission denied (publickey).
fatal: The remote end hung up unexpectedly

  7. Assurez-vous d’extraire la branche de l’exemple de référentiel de données correspondant à la branche que vous avez utilisée à partir du référentiel principal magento2.

    Par exemple :

    Si vous avez utilisé la branche 2.4-develop du référentiel GitHub du Magento Open Source, la branche Sample Data doit être 2.4-develop.

    Pour extraire la branche correcte, exécutez la commande suivante à partir du répertoire racine du référentiel de données d’exemple (en supposant que vous ayez besoin de la branche 2.4-develop) :

    code language-bash 
    git checkout 2.4-develop

  8. Remplacez par <app_root>.

  9. Saisissez la commande suivante pour créer des liens symboliques entre les fichiers que vous avez clonés afin que les exemples de données fonctionnent correctement :

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

  10. Attendez que la commande soit terminée.

  11. Voir Définition des droits d’accès et de la propriété du système de fichiers.

  12. Exécutez la commande suivante :

    code language-bash 
    bin/magento setup:upgrade

Cloner avec HTTPS

Pour cloner le référentiel GitHub de données d’exemple à l’aide du protocole HTTPS :

  1. Dans un navigateur web, accédez au référentiel de données d’exemple.

  2. Sur le côté droit de la page, sous le champ clone URL, cliquez sur HTTPS.

  3. Cliquez sur Copier dans le Presse-papiers.

    La figure suivante illustre un exemple.

    Cloner le référentiel GitHub à l’aide de HTTPS

  4. Modifiez le répertoire docroot de votre serveur web.

    En règle générale, Ubuntu est /var/www et CentOS /var/www/html.

  5. Saisissez git clone et collez la valeur obtenue précédemment.

    Voici un exemple :

    code language-bash 
    git clone https://github.com/magento/magento2-sample-data.git

  6. Attendez que le référentiel soit cloné sur votre serveur.

  7. Assurez-vous d’extraire la branche de l’exemple de référentiel de données correspondant à la branche que vous avez utilisée à partir du référentiel principal magento2.

    Par exemple :

    Si vous avez utilisé la branche 2.4-develop du référentiel GitHub du Magento Open Source, la branche Sample Data doit être 2.4-develop.

    Pour extraire la branche correcte, exécutez la commande suivante à partir du répertoire racine du référentiel de données d’exemple (en supposant que vous ayez besoin de la branche 2.4-develop) :

    code language-bash 
    git checkout 2.4-develop

  8. Remplacez par <magento_root>.

  9. Saisissez la commande suivante pour créer des liens symboliques entre les fichiers que vous avez clonés afin que les exemples de données fonctionnent correctement :

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

    Par exemple,

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

  10. Attendez que la commande soit terminée.

  11. Voir la section suivante.

WARNING
Si vous installez des exemples de données après l'installation d'Adobe Commerce, vous devez également exécuter la commande suivante pour mettre à jour la base de données et le schéma :
code language-bash 
<magento_root>/bin/magento setup:upgrade

Définition de la propriété et des autorisations du système de fichiers

Comme le script php build-sample-data.php crée des liens symboliques entre le référentiel de données d’exemple et votre référentiel de Magento Open Source, vous devez définir les autorisations et la propriété du système de fichiers dans le référentiel de données d’exemple. Sinon, des erreurs d’accès au storefront seront générées.

Pour définir les autorisations et la propriété du système de fichiers sur l’exemple de référentiel de données :

  1. Modifiez votre répertoire de clone de données d’exemple.

  2. Définir la propriété :

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

    Exemples types :

    • CentOS : chown -R :apache .

    • Ubuntu : chown -R :www-data .

  3. Définissez les autorisations :

    code language-bash 
    find . -type d -exec chmod g+ws {} +

  4. Effacer les fichiers statiques :

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

Effectuez l’installation des exemples de données

Après avoir téléchargé les exemples de packages de données, connectez-vous à votre serveur d’applications en tant que propriétaire du système de fichiers ou passez à , puis saisissez la commande suivante dans le répertoire <app_root> :

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