サンプルデータ Git リポジトリのクローン
このトピックでは、Magento Open Source GitHub リポジトリのクローンを作成した場合に、サンプルデータをクローンして追加する方法について説明します。 この方法は、開発者(Magento Open Sourceコードベースにコントリビューションする予定の開発者)のみを対象としています。
コントリビューションを行う開発者でない場合は、ページの左側にある目次に表示されている他のオプションの 1 つを選択します。
コントリビューションを行う開発者は、次の条件が満たされる場合に、このサンプルデータのインストール方法を使用できます のみ。
- Magento Open Sourceを使用している場合
- GitHub リポジトリのクローンを作成しました
develop
ブランチ(より最新)またはリリースされたブランチ(より安定した 2.4
など)で使用できます。 リリース済みのブランチは安定性が高いので、使用することをお勧めします。 リポジトリにコードを提供していて、最新のコードが必要な場合は、develop
ブランチを使用します。 選択するブランチに関係なく、Magento Open Source GitHub リポジトリの対応するブランチを クローンする必要があります。 例えば、develop
分岐のサンプルデータは、Magento Open Source develop
分岐と共に のみ 使用できます。サンプルデータリポジトリのクローンの作成
この項では、サンプル・データ・リポジトリをクローニングしてサンプル・データをインストールする方法について説明します。 サンプルデータリポジトリは、次のいずれかの方法でクローンできます。
- SSH プロトコルを使用したクローン
- HTTPS プロトコルを使用して複製
SSH によるクローン
SSH プロトコルを使用してサンプルデータ GitHub リポジトリのクローンを作成するには:
-
Web ブラウザーで、 サンプルデータリポジトリに移動します。
-
ブランチ名の横にあるリストの「SSH」をクリックします。
-
「クリップボードにコピー」をクリックします
次の図に例を示します。
-
を web サーバーの docroot ディレクトリに変更します。
通常、Ubuntu の場合は
/var/www
で、CentOS の場合は/var/www/html
です。 -
git clone
と入力し、以前に取得した値を貼り付けます。次に例を示します。
code language-bash git clone git@github.com:magento/magento2-sample-data.git
-
リポジトリがサーバー上でクローンされるのを待ちます。
note note NOTE 次のエラーが表示される場合は、SSH キーを共有していることを GitHub で確認してください。 code language-none Cloning into 'magento2'... Permission denied (publickey). fatal: The remote end hung up unexpectedly
-
メインの
magento2
リポジトリから、使用したブランチに対応するサンプルデータリポジトリのブランチをチェックアウトします。例:
Magento Open Source GitHub リポジトリの
2.4-develop
ブランチを使用した場合は、Sample Data ブランチを2.4-develop
す必要があります。正しいブランチをチェックアウトするには、サンプルデータリポジトリのルートディレクトリ(
2.4-develop
ブランチが必要な場合)から次のコマンドを実行します。code language-bash git checkout 2.4-develop
-
<app_root>
に変更します。 -
次のコマンドを入力して、クローンを作成したファイル間にシンボリックリンクを作成し、サンプルデータが正しく動作するようにします。
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 bin/magento setup:upgrade
HTTPS を使用してクローン
HTTPS プロトコルを使用してサンプルデータ GitHub リポジトリを複製するには:
-
Web ブラウザーで、 サンプルデータリポジトリに移動します。
-
ページの右側にある「クローン URL」フィールドで HTTPS をクリックします。
-
クリップボードにコピー をクリックします。
次の図に例を示します。
-
を web サーバーの docroot ディレクトリに変更します。
通常、Ubuntu の場合は
/var/www
で、CentOS の場合は/var/www/html
です。 -
git clone
と入力し、以前に取得した値を貼り付けます。次に例を示します。
code language-bash git clone https://github.com/magento/magento2-sample-data.git
-
リポジトリがサーバー上でクローンされるのを待ちます。
-
メインの
magento2
リポジトリから、使用したブランチに対応するサンプルデータリポジトリのブランチをチェックアウトします。例:
Magento Open Source GitHub リポジトリの
2.4-develop
ブランチを使用した場合は、Sample Data ブランチを2.4-develop
す必要があります。正しいブランチをチェックアウトするには、サンプルデータリポジトリのルートディレクトリ(
2.4-develop
ブランチが必要な場合)から次のコマンドを実行します。code language-bash git checkout 2.4-develop
-
<magento_root>
に変更します。 -
次のコマンドを入力して、クローンを作成したファイル間にシンボリックリンクを作成し、サンプルデータが正しく動作するようにします。
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"
-
コマンドが完了するまで待ちます。
-
次の節を参照してください。
code language-bash |
---|
|
ファイルシステムの所有権と権限の設定
php build-sample-data.php
スクリプトはサンプル・データ・リポジトリとMagento Open Source・リポジトリの間にシンボリック・リンクを作成するため、サンプル・データ・リポジトリ内のファイル・システム権限と所有権を設定する必要があります。 これをおこなわないと、ストアフロントへのアクセスでエラーが発生します。
サンプルデータリポジトリに対するファイルシステムの権限と所有権を設定するには、次の手順に従います。
-
サンプルデータクローンディレクトリに移動します。
-
所有権の設定:
code language-bash chown -R :<your web server group name> .
典型的な例:
-
CentOS:
chown -R :apache .
-
Ubuntu:
chown -R :www-data .
-
-
権限の設定:
code language-bash find . -type d -exec chmod g+ws {} +
-
静的ファイルのクリア:
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