AEM プロジェクトアーキタイプ

AEM プロジェクトのアーキタイプは、最小限のベストプラクティスベースの Adobe Experience Manager プロジェクトを独自の AEM プロジェクトの起点として作成します。このアーキタイプを使用する際に指定する必要があるプロパティにより、このプロジェクトのすべての部分の名前を指定し、特定のオプション機能を制御できます。

アーキタイプを使用する理由

AEM プロジェクトのアーキタイプを使用すると、数回のキー操作で、ベストプラクティスベースの AEM プロジェクトを構築するためのパスが設定されます。アーキタイプを使用すると、すべての要素が配置され、結果として生成されるプロジェクトを最小限に抑えながら、AEM の主要機能すべてが実装されることになります。これにより、必要な作業はその上に構築して拡張するだけとなります。

もちろん、成功する AEM プロジェクトには多数の要素がありますが、AEM プロジェクトのアーキタイプを使用すると健全な基盤を構築できるので、あらゆる AEM プロジェクトで強くお勧めします。

はじめに

プロジェクトのアーキタイプを使用すると、AEM での開発を簡単に開始できます。最初の手順にはいくつかの方法があります。

  • WKND チュートリアル - アーキタイプの活用方法など、AEM での開発に関する詳しい概要については、「AEM Sites の概要 - WKND チュートリアル」を参照して、アーキタイプを使用した単純なプロジェクトの実装手順を示す実例を確認してください。
  • WKND イベントチュートリアル - AEM でのシングルページアプリケーション（SPA）の開発に特に関心がある場合は、専用の WKND イベントチュートリアルを必ずご覧ください。
  • ダウンロードして開始しましょう。- 以下の簡単な手順に従うと、GitHub で利用可能な現在のプロジェクトのアーキタイプを簡単にダウンロードして、最初のプロジェクトを作成できます。

アーキタイプを使用して得られる結果

AEM アーキタイプは、次のモジュールで構成されています。

  • core：OSGi サービス、リスナー、スケジューラなどのすべてのコア機能、およびサーブレットや要求フィルターなどのコンポーネント関連の Java コードが含まれる Java バンドル。
  • it.tests：Java ベースの統合テスト。
  • ui.apps：プロジェクトの /apps と /etc の部分（JS および CSS クライアントライブラリ、コンポーネント、テンプレート）が含まれます。
  • ui.content：ui.apps モジュールのコンポーネントを使用するサンプルコンテンツが含まれます。
  • ui.config：プロジェクトの実行モード固有の OSGi 設定が含まれます。
  • ui.frontend.general：（オプション）​一般的な Webpack ベースのフロントエンドビルドモジュールの使用に必要なアーティファクトが含まれます。
  • ui.frontend.react：（オプション）​アーキタイプを使用して React に基づく SPA プロジェクトを作成する場合に必要なアーティファクトが含まれます。
  • ui.frontend.angular：（オプション）​アーキタイプを使用して Angular に基づく SPA プロジェクトを作成する場合に必要なアーティファクトが含まれます。
  • ui.tests：Selenium ベースの UI テストが含まれます。
  • all：ベンダー依存関係を含むすべてのコンパイル済みモジュール（バンドルとコンテンツパッケージ）を組み込んだ単一のコンテンツパッケージ。
  • analyse：プロジェクトの分析を実行します。この結果、AEM as a Cloud Service にデプロイするための追加の検証が提供されます。

Maven で表される AEM アーキタイプのモジュールは、アプリケーション、コンテンツ、および必要な OSGi バンドルを表すコンテンツページとして AEM にデプロイされます。

アーキタイプの使用方法

アーキタイプを使用するには、最初にプロジェクトを作成し、前述のとおりにローカルファイル構造でモジュールを生成する必要があります。プロジェクト生成の一環として、プロジェクト名、バージョンなど、プロジェクトの多数のプロパティを定義できます。

Maven でプロジェクトを構築すると、AEM にデプロイできるアーティファクト（パッケージおよび OSGi バンドル）が作成されます。追加の Maven コマンドおよびプロファイルを使用して、プロジェクトのアーティファクトを AEM インスタンスにデプロイできます。

プロジェクトの作成

最初に、最も簡単に AEM Eclipse 拡張機能を使用し、新しいプロジェクトウィザードに従って「AEM Sample Multi-Module Project」を選択し、リリースされたバージョンのアーキタイプを使用できます。

もちろん、Maven を直接呼び出すこともできます。

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=XX \
 -D aemVersion=cloud \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \
 -D frontendModule=general \
 -D includeExamples=n
  • XX を、最新の AEM プロジェクトアーキタイプのバージョン番号に設定します。
  • AEM as a Cloud Service の場合は、aemVersion=cloud と設定します。
    Adobe Managed Services またはオンプレミスの場合は、aemVersion=6.5.0 と設定します。AEM as a Cloud Service の場合はコアコンポーネントがすぐに使用できる形で提供されているので、コアコンポーネントの依存関係は、非クラウドバージョンの AEM の場合にのみ追加します。
  • appTitle="My Site" を調整して、Web サイトのタイトルやコンポーネントグループを定義します。
  • appId="mysite" を調整して、Maven アーティファクト ID、コンポーネントフォルダー名、設定フォルダー名、コンテンツフォルダー名、およびクライアントライブラリ名を定義します。
  • groupId="com.mysite" を調整して、Maven グループ ID と Java ソースパッケージを定義します。
  • 使用可能なプロパティのリストを調べて、調整が必要なプロパティが他にあるかどうかを確認します。
メモ

ベストプラクティスとしては、repo.adobe.com を自動で maven のビルドプロセスに追加するために、adobe-public プロファイルを Maven の settings.xml ファイルに追加することが推奨されます。

POM の例はこちらにあります。

プロパティ

アーキタイプを使用してプロジェクトを作成する場合は、次のプロパティを使用できます。

名前 デフォルト値は 説明
appTitle アプリケーションのタイトル。Web サイトのタイトルやコンポーネントグループに使用されます（例："My Site"）。
appId 技術的な名前。コンポーネント、設定、コンテンツのフォルダー名やクライアントライブラリ名に使用されます（例："mysite"）。
artifactId ${appId} 基本 Maven アーティファクト ID です（例："mysite"）。
groupId 基本 Maven グループ ID です（例："com.mysite"）。
package ${groupId} Java ソースパッケージです（例："com.mysite"）。
version 1.0-SNAPSHOT プロジェクトのバージョンです（例：1.0-SNAPSHOT）。
aemVersion cloud ターゲット AEM バージョンです（AEM as a Cloud Service の場合は cloud。Adobe Managed Services またはオンプレミスの場合は、6.5.0、6.4.4 のいずれか）。
sdkVersion latest aemVersion=cloud の場合は、SDK のバージョンを指定できます（例：2020.02.2265.20200217T222518Z-200130）。
includeDispatcherConfig y aemVersion の値に応じて、クラウドか AMS／オンプレミスのいずれかの Dispatcher 設定を組み込みます（y または n）。
frontendModule general クライアントライブラリを生成する Webpack フロントエンドビルドモジュールを組み込みます（通常のサイトの場合は general または none。SPA エディターを実装しているシングルページアプリの場合は angular または react）。
language en コンテンツ構造の作成に使用する言語コード（ISO 639-1）（例：en、deu）。
country us コンテンツ構造の作成に使用する国コード（ISO 3166-1）（例：US）。
singleCountry y 言語マスターコンテンツ構造を組み込みます（y または n）。
includeExamples n コンポーネントライブラリのサンプルサイトを組み込みます（y または n）。
includeErrorHandler n インスタンス全体でグローバルに使用されるカスタムの 404 応答ページを組み込みます（y または n）。
includeCommerce n CIF コアコンポーネントの依存関係を含み、対応するアーティファクトを生成します。
commerceEndpoint CIF でのみ必須です。使用するコマースシステム GraphQL サービスのオプションのエンドポイント（例：https://hostname.com/grapql）をクリックします。
datalayer y Adobe クライアントデータレイヤーとの統合をアクティブ化します。
amp n 生成されたプロジェクトテンプレートに対して AMP のサポートを有効にします。
enableDynamicMedia n プロジェクトポリシー設定で基盤 Dynamic Media コンポーネントを有効にし、コア画像コンポーネントのポリシーで Dynamic Media 機能をアクティブ化します。
enableSSR n フロントエンドプロジェクトに対して SSR を有効にするオプション
precompiledScripts n ui.apps のサーバーサイドスクリプトを事前にコンパイルして、ui.apps プロジェクトのセカンダリバンドルアーティファクトとしてビルドにアタッチするオプション。aemVersion を cloud に設定する必要があります。
メモ

アーキタイプを初めてインタラクティブモードで実行する際には、デフォルト値のプロパティは変更できません（詳しくは ARCHETYPE-308 を参照してください）。この値は、最後のプロパティ確認が拒否され、質問が繰り返された場合や、コマンドラインでパラメータを渡す際に変更できます（例：-DoptionIncludeExamples=n）。

メモ

Windows 上で実行して Dispatcher 設定を生成する場合は、管理者権限のコマンドプロンプトまたは Windows Subsystem for Linux から実行する必要があります（問題 329 を参照）。

プロファイル

生成された Maven プロジェクトは、mvn install の実行時に様々なデプロイメントプロファイルをサポートします。

プロファイル ID 説明
autoInstallBundle maven-sling-plugin を含むコアバンドルを felix コンソールにインストールします。
autoInstallPackage パッケージマネージャーに content-package-maven-plugin を使用し、ui.content と ui.apps のコンテンツパッケージをローカルホスト（ポート 4502）のデフォルトのオーサーインスタンスにインストールします。ホスト名とポートは、aem.host および aem.port ユーザー定義プロパティを使用して変更できます。
autoInstallPackagePublish パッケージマネージャーに content-package-maven-plugin を使用し、ui.content と ui.apps のコンテンツパッケージをローカルホスト（ポート 4503）のデフォルトのパブリッシュインスタンスにインストールします。ホスト名とポートは、aem.host および aem.port ユーザー定義プロパティを使用して変更できます。
autoInstallSinglePackage パッケージマネージャーに content-package-maven-plugin を使用し、all のコンテンツパッケージをローカルホスト（ポート 4502）のデフォルトのオーサーインスタンスにインストールします。ホスト名とポートは、aem.host および aem.port ユーザー定義プロパティを使用して変更できます。
autoInstallSinglePackagePublish パッケージマネージャーに content-package-maven-plugin を使用し、all のコンテンツパッケージをローカルホスト（ポート 4503）のデフォルトのパブリッシュインスタンスにインストールします。ホスト名とポートは、aem.host および aem.port ユーザー定義プロパティを使用して変更できます。
integrationTests 提供された統合テストを AEM インスタンスで実行します（verify フェーズのみ）。
precompiledScripts precompiledScripts プロパティを y に設定してプロジェクトが生成されたときに自動的に定義されます。プロファイルはデフォルトでアクティブで、事前コンパイル済みスクリプトを含んだ OSGi バンドルを ui.apps 内に生成します。このスクリプトは all コンテンツパッケージに組み込まれます。プロファイルは -DskipScriptPrecompilation=true で無効にできます。

ビルドとインストール

プロジェクトのルートディレクトリで実行するすべてのモジュールを構築するには、次の Maven コマンドを使用します。

mvn clean install

実行中の AEM インスタンスがある場合は、次の Maven コマンドを使用して、プロジェクト全体を構築およびパッケージ化し、AEM にデプロイできます。

mvn clean install -PautoInstallPackage

パブリッシュインスタンスにデプロイするには、次のコマンドを実行します。

mvn clean install -PautoInstallPackagePublish

または、パブリッシュインスタンスにデプロイするには、次のコマンドを実行します。

mvn clean install -PautoInstallPackage -Daem.port=4503

または、オーサーにバンドルのみをデプロイするには、次のコマンドを実行します。

mvn clean install -PautoInstallBundle

親 POM

プロジェクトのルートにある pom.xml（<src-directory>/<project>/pom.xml）は親 POM と呼ばれ、プロジェクトの構造を駆動し、プロジェクトの依存関係と特定のグローバルプロパティを管理します。

グローバルプロジェクトプロパティ

親 POM の <properties> セクションでは、ユーザー名／パスワード、ホスト名／ポートなど、AEM インスタンスにプロジェクトをデプロイする際に重要なグローバルプロパティを定義します。

これらのプロパティは、ローカルの AEM インスタンスにデプロイするために設定されています。これは、開発者が行う最も一般的なビルドです。オーサーインスタンスにデプロイするためのプロパティおよびパブリッシュインスタンスにデプロイするためのプロパティが存在することに注意してください。ここでは AEM インスタンスを認証するための認証も設定されます。デフォルトの admin:admin 認証が使用されています。

これらのプロパティは、より上位の環境にデプロイされる際には上書きされるよう設定されています。そうすることで、POM ファイルを変更する必要がなく、aem.host および sling.password などの変数をコマンドライン引数で上書きできます。

mvn -PautoInstallPackage clean install -Daem.host=production.hostname -Dsling.password=productionpasswd

モジュール構造

親 POM の <modules> セクションは、プロジェクトが構築するモジュールを定義します。デフォルトでは、プロジェクトは以前に定義された標準モジュール（core、ui.apps、ui.content、ui.tests および it.launcher）を構築します。プロジェクトの拡大に合わせて、いつでもモジュールを追加できます。

依存関係

親 POM の <dependencyManagement> セクションは、プロジェクトで使用される API のすべての依存関係とバージョンを定義します。バージョンは親 POM 内で管理する必要があり、コアや ui.apps などのサブモジュールにはバージョン情報を一切含めてはなりません。

Uber-Jar

主要な依存関係の 1 つに AEM Java API Jar があります。これにより、AEM のバージョンに対して、すべての AEM API が単一の依存関係のエントリで含められます。

メモ

ベストプラクティスとしては、AEM のターゲットバージョンに合わせて uber-jar のバージョンを更新することが推奨されます。例えば、AEM 6.4 をデプロイする予定であれば、uber-jar のバージョンを 6.4.0 に更新します。

コアコンポーネント

もちろん、AEM プロジェクトのアーキタイプはコアコンポーネントを活用します。

コアコンポーネントは、デフォルトの実行モードで AEM に自動的にインストールされます。また、サンプルの WKND サイトで使用されます。実稼動実行モード（nosamplecontent）では、コアコンポーネントは使用できません。

そのため、すべてのデプロイメントでコアコンポーネントを使用するには、それらを Maven プロジェクトの一部に組み込むことが推奨されます。

メモ

最新のアーキテクチャでコアコンポーネントの最新バージョンが使用されるよう、通常は、コアコンポーネントの各リリースに続き、AEM プロジェクトアーキタイプがリリースされます。

ただし、新しいバージョンのアーキタイプは、新しいバージョンのコアコンポーネントに直接従っていない可能性があるので、コアコンポーネントの依存関係を最新バージョンに更新することができます。

メモ

core.wcm.components.examples は、コアコンポーネントの例を示す一連のサンプルページです。ベストプラクティスとして、実稼動用にプロジェクトをデプロイする場合は、この依存関係とサブパッケージのインクルージョンを削除する必要があります。

テスト

プロジェクトには 3 つのレベルのテストが含まれており、テストのタイプが異なるので、実行方法も場所も異なります。

  • コアでの単体テスト：バンドルに含まれるコードの従来のユニットテストを示しています。テストするには、次のコマンドを実行します。
    • mvn clean test
  • サーバーサイド統合テスト：これらのテストは、AEM 環境（AEM サーバー上など）で実行されます。テストするには、次のコマンドを実行します。
    • mvn clean verify -PintegrationTests
  • クライアントサイドの Hobbes.js テスト：ブラウザー側の動作を検証する JavaScript ベースのブラウザーサイドテストです。テストするには：
    1. ページの作成時と同様に、ブラウザーに AEM を読み込みます。
    2. ページを開発者モードで開きます。
    3. 左のパネルを開き、「Tests」タブに切り替えます。
    4. 生成された MyName Tests を見つけ、実行します。

次の手順

AEM プロジェクトアーキタイプを構築し、インストールしました。次は何をすればよいでしょうか。アーキタイプは小さいとはいえ、推奨ベストプラクティスに従って設定された、多数の強力な AEM 機能の例で構成されています。これらを使用すれば、プロジェクトで機能をどのように活用できるかがわかります。どのプロジェクトでも、次の作業が必要になる可能性があります。

このページ