オンプレミスのクイックスタートインストール
このページの手順では、Adobe Commerceをセルフホスト型インフラストラクチャにインストールする方法について説明します。 既存のインストールのアップグレードに関するガイダンスについては、アップグレードガイドを参照してください。
Adobeでは、Composerを使用して、Adobe Commerce コンポーネントとその依存関係を管理します。 Composerを使用してAdobe Commerce メタパッケージを取得すると、次の利点が得られます。
- サードパーティライブラリをソースコードにバンドルすることなく再利用
- 堅牢な依存関係管理を備えたコンポーネントベースのアーキテクチャを使用することで、拡張機能の競合や互換性の問題を軽減できます
- PHP フレームワーク相互運用性グループ (FIG) 標準に準拠
- Magento Open Sourceと他のコンポーネントの再パッケージ
- 本番環境でのAdobe Commerce ソフトウェアの使用
前提条件
続行する前に、次の操作を行う必要があります。
ファイルシステム所有者としてログイン
所有権、権限、およびファイルシステムの所有者について詳しくは、所有権と権限の概要トピック を参照してください。
ファイルシステムの所有者に切り替えるには:
-
ファイルシステムへの書き込み権限を持つユーザーとしてアプリケーションサーバーにログインするか、切り替えます。
bash シェルを使用する場合は、次の構文を使用してファイルシステム所有者に切り替え、同時にコマンドを入力できます。
code language-shell su <file system owner> -s /bin/bash -c <command>ファイルシステムの所有者がログインを許可しない場合は、次の操作を実行できます。
code language-shell sudo -u <file system owner> <command> -
任意のディレクトリからCLI コマンドを実行するには、システム
PATHに<app_root>/binを追加します。シェルの構文は異なるので、unix.stackexchange.comなどの参照を参照してください。
CentOSのbash シェルの例:
code language-shell export PATH=$PATH:/var/www/html/magento2/binオプションで、次の方法でコマンドを実行できます。
cd <app_root>/binとして実行./magento <command name>app_root>/bin/magento <command name><app_root>はweb サーバーのdocrootのサブディレクトリです
メタパッケージを入手
Adobe Commerce メタパッケージを取得するには:
-
ファイルシステム所有者としてアプリケーションサーバーにログインするか、切り替えます。
-
Web サーバーのdocroot ディレクトリまたは仮想ホストのdocrootとして設定したディレクトリに変更します。
-
Commerce メタパッケージを使用してComposer プロジェクトを作成します。
Magento Open Source
code language-shell composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>Adobe Commerce
code language-shell composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>プロンプトが表示されたら、認証キーを入力します。 公開鍵と秘密鍵は、Commerce Marketplace - アクセスキーから作成および設定されます。
usernameの場合は、公開鍵の値をコピーして貼り付けます。passwordの場合は、秘密鍵の値をコピーして貼り付けます。note NOTE Commerce認証キーで構成されたComposer [auth.json](https://experienceleague.adobe.com/ja/docs/commerce-cloud-service/user-guide/develop/authentication-keys)ファイルまたは環境変数を使用する場合、認証キーを入力するメッセージは表示されません。Could not find package...や...no matching package foundなどのエラーが発生した場合は、コマンドにタイプミスがないことを確認してください。 それでもエラーが発生する場合は、Adobe Commerceのダウンロードが許可されない場合があります。 ヘルプについては、Adobe Commerce サポート にお問い合わせください。その他のエラーについては、 トラブルシューティング を参照してください。
例 – マイナーリリース
マイナーリリースには、新機能、品質修正、セキュリティ修正が含まれています。 マイナーリリースを指定するには、Composerを使用します。 例えば、Adobe Commerce 2.4.6 メタパッケージを指定するには、次の手順を実行します。
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
例 – 品質パッチ
品質パッチには、主に機能的な および のセキュリティ修正が含まれています。 しかし、新しい後方互換性のある機能を含むこともあります。 Composerを使用して、高品質のパッチをダウンロードします。 例えば、Adobe Commerce 2.4.6 メタパッケージを指定するには、次の手順を実行します。
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
例 – セキュリティパッチ
セキュリティパッチにはセキュリティ修正のみが含まれています。 アップグレードプロセスをより迅速かつ容易に行えるように設計されています。
セキュリティパッチでは、Composerの命名規則2.4.6-pxが使用されます。 Composerを使用してパッチを指定します。 例えば、Adobe Commerce 2.4.6-p1 メタパッケージをダウンロードするには、次の手順を実行します。
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>
ファイル権限の設定
Adobe Commerceをインストールする前に、web サーバーグループの読み取り/書き込み権限を設定する必要があります。 これは、コマンドラインがファイルシステムにファイルを書き込めるようにするために必要です。
cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento
アプリケーションのインストール
Adobe Commerceをインストールするには、コマンドラインを使用する必要があります。
この例では、インストールディレクトリの名前がmagento2eeで、db-hostが同じコンピューター(localhost)にあり、db-name、db-user、db-passwordがすべてmagentoであると仮定します。
bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15
--backend-frontname オプションでカスタマイズできます。 ただし、Adobeでは、このオプションを省略し、インストールコマンドでランダムなURIを自動生成できるようにすることをお勧めします。 ランダム URIは、ハッカーや悪意のあるソフトウェアが悪用するのが困難です。 インストールが完了すると、URIがコンソールに表示されます。コマンドの概要
コマンドの完全なリストを表示するには、次のように入力します。
bin/magento list
特定のコマンドのヘルプを表示するには、次のように入力します。
bin/magento help <command>
例:
bin/magento help setup:install
bin/magento help cache:enable
次の表に、使用可能なコマンドの概要を示します。 コマンドはサマリーフォームでのみ表示されます。 コマンドの詳細については、「コマンド」列のリンクをクリックしてください。
magento setup:installmagento setup:uninstallmagento setup:upgrademagento maintenance:{enable/disable}magento setup:config:setmagento module:{enable/disable}magento setup:store-config:setmagento setup:db-schema:upgrademagento setup:db-data:upgrademagento setup:db:statusmagento admin:user:createデプロイメント設定
少なくとも
Magento_UserおよびMagento_Authorization モジュールデータベースを有効にする(最も簡単な方法は
bin/magento setup:upgradeを使用することです)magento listmagento help共通引数
次の引数は、すべてのコマンドに共通です。 これらのコマンドは、アプリケーションのインストール前またはインストール後に実行できます。
--help-h./magento help setup:installまたは./magento help setup:config:set--quiet-q--no-interaction-n--verbose=1,2,3-v, -vv, -vvv--verbose=3または-vvvは、最も冗長な出力であるデバッグの冗長性を表示します。 デフォルトは--verbose=1または-vです。--version-V--ansi--no-ansi