オンプレミスでのクイックスタートのインストール

このページの手順では、セルフホストインフラストラクチャにAdobe Commerceをインストールする方法について説明します。 既存のインストールのアップグレードに関するガイダンスについては、アップグレードガイド を参照してください。

Adobeでは Composer を使用して、Adobe Commerce コンポーネントとその依存関係を管理します。 Composer を使用してAdobe Commerce メタパッケージを取得すると、次の利点があります。

  • サードパーティ製ライブラリをソースコードとバンドルせずに再利用
  • 堅牢な依存関係管理を備えたコンポーネントベースのアーキテクチャを使用することで、拡張機能の競合と互換性の問題を軽減します。
  • PHP-Framework Interoperability Group (FIG)規格に準拠
  • Magento Open Sourceを他のコンポーネントと再パッケージ化
  • 実稼動環境でのAdobe Commerce ソフトウェアの使用
NOTE
Magento Open Sourceに関与する開発者は、git ベースのインストール方式を使用する必要があります。

前提条件

続行する前に、次の操作を行う必要があります。

ファイルシステム所有者としてログインします。

所有権、権限、ファイルシステムの所有者については、 所有権と権限の概要トピックを参照してください。

ファイルシステムの所有者に切り替えるには、次の手順に従います。

  1. ファイルシステムへの書き込み権限を持つユーザーとしてアプリケーションサーバーにログインするか、そのユーザーに切り替えます。

    bash シェルを使用する場合は、次の構文を使用してファイルシステムの所有者に切り替え、同時にコマンドを入力できます。

    code language-bash
    su <file system owner> -s /bin/bash -c <command>
    

    ファイルシステムの所有者がログインを許可しない場合は、次の操作を実行できます。

    code language-bash
    sudo -u <file system owner>  <command>
    
  2. 任意のディレクトリから 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 メタパッケージを入手するには:

  1. ファイルシステムの所有者としてアプリケーションサーバーにログインするか、に切り替えます。

  2. Web サーバーの docroot ディレクトリまたは仮想ホストの docroot として設定したディレクトリに移動します。

  3. 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-namedb-userdb-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
TIP
--backend-frontname オプションを使用して、管理 URI をカスタマイズできます。 ただし、Adobeでは、このオプションを省略し、インストールコマンドがランダムな URI を自動生成できるようにすることをお勧めします。 ランダム URI は、ハッカーや悪意のあるソフトウェアが悪用しにくくなります。 インストールが完了すると、コンソールに URI が表示されます。
TIP
CLI インストール オプションの詳細については、「 コマンド ラインからアプリケーションをインストールする」を参照してください。

コマンドの概要

コマンドの完全なリストを表示するには、次のように入力します。

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}
メンテナンスモードを有効または無効にします(メンテナンスモードでは、除外 IP アドレスのみが管理者またはストアフロントにアクセスできます)。
インストールされているアプリケーション
magento setup:config:set
デプロイメント設定を作成または更新します。
なし
magento module:{enable/disable}
モジュールを有効または無効にします。
なし
magento setup:store-config:set
ストアフロントに関連するオプション(ベース URL、言語、タイムゾーンなど)を設定します。
デプロイメント設定
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
該当なし
ANSI 出力を強制
--no-ansi
該当なし
ANSI 出力を無効にする
NOTE
おめでとうございます。 クイックインストールが完了しました。 より高度なヘルプが必要な場合は、 高度なインストールガイドを確認してください。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995