ドキュメントCommerceインストールガイド

[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

サンプルデータ Git リポジトリのクローン

Last update: Wed May 13 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 経験者
  • 管理者
  • 開発者

このトピックでは、Magento Open Source GitHub リポジトリをクローンした場合にサンプルデータをクローンして追加する方法について説明します。 このメソッドは、コントリビューター（つまり、Magento Open Source コードベースへのコントリビューター）のみを対象としています。

貢献開発者でない場合は、ページの左側にある目次に表示される他のオプションのいずれかを選択します。

次の条件に当てはまる場合、コントリビューターは、サンプルデータ のみ​をインストールするこの方法を使用できます。

WARNING
サンプルデータは、develop ブランチ （より最新）またはリリース済みのブランチ （2.4 （より安定）のいずれかで使用できます。 より安定したリリース済みのブランチを使用することをお勧めします。 リポジトリにコードを提供していて、最新のコードが必要な場合は、develop ブランチを使用します。 選択したブランチに関係なく、Magento Open Source GitHub リポジトリの対応するブランチを​ クローン ​する必要があります。 例えば、develop ブランチのサンプルデータは、Magento Open Source develop ブランチで​ only ​使用できます。

サンプルデータリポジトリを複製する

この節では、サンプルデータリポジトリを複製してサンプルデータをインストールする方法について説明します。 サンプルデータリポジトリは、次のいずれかの方法で複製できます。

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-shell 
    git clone git@github.com:magento/magento2-sample-data.git

  6. リポジトリがサーバー上で複製されるのを待ちます。

    note note
    NOTE
    次のエラーが表示される場合は、SSH キーをGitHubと共有していることを確認してください：
    code language-text 
    Cloning into 'magento2'...
Permission denied (publickey).
fatal: The remote end hung up unexpectedly

  7. メインのmagento2 リポジトリから使用したブランチに対応するサンプルデータリポジトリのブランチをチェックアウトしてください。

    例：

    Magento Open Source GitHub リポジトリの2.4-develop ブランチを使用した場合、サンプルデータブランチは2.4-developである必要があります。

    正しいブランチをチェックアウトするには、サンプルデータリポジトリのルートディレクトリから次のコマンドを実行します（2.4-develop ブランチが必要な場合）。

    code language-shell 
    git checkout 2.4-develop

  8. <app_root>に変更します。

  9. 次のコマンドを入力して、サンプルデータが適切に機能するように、複製したファイル間にシンボリックリンクを作成します。

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

  10. コマンドが完了するのを待ちます。

  11. ​ ファイルシステムの権限と所有権の設定を参照してください。

  12. 次のコマンドを実行します。

    code language-shell 
    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-shell 
    git clone https://github.com/magento/magento2-sample-data.git

  6. リポジトリがサーバー上で複製されるのを待ちます。

  7. メインのmagento2 リポジトリから使用したブランチに対応するサンプルデータリポジトリのブランチをチェックアウトしてください。

    例：

    Magento Open Source GitHub リポジトリの2.4-develop ブランチを使用した場合、サンプルデータブランチは2.4-developである必要があります。

    正しいブランチをチェックアウトするには、サンプルデータリポジトリのルートディレクトリから次のコマンドを実行します（2.4-develop ブランチが必要な場合）。

    code language-shell 
    git checkout 2.4-develop

  8. <magento_root>に変更します。

  9. 次のコマンドを入力して、サンプルデータが適切に機能するように、複製したファイル間にシンボリックリンクを作成します。

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

    以下に例を挙げます。

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

  10. コマンドが完了するのを待ちます。

  11. 次の節を参照してください。

WARNING
Adobe Commerceをインストールした後​ にサンプルデータ ​をインストールする場合は、次のコマンドを実行してデータベースとスキーマを更新する必要があります。
code language-shell 
<magento_root>/bin/magento setup:upgrade

ファイルシステムの所有権と権限の設定

php build-sample-data.php スクリプトはサンプルデータリポジトリとMagento Open Source リポジトリの間にシンボリックリンクを作成するので、サンプルデータリポジトリにファイルシステムの権限と所有権を設定する必要があります。 これを怠ると、ストアフロントへのアクセスにエラーが発生します。

サンプルデータリポジトリにファイルシステムの権限と所有権を設定するには：

  1. サンプルデータコピーディレクトリに変更します。

  2. 所有権の設定：

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

    典型的な例：

    • CentOS: chown -R :apache .

    • Ubuntu: chown -R :www-data .

  3. 権限の設定：

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

  4. 静的ファイルを消去：

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

サンプルデータのインストールを完了します

サンプルデータパッケージをダウンロードした後、アプリケーションサーバーにファイルシステム所有者としてログインするか、またはに切り替えて、<app_root> ディレクトリに次のコマンドを入力します。

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