オンプレミスでのクイックスタートのインストール
このページの手順では、セルフホストインフラストラクチャにAdobe Commerceをインストールする方法について説明します。 既存のインストールのアップグレードに関するガイダンスについては、アップグレードガイド を参照してください。
Adobeでは Composer を使用して、Adobe Commerce コンポーネントとその依存関係を管理します。 Composer を使用してAdobe Commerce メタパッケージを取得すると、次の利点があります。
- サードパーティ製ライブラリをソースコードとバンドルせずに再利用
- 堅牢な依存関係管理を備えたコンポーネントベースのアーキテクチャを使用することで、拡張機能の競合と互換性の問題を軽減します。
- PHP-Framework Interoperability Group (FIG)規格に準拠
- Magento Open Sourceを他のコンポーネントと再パッケージ化
- 実稼動環境でのAdobe Commerce ソフトウェアの使用
前提条件
続行する前に、次の操作を行う必要があります。
- すべての 前提条件タスクを完了します。
- Composer のインストール。
- 認証キーをAdobe Commerce Composer リポジトリに取得します。
ファイルシステム所有者としてログインします。
所有権、権限、ファイルシステムの所有者については、 所有権と権限の概要トピックを参照してください。
ファイルシステムの所有者に切り替えるには、次の手順に従います。
-
ファイルシステムへの書き込み権限を持つユーザーとしてアプリケーションサーバーにログインするか、そのユーザーに切り替えます。
bash シェルを使用する場合は、次の構文を使用してファイルシステムの所有者に切り替え、同時にコマンドを入力できます。
code language-bash su <file system owner> -s /bin/bash -c <command>
ファイルシステムの所有者がログインを許可しない場合は、次の操作を実行できます。
code language-bash sudo -u <file system owner> <command>
-
任意のディレクトリから CLI コマンドを実行するには、
<app_root>/bin
をシステムPATH
に追加します。シェルは構文が異なるため、unix.stackexchange.com などのリファレンスを参照してください。
CentOS 用の bash シェルの例:
code language-bash export PATH=$PATH:/var/www/html/magento2/bin
オプションで、次の方法でコマンドを実行できます。
./magento <command name>
としてcd <app_root>/bin
び出して実行app_root>/bin/magento <command name>
<app_root>
は、web サーバーの docroot のサブディレクトリです。
メタパッケージを入手する
Adobe Commerce メタパッケージを入手するには:
-
ファイルシステムの所有者としてアプリケーションサーバーにログインするか、に切り替えます。
-
Web サーバーの docroot ディレクトリまたは仮想ホストの docroot として設定したディレクトリに移動します。
-
Commerce メタパッケージを使用して Composer プロジェクトを作成します。
Magento Open Source
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>
Adobe Commerce
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>
プロンプトが表示されたら、認証キーを入力します。 公開鍵と秘密鍵が作成され、Commerce Marketplace に設定されます。
note note NOTE Composer auth.json
ファイルまたは環境変数を使用する場合、認証キーの入力を求めるプロンプトは表示されません。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
オプションを使用して、管理 URI をカスタマイズできます。 ただし、Adobeでは、このオプションを省略し、インストールコマンドがランダムな URI を自動生成できるようにすることをお勧めします。 ランダム URI は、ハッカーや悪意のあるソフトウェアが悪用しにくくなります。 インストールが完了すると、コンソールに URI が表示されます。コマンドの概要
コマンドの完全なリストを表示するには、次のように入力します。
bin/magento list
特定のコマンドのヘルプを表示するには、次のように入力します。
bin/magento help <command>
例:
bin/magento help setup:install
bin/magento help cache:enable
次の表に、使用可能なコマンドを示します。 コマンドは、要約の形式でのみ表示されます。 コマンドの詳細については、[ コマンド ] 列のリンクをクリックしてください。
magento setup:install
magento setup:uninstall
magento setup:upgrade
magento maintenance:{enable/disable}
magento setup:config:set
magento module:{enable/disable}
magento setup:store-config:set
magento setup:db-schema:upgrade
magento setup:db-data:upgrade
magento setup:db:status
magento admin:user:create
デプロイメント設定
少なくとも
Magento_User
モジュールと Magento_Authorization
モジュールを有効にするデータベース(
bin/magento setup:upgrade
を使用する方法が最も簡単です)magento list
magento 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