DocumentaçãoCommerceGuia de instalação

Clonar repositórios Git de dados de amostra

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

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor

Este tópico discute como clonar e adicionar dados de amostra se você tiver clonado o repositório GitHub do Magento Open Source. Esse método é destinado apenas aos desenvolvedores contribuintes (ou seja, desenvolvedores que planejam contribuir com a base de código do Magento Open Source).

Se você não for um desenvolvedor contribuinte, escolha uma das outras opções exibidas no sumário à esquerda da página.

Os desenvolvedores colaboradores podem usar este método de instalação de dados de exemplo only se o seguinte for verdadeiro:

WARNING
Você pode usar dados de amostra com a ramificação develop (mais atual) ou com uma ramificação lançada (como 2.4 (mais estável)). Recomendamos que você use uma ramificação lançada porque ela é mais estável. Se estiver contribuindo com código para o repositório e precisar do código mais recente, use a ramificação develop. Independentemente da ramificação escolhida, você deve clonar a ramificação correspondente do repositório GitHub Magento Open Source. Por exemplo, dados de exemplo para a ramificação develop podem ser usados only com a ramificação Magento Open Source develop.

Clonar o repositório de dados de amostra

Esta seção discute como instalar dados de amostra clonando o repositório de dados de amostra. Você pode clonar o repositório de dados de amostra de qualquer uma das seguintes maneiras:

Clonar com SSH

Para clonar o repositório GitHub de dados de amostra usando o protocolo SSH:

  1. Em um navegador da Web, vá para o repositório de dados de amostra.

  2. Ao lado do nome da ramificação, clique em SSH na lista.

  3. Clique em Copiar para a área de transferência

    A figura a seguir mostra um exemplo.

    Clonar o repositório GitHub usando SSH

  4. Altere para o diretório docroot do servidor Web.

    Normalmente, para o Ubuntu, é /var/www e para o CentOS, /var/www/html.

  5. Insira git clone e cole o valor obtido anteriormente.

    Um exemplo é o seguinte:

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

  6. Aguarde o repositório clonar no servidor.

    note note
    NOTE
    Se o seguinte erro for exibido, verifique se você compartilhou sua chave SSH com o GitHub:
    code language-none 
    Cloning into 'magento2'...
Permission denied (publickey).
fatal: The remote end hung up unexpectedly

  7. Verifique a ramificação do repositório de dados de amostra que corresponde à ramificação usada no repositório magento2 principal.

    Por exemplo:

    Se você usou a ramificação 2.4-develop do repositório GitHub Magento Open Source, a ramificação de Dados de amostra deve ser 2.4-develop.

    Para fazer check-out da ramificação correta, execute o seguinte comando no diretório raiz do repositório de dados de amostra (supondo que você precise da ramificação 2.4-develop):

    code language-bash 
    git checkout 2.4-develop

  8. Alterar para <app_root>.

  9. Digite o seguinte comando para criar vínculos simbólicos entre os arquivos clonados para que os dados de amostra funcionem corretamente:

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

  10. Aguarde a conclusão do comando.

  11. Consulte Definir permissões e propriedade do sistema de arquivos.

  12. Execute o seguinte comando:

    code language-bash 
    bin/magento setup:upgrade

Clonar com HTTPS

Para clonar o repositório GitHub de dados de amostra usando o protocolo HTTPS:

  1. Em um navegador da Web, vá para o repositório de dados de amostra.

  2. No lado direito da página, no campo clonar URL, clique em HTTPS.

  3. Clique em Copiar para a área de transferência.

    A figura a seguir mostra um exemplo.

    Clonar o repositório GitHub usando HTTPS

  4. Altere para o diretório docroot do servidor Web.

    Normalmente, para o Ubuntu, é /var/www e para o CentOS, /var/www/html.

  5. Insira git clone e cole o valor obtido anteriormente.

    Um exemplo é o seguinte:

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

  6. Aguarde o repositório clonar no servidor.

  7. Verifique a ramificação do repositório de dados de amostra que corresponde à ramificação usada no repositório magento2 principal.

    Por exemplo:

    Se você usou a ramificação 2.4-develop do repositório GitHub Magento Open Source, a ramificação de Dados de amostra deve ser 2.4-develop.

    Para fazer check-out da ramificação correta, execute o seguinte comando no diretório raiz do repositório de dados de amostra (supondo que você precise da ramificação 2.4-develop):

    code language-bash 
    git checkout 2.4-develop

  8. Alterar para <magento_root>.

  9. Digite o seguinte comando para criar vínculos simbólicos entre os arquivos clonados para que os dados de amostra funcionem corretamente:

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

    Por exemplo,

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

  10. Aguarde a conclusão do comando.

  11. Consulte a próxima seção.

WARNING
Se você estiver instalando dados de exemplo após a instalação do Adobe Commerce, também deverá executar o seguinte comando para atualizar o banco de dados e o esquema:
code language-bash 
<magento_root>/bin/magento setup:upgrade

Definir a propriedade e as permissões do sistema de arquivos

Como o script php build-sample-data.php cria symlinks entre o repositório de dados de amostra e o repositório Magento Open Source, você deve definir as permissões do sistema de arquivos e a propriedade no repositório de dados de amostra. Se isso não for feito, ocorrerão erros ao acessar a loja.

Para definir as permissões e a propriedade do sistema de arquivos no repositório de dados de amostra:

  1. Altere para o diretório de clonagem de dados de amostra.

  2. Definir propriedade:

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

    Exemplos típicos:

    • CentOS: chown -R :apache .

    • Ubuntu: chown -R :www-data .

  3. Definir permissões:

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

  4. Limpar arquivos estáticos:

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

Conclua a instalação dos dados de amostra

Depois de baixar os pacotes de dados de amostra, faça logon no servidor de aplicativos como proprietário do sistema de arquivos ou alterne para ele e digite o seguinte comando no diretório <app_root>:

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