高度なオンプレミス インストール
コマンドラインインターフェイス(CLI)
Adobe Commerceには、インストール タスクと設定タスク用の1つのコマンド ライン インターフェイスがあります:<magento_root>/bin/magento。 インターフェイスは、次のような複数のタスクを実行します。
- インストール(およびデータベーススキーマの作成や更新、デプロイメント設定の作成など)に関連するタスク。
- キャッシュのクリア。
- インデックス再作成を含むインデックスの管理。
- 翻訳辞書と翻訳パッケージの作成。
- プラグインのファクトリやインターセプタなどの存在しないクラスを生成し、オブジェクトマネージャーの依存関係インジェクション設定を生成します。
- 静的ビューファイルのデプロイ。
- より少ないCSSの作成。
その他の利点:
- 単一のコマンド (
<magento_root>/bin/magento list)には、使用可能なすべてのインストールおよび設定コマンドが一覧表示されます。 - Symfonyに基づいた一貫したユーザーインターフェイス。
- CLIは拡張可能なので、サードパーティの開発者はCLIに「プラグイン」できます。 これは、ユーザーの学習曲線を排除するという追加の利点があります。
- 無効なモジュールのコマンドは表示されません。
このトピックでは、CLIを使用したAdobe Commerce ソフトウェアのインストールについて説明します。 設定について詳しくは、設定ガイド を参照してください。
インストーラーは必要に応じて複数回実行できるので、次のことが可能です。
-
異なる値を指定
例えば、セキュアソケットレイヤー(SSL)用にweb サーバーを設定した後、インストーラーを実行してSSL オプションを設定できます。
-
以前のインストールでの間違いを修正
-
別のデータベースインスタンスへのAdobe Commerceのインストール
インストールの開始前
開始する前に、次の手順を実行します。
-
お使いのシステムが システム要件で説明されている要件を満たしていることを確認します。
-
すべての前提条件 タスクを完了します。
-
最初のインストール手順を完了します。 インストールまたはアップグレードのパス を参照してください。
-
アプリケーションサーバーにログインした後、 ファイルシステム所有者に切り替えます。
-
インストールのクイックスタート の概要を確認します。
bin サブディレクトリからインストールする必要があります。インストーラーを複数回実行して、次のようなインストールタスクを完了できます。
-
段階的なインストール – 例えば、Web サーバーをSSL (Secure Sockets Layer)用に設定した後、インストーラーを再度実行してSSL オプションを設定できます。
-
以前のインストールで発生したエラーを修正します。
-
別のデータベースインスタンスにAdobe Commerceをインストールします。
cleanup-database パラメーターを使用して、この動作を変更できます。更新、再インストール、アンインストール も参照してください。
安全なインストール
Secure Sockets Layer (SSL)(HTTPS とも呼ばれます)を管理者とストアフロントの両方で使用するには、次のパラメーターをすべて設定する必要があります。
--use-secure:1に設定--base-url-secure:セキュア URL (https://で始まる)に設定します--use-secure-adminを1に設定
これらのパラメーターの詳細については、このトピックの後半で説明します。
インストーラーヘルプコマンド
次のコマンドを実行して、必須の引数の値を検索できます。
bin/magento info:language:listbin/magento info:currency:listbin/magento info:timezone:listコマンドラインからインストール
install コマンドでは、次の形式が使用されます。
bin/magento setup:install --<option>=<value> ... --<option>=<value>
次の表に、インストールオプションの名前と値を示します。 インストールコマンドの例については、 サンプル localhost インストール を参照してください。
管理者の資格情報:
次のオプションは、管理者ユーザーのユーザー情報と資格情報を指定します。
インストール中またはインストール後に管理者ユーザーを作成できます。 インストール中にユーザーを作成する場合は、すべての管理者資格情報変数が必要です。 サンプル localhost インストール を参照してください。
次の表に、使用可能なインストールパラメーターの多くはありますが、一部ではありません。 完全なリストについては、 コマンドラインツールのリファレンス を参照してください。
--admin-firstname--admin-lastname--admin-email--admin-user--admin-password--admin-password='A0b9%t3g'サイトとデータベースの設定オプション:
--base-urlhttp[s]://<host or ip>/<your install dir>/。注意: スキーム (http://またはhttps://)と末尾のスラッシュは両方とも必須です。
<your install dir>は、Adobe Commerce ソフトウェアをインストールするdocroot相対パスです。 Web サーバーと仮想ホストの設定方法によっては、パスがmagento2であるか、空白である可能性があります。Adobe CommerceまたはMagenAdobe Commerceにアクセスするには、
http://127.0.0.1/<your install dir>/またはhttp://127.0.0.1/<your install dir>/のいずれかを使用してください。-
{{base_url}}は、仮想ホスト設定またはDockerなどの仮想化環境によって定義されたベース URLを表します。 例えば、ホスト名magento.example.comで仮想ホストを設定する場合、--base-url={{base_url}}でソフトウェアをインストールし、http://magento.example.com/adminのようなURLで管理者にアクセスできます。--backend-frontnameadmin_jkhgdfqを持つランダム URIをアプリケーションで生成できます。セキュリティ上の理由から、ランダム URIをお勧めします。 ランダム URIは、ハッカーや悪意のあるソフトウェアが悪用するのが困難です。
URIはインストールの最後に表示されます。 後で
bin/magento info:adminuri コマンドを使用して、いつでも表示できます。値を入力する場合は、「管理者」、「バックエンド」などの一般的な単語を使用しないことをお勧めします。 管理者URIには、英数字とアンダースコア文字(
_)のみを含めることができます。--db-host- データベース サーバーの完全修飾ホスト名またはIP アドレス。データベース サーバーがweb サーバーと同じホスト上にある場合、
-
localhost (デフォルト)または127.0.0.1。localhostは、MySQL クライアントライブラリがUNIX ソケットを使用してデータベースに接続することを意味します。 127.0.0.1によって、クライアント ライブラリでTCP プロトコルが使用されます。 ソケットについて詳しくは、PHP PDO_MYSQL ドキュメント を参照してください。注: データベース サーバーのポートは、オプションで
www.example.com:9000のようにホスト名に指定できます--db-nameデフォルトは
magento2です。--db-userデフォルトは
rootです。--db-password--db-prefixその場合、プレフィックスを使用して、このインストールのテーブルを識別します。 一部のお客様は、同じデータベース内のすべてのテーブルを含む複数のAdobe CommerceまたはMagenAdobe Commerce Serverを持っています。
プレフィックスは、最大5文字まで指定できます。 文字で始まる必要があり、文字、数字、アンダースコア文字のみを含めることができます。
このオプションを使用すると、お客様は複数のAdobe Commerce インストールでデータベース サーバーを共有できます
--db-ssl-key--db-ssl-cert--db-ssl-ca--languagebin/magento info:language:listを入力して、言語コードのリストを表示できます)。--currencybin/magento info:currency:listを入力して、通貨のリストを表示できます)。--timezonebin/magento info:timezone:list ディレクトリからbin/を入力して、タイムゾーンのリストを表示できます)。--use-rewrites1とは、ストアフロントおよび管理画面で生成されたリンクにweb サーバーの書き換えを使用することを意味します。0は、web サーバーの書き換えの使用を無効にします。 これがデフォルトです。--use-secure1では、ストアフロント URLでSSL (Secure Sockets Layer)を使用できます。 このオプションを選択する前に、web サーバーがSSLをサポートしていることを確認してください。0はSSLの使用を無効にします。 この場合、その他のすべてのセキュア URL オプションも0と見なされます。 これがデフォルトです。--base-url-securehttp[s]://<host or ip>/<your install dir>/--use-secure-admin1とは、SSLを使用して管理者にアクセスすることを意味します。 このオプションを選択する前に、web サーバーがSSLをサポートしていることを確認してください。0は、管理者と一緒にSSLを使用しないことを意味します。 これがデフォルトです。--admin-use-security-key0は、キーの使用を無効にします。--session-save~
db クラスター化されたデータベースがある場合は、データベースストレージを選択します。そうでない場合、ファイルベースのストレージよりもメリットが大きくない可能性があります。セッションデータをファイルシステムに保存するための~
files。 ファイルベースのセッションストレージは、ファイルシステムのアクセス速度が遅い、クラスター化されたデータベースがある、またはセッションデータをRedisに保存したい場合を除いて適切です。セッションデータをRedisに保存する~
redis。 デフォルトまたはページキャッシュにRedisを使用している場合は、Redisが既にインストールされている必要があります。 Redisのサポートの設定について詳しくは、セッションストレージにRedisを使用するを参照してください。--key--cleanup-database--db-init-statementsデフォルトは
SET NAMES utf8;です。--sales-order-increment-prefix検索エンジン設定オプション:
--search-engineelasticsearch7です。 Elasticsearch 5は非推奨(廃止予定)であり、お勧めしません。--elasticsearch-hostlocalhostです。--elasticsearch-port9200です。--elasticsearch-index-prefixmagento2です。--elasticsearch-timeout15です。--elasticsearch-enable-authfalseです。--elasticsearch-username--elasticsearch-password--opensearch-hostlocalhostです。--opensearch-port9200です。--opensearch-index-prefixmagento2です。--opensearch-timeout15です。--opensearch-enable-authfalseです。--opensearch-username--opensearch-passwordRabbitMQ設定オプション:
--amqp-host--amqpのインストールを既に設定していない限り、RabbitMQ オプションを使用しないでください。 RabbitMQのインストールと設定について詳しくは、RabbitMQ インストールを参照してください。RabbitMQがインストールされているホスト名。
--amqp-port--amqp-userguestは使用しないでください。--amqp-passwordguestは使用しないでください。--amqp-virtualhost/です。--amqp-sslfalseです。 RabbitMQのSSLの設定について詳しくは、RabbitMQを参照してください。--consumers-wait-for-messagesActiveMQ Artemis設定オプション:
--stomp-host--stomp オプションを使用しないでください。 ActiveMQ Artemisのインストールと設定について詳しくは、ActiveMQ Artemisのインストールを参照してください。ActiveMQ Artemisがインストールされているホスト名。
--stomp-port--stomp-userartemisは使用しないでください。--stomp-passwordartemisは使用しないでください。--stomp-sslfalseです。 ActiveMQ ArtemisのSSL設定について詳しくは、ActiveMQ Artemisを参照してください。--consumers-wait-for-messages設定オプションのロック:
--lock-provider使用可能なロック プロバイダー:
db、zookeeper、file。既定のロック プロバイダー:
db--lock-db-prefixdb ロックプロバイダーの使用時にロックの競合を回避するための特定のdb プレフィックス。デフォルト値:
NULL--lock-zookeeper-hostzookeeper ロックプロバイダーを使用する場合に、Zookeeper クラスターに接続するためのホストとポート。例:
127.0.0.1:2181--lock-provider=zookeeperを設定した場合--lock-zookeeper-pathデフォルトパスは
/magento/locksです--lock-file-path--lock-provider=fileを設定した場合コンシューマー設定オプション:
--consumers-wait-for-messages-
0: コンシューマーは、キュー内の使用可能なメッセージを処理し、TCP 接続を閉じて終了します。 コンシューマーは、処理されたメッセージの数が、コンシューマーの開始時に指定された--max_messages値より少ない場合でも、追加のメッセージがキューに入るのを待ちません。 -
1: コンシューマーは、TCP 接続を閉じてコンシューマープロセスを終了する前に、メッセージの最大数(--max_messagesコマンドでqueue:consumers:startに指定された値)に達するまで、メッセージキューからのメッセージ処理を続行します。 キューが--max_messagesに到達する前に空になった場合、コンシューマーは到着するメッセージがさらに届くのを待ちます。 cron ジョブを使用する代わりにワーカーを使用してコンシューマーを実行する場合は、この変数を1に設定します。
--consumers-wait-for-messages オプションはグローバルなオプションであり、消費者ごとに個別に設定することはできません。機密データ:
Adobe Commerceでは、暗号化キーを使用して以下を暗号化します。
- クレジットカード情報
- 管理者設定で指定されたユーザー名とパスワード (例:支払いゲートウェイへのログイン)
- ネットワーク経由で送信される CAPTCHA 値
Adobe Commerceは暗号化 ません
- 管理者および顧客のユーザー名とパスワード(これらのパスワードはハッシュ化されます)
- アドレス
- 電話番号
- クレジットカード番号を除く、他のタイプの個人を特定できる情報
localhostのインストール例
次の例は、様々なオプションを使用してAdobe Commerceをローカルにインストールするコマンドを示しています。
例1:管理者ユーザーアカウントを使用した基本的なインストール
次の例では、次のオプションを使用してAdobe Commerceをインストールします。
-
アプリケーションは、
magento2のweb サーバーのdocrootに関連するlocalhostディレクトリにインストールされ、管理者へのパスはadminです。したがって、次のようになります。ストアフロント URLは
http://127.0.0.1です -
データベース・サーバは、Web サーバと同じホスト上にあります。
データベース名は
magentoで、ユーザー名とパスワードはどちらもmagentoです -
サーバーの書き換えの使用
-
管理者には次のプロパティがあります。
- 氏名は
Magento Userです - ユーザー名は
admin、パスワードはadmin123です - メールアドレスは
user@example.comです
- 氏名は
-
既定の言語は
en_US(米国英語)です -
デフォルト通貨は米ドルです
-
デフォルトのタイムゾーンは米国中部(アメリカ/シカゴ)です
-
OpenSearch 1.2は
os-host.example.comにインストールされ、ポート 9200に接続しています
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.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
インストールが成功したことを示す次のようなメッセージが表示されます。
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
例2 – 管理者ユーザーアカウントを持たない基本インストール
次の例に示すように、管理者ユーザーを作成せずにAdobe Commerceをインストールできます。
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
インストールが成功した場合、次のようなメッセージが表示されます。
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
インストール後、admin:user:create コマンドを使用して管理者ユーザーを作成できます。
管理者を作成または編集
例3:追加のオプションを使用したインストール
次の例では、次のオプションを使用してAdobe Commerceをインストールします。
-
アプリケーションは、
magento2のweb サーバーのdocrootに関連するlocalhostディレクトリにインストールされ、管理者へのパスはadminです。したがって、次のようになります。ストアフロント URLは
http://127.0.0.1です -
データベース・サーバは、Web サーバと同じホスト上にあります。
データベース名は
magentoで、ユーザー名とパスワードはどちらもmagentoです -
管理者には次のプロパティがあります。
- 氏名は
Magento Userです - ユーザー名は
admin、パスワードはadmin123です - メールアドレスは
user@example.comです
- 氏名は
-
既定の言語は
en_US(米国英語)です -
デフォルト通貨は米ドルです
-
デフォルトのタイムゾーンは米国中部(アメリカ/シカゴ)です
-
インストーラーは、テーブルとスキーマをインストールする前に、まずデータベースをクリーンアップします
-
販売注文増分プレフィックス
ORD$を使用できます(特殊文字[$]が含まれているため、値は二重引用符で囲む必要があります) -
セッションデータはデータベースに保存されます
-
サーバーの書き換えの使用
-
OpenSearchは
os-host.example.comにインストールされ、ポート 9200に接続しています
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --cleanup-database \
--sales-order-increment-prefix="ORD$" --session-save=db --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
\文字を付けて入力する必要があります。インストールが成功した場合、次のようなメッセージが表示されます。
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
例4 - ActiveMQ Artemisを使用したインストール
次に、メッセージブローカーとしてActiveMQ Artemisを使用してAdobe Commerceをインストールする例を示します。
bin/magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.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 --stomp-host=localhost --stomp-port=61613 \
--stomp-user=artemis --stomp-password=artemis