文档Commerce安装指南

克隆示例数据Git存储库

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

创建对象：

  • 有经验的
  • 管理员
  • 开发人员

本主题讨论如何在克隆Magento Open SourceGitHub存储库时克隆和添加示例数据。 此方法仅适用于参与开发的开发人员(即计划参与Magento Open Source代码库的开发人员)。

如果您不是参与开发人员，请选择页面左侧目录中显示的其他选项之一。

如果符合以下情况，参与开发的开发人员只能使用此方法来安装示例数据​**：

WARNING
您可以将示例数据与develop分支（更新）或已发布的分支(例如2.4（更稳定）)一起使用。 我们建议您使用已发布的分支，因为它更稳定。 如果您正在向存储库贡献代码，并且需要最新的代码，请使用develop分支。 无论您选择哪个分支，都必须克隆Magento Open SourceGitHub存储库的相应分支。 例如，develop分支的示例数据只能与Magento Open Sourcedevelop分支一起​ 使用。

克隆示例数据存储库

本节讨论如何通过克隆示例数据存储库来安装示例数据。 您可以通过以下任一方式克隆示例数据存储库：

使用SSH进行克隆

要使用SSH协议克隆示例数据GitHub存储库，请执行以下操作：

  1. 在Web浏览器中，转到示例数据存储库。

  2. 在分支名称旁边，单击列表中的​ SSH。

  3. 单击​ 复制到剪贴板

    下图显示了一个示例。

    使用SSH克隆GitHub存储库

  4. 转到Web服务器的docroot目录。

    通常，对于Ubuntu，它是/var/www；对于CentOS，它是/var/www/html。

  5. 输入git clone并粘贴您之前获得的值。

    下面是一个示例：

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

  6. 等待存储库在您的服务器上克隆。

    note note
    NOTE
    如果显示以下错误，请确保您已与GitHub共享SSH密钥：
    code language-none 
    Cloning into 'magento2'...
Permission denied (publickey).
fatal: The remote end hung up unexpectedly

  7. 确保您从主magento2存储库中签出与所用分支对应的示例数据存储库分支。

    例如：

    如果您使用了Magento Open SourceGitHub存储库的2.4-develop分支，则示例数据分支应为2.4-develop。

    要检查正确的分支，请从示例数据存储库的根目录中运行以下命令（假设您需要2.4-develop分支）：

    code language-bash 
    git checkout 2.4-develop

  8. 更改为<app_root>。

  9. 输入以下命令，在您克隆的文件之间创建符号链接，以使示例数据正常工作：

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

  10. 等待命令完成。

  11. 请参阅设置文件系统权限和所有权。

  12. 运行以下命令：

    code language-bash 
    bin/magento setup:upgrade

使用HTTPS进行克隆

要使用HTTPS协议克隆示例数据GitHub存储库，请执行以下操作：

  1. 在Web浏览器中，转到示例数据存储库。

  2. 在页面右侧的​ 克隆URL ​字段下，单击​ HTTPS。

  3. 单击​ 复制到剪贴板。

    下图显示了一个示例。

    使用HTTPS克隆GitHub存储库

  4. 转到Web服务器的docroot目录。

    通常，对于Ubuntu，它是/var/www；对于CentOS，它是/var/www/html。

  5. 输入git clone并粘贴您之前获得的值。

    下面是一个示例：

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

  6. 等待存储库在您的服务器上克隆。

  7. 确保您从主magento2存储库中签出与所用分支对应的示例数据存储库分支。

    例如：

    如果您使用了Magento Open SourceGitHub存储库的2.4-develop分支，则示例数据分支应为2.4-develop。

    要检查正确的分支，请从示例数据存储库的根目录中运行以下命令（假设您需要2.4-develop分支）：

    code language-bash 
    git checkout 2.4-develop

  8. 更改为<magento_root>。

  9. 输入以下命令，在您克隆的文件之间创建符号链接，以使示例数据正常工作：

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

    例如，

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

  10. 等待命令完成。

  11. 请参阅下一部分。

WARNING
如果在安装Adobe Commerce 之后安装示例数据，则还必须运行以下命令来更新数据库和架构：
code language-bash 
<magento_root>/bin/magento setup:upgrade

设置文件系统所有权和权限

由于php build-sample-data.php脚本在示例数据存储库和您的Magento Open Source存储库之间创建符号链接，因此您必须在示例数据存储库中设置文件系统权限和所有权。 否则，会导致访问店面时出现错误。

要对示例数据存储库设置文件系统权限和所有权，请执行以下操作：

  1. 切换到示例数据克隆目录。

  2. 设置所有权：

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

    典型示例：

    • CentOS： chown -R :apache .

    • Ubuntu： chown -R :www-data .

  3. 设置权限：

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

  4. 清除静态文件：

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

完成示例数据安装

下载示例数据包后，以文件系统所有者的身份登录到应用程序服务器或切换到该文件系统所有者，然后在<app_root>目录中输入以下命令：

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