実行モード

実行モードを使用すると、オーサーまたはパブリッシュ、テスト、開発、イントラネットなど、特定の目的に合わせて AEM インスタンスを調整できます。

以下の操作を実行できます。

設定および定義はすべて 1 つのリポジトリに格納され、実行モード​を設定することによってアクティベートされます。

インストール実行モード

インストール(固定)実行モードは、インストール時に使用され、インスタンスの全期間にわたって固定されます。変更はできません。

インストール実行モードは標準で提供されています。

  • author
  • publish
  • samplecontent
  • nosamplecontent

これらは相互に排他的な実行モードの 2 つのペアです。例えば、次のことが可能です。

  • 次のいずれかを定義 author または publish(両方同時にではない)

  • 結合 author どちらか samplecontent または nosamplecontent (両方ではありません)。

注意

上記のいずれかの実行モード(author、publish、samplecontent、nosamplecontent)を使用するときは、インストール時に使用する値が、そのインストールの全期間​**​の実行モードを定義します。

これらの実行モードは、インストール後は変更できません​**。

カスタマイズされた実行モード

独自のカスタマイズされた実行モードも作成できます。これらを組み合わせて次のようなシナリオに対応できます。

  • author + development

  • publish + test

  • publish + test + golive

  • publish + intranet

  • 必要に応じて使用

カスタマイズされた実行モードは、起動のたびに選択することもできます。

samplecontent および nosamplecontent の使用

これらのモードでは、サンプルコンテンツの使用を制御できます。サンプルコンテンツは、クイックスタートの構築前に定義され、パッケージや設定を含めることができます。

  • samplecontent 実行モードでは、サンプルコンテンツがインストールされます(デフォルトモード)。

  • nosamplecontent モードでは、サンプルコンテンツはインストールされません。

nosamplecontent 実行モードは、実稼働インストール用に設計されています。

実行モードの設定プロパティの定義

特定の実行モードに使用する設定プロパティの値をまとめてリポジトリに保存できます。

実行モードは、フォルダー名のサフィックスで示されます。これにより、すべての設定を 1 つのリポジトリに格納できます。次に例を示します。

  • config

    すべての実行モードに適用可能

  • config.author

    オーサー実行モードに使用

  • config.publish

    公開実行モードに使用

  • config.<run-mode>

    該当する実行モードに使用されます。例:config

これらのフォルダー内で個々の設定ノードを定義する方法、および複数の実行モードの組み合わせに関する設定を作成する方法について詳しくは、リポジトリでの OSGi 設定を参照してください。

メモ

インストール実行モード(オーサーなど)に関しては、インストール後は実行モードを変更できません。ただし、個々の設定プロパティの変更は、再起動時に有効になります。

特定の実行モード用にインストールする追加のバンドルの定義

特定の実行モード用にインストールする必要がある追加のバンドルも指定できます。 これらの定義に関しては、インストールフォルダーを使用してバンドルが格納されます。 繰り返しになりますが、実行モードはプレフィックスで示されます。

  • install.author
  • install.publish

これらのフォルダーは、タイプが nt:folder であり、適切なバンドルを含む必要があります。

特定の実行モードでの CQ の起動

複数の実行モードの設定を定義した場合は、起動時にどれを使用するかを定義する必要があります。使用する実行モードを指定する方法は複数あります。優先順位は次のとおりです。

  1. 🔗

  2. 🔗

  3. システムプロパティ (-D)

  4. ファイル名検出

アプリケーションサーバーを使用している場合は、web.xml で実行モードを定義することもできます。

sling.properties ファイルの使用

sling.properties ファイルを使用して必要な実行モードを定義できます。

  1. 設定ファイルを編集します。

    <cq-installation-dir>/crx-quickstart/conf/sling.properties

  2. 次のプロパティを追加します。次に、作成者向けの例を示します。

    sling.run.modes=author

-r オプションの使用

カスタム実行モードは、 -r オプションを使用して、クイックスタートを起動する際に使用します。 例えば、次のコマンドを使用して、実行モードを dev に設定したAEMインスタンスを起動します。"

java -jar cq-56-p4545.jar -r dev

起動スクリプトのシステムプロパティを使用

起動スクリプトのシステムプロパティを使用して実行モードを指定できます。

  • 例えば、次の例では、米国内の実稼動パブリッシュインスタンスとしてインスタンスを起動します。

    -Dsling.run.modes=publish,prod,us

ファイル名検出 - jar ファイルの名前変更

次の 2 つのインストール実行モードは、インストール前にインストール jar ファイルの名前を変更することで有効化できます。

  • publish
  • 作成者

jar ファイルでは、次の命名規則を使用する必要があります。

cq5-<run-mode>-p<port-number>

例えば、publish 実行モードを設定するには、jar ファイルの名前を次のように変更します。

cq5-publish-p4503

web.xml での実行モードの定義(アプリケーションサーバー使用時)

アプリケーションサーバーを使用している場合は、

sling.run.modes

プロパティを、次のファイル内で設定することもできます。

WEB-INF/web.xml

これは AEM の war ファイル内にあり、デプロイメントの前に更新する必要があります。

詳しくは、AEM をアプリケーションサーバーと共にインストールを参照してください。

このページ