オンプレミスでのクイックスタートのインストール
このページの手順では、セルフホストインフラストラクチャに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オプションで、次の方法でコマンドを実行できます。
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-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 - アクセスキー から作成および設定されます。
usernameの場合は、公開鍵の値をコピーして貼り付けます。passwordの場合は、秘密鍵の値をコピー&ペーストします。note 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 オプションを使用して、管理 URI をカスタマイズできます。 ただし、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