すべてをまとめる方法 - AEM ヘッドレスのアプリとコンテンツ

AEM ヘッドレス開発者ジャーニーのこのパートでは、AEM 開発ツールとヘッドレス SDK を使用してアプリケーションを統合する方法を説明します。

これまでの説明内容

AEM ヘッドレスジャーニーの前のドキュメント AEM Assets API を使用してコンテンツを更新する方法では、API を使用して AEM の既存のヘッドレスコンテンツを更新する方法を説明し、以下を達成できました。

  • AEM Assets HTTP API を理解する

目的

この記事では、次の方法で AEM ヘッドレスアプリケーションをまとめる方法を説明します。

  • AEM ヘッドレス SDK と必要な開発ツールの把握
  • 運用開始前にコンテンツをシミュレートするためのローカル開発ランタイムのセットアップ
  • AEM コンテンツレプリケーションの基本について

AEM SDK

AEM SDK は、カスタムコードのビルドとデプロイに使用されます。これは、ヘッドレスアプリケーションを開発し運用開始前にテストするために必要な主なツールです。次のアーティファクトで構成されます。

  • クイックスタート JAR - オーサーインスタンスとパブリッシュインスタンスの両方をセットアップするために使用できる実行可能な JAR ファイル
  • Dispatcher ツール - Windows および UNIX® ベースシステム用の Dispatcher モジュールとその依存関係
  • Java™ API JAR - AEM に対応した開発に使用できる、許可されたすべての Java™ API を公開する Java™ JAR／Maven 依存関係
  • Javadoc JAR - Java™ API JAR の Javadoc

AEM ヘッドレス SDK

AEM SDK とは異なり、AEM ヘッドレス SDK は、クライアントが HTTP 経由で AEM ヘッドレス API を素早く簡単に操作するために使用できるライブラリのセットです。

AEM ヘッドレス SDK について詳しくは、こちらのドキュメントを参照してください。

その他の開発ツール

AEM SDK の他に、コードとコンテンツをローカルで開発およびテストするための追加のツールが必要です。

  • Java™
  • Git
  • Apache Maven
  • Node.js ライブラリ
  • 任意の IDE

AEM は Java™ アプリケーションなので、AEM as a Cloud Service の開発をサポートするには、Java™ と Java™ SDK をインストールする必要があります。

Git は、ソース管理の管理や、Cloud Manager への変更のチェックイン、実稼動インスタンスへのデプロイに使用するものです。

AEM Maven プロジェクトアーキタイプから生成されたプロジェクトをビルドするために、AEM では Apache Maven を使用します。主要な IDE はすべて Maven との統合をサポートしています。

Node.js は、AEM プロジェクトの ui.frontend サブプロジェクトのフロントエンドアセットを操作するために使用される JavaScript ランタイム環境です。Node.js は npm と共に配布され、JavaScript の依存関係の管理に使用される事実上の Node.js Package Manager です。

AEM システムのコンポーネントの概要

次に、AEM環境の構成要素を見てみましょう。

完全な AEM 環境は、オーサー、パブリッシュ、ディスパッチャーで構成されます。運用開始前にコードとコンテンツをプレビューしやすくするために、これらと同じコンポーネントがローカル開発ランタイムで使用可能です。

  • オーサーサービス​では、内部ユーザーがコンテンツの作成、管理、プレビューを行います。

  • パブリッシュサービス​は「ライブ」環境と考えられ、通常はエンドユーザーがやり取りする相手になります。コンテンツは、オーサーサービスで編集および承認された後、パブリッシュサービスに配信されます。AEM ヘッドレスアプリケーションで最も一般的なデプロイメントパターンは、実稼動版のアプリケーションを AEM パブリッシュサービスに接続させることです。

  • Dispatcher は、AEM Dispatcher モジュールで拡張された静的 web サーバーです。パブリッシュインスタンスで生成された Web ページをキャッシュしてパフォーマンスを向上します。

ローカル開発ワークフロー

ローカル開発プロジェクトは Apache Maven をベースに構築され、ソース管理に Git を使用します。プロジェクトを更新するために、開発者は、Eclipse、Visual Studio Code、IntelliJ など、望ましい統合開発環境を使用できます。

ヘッドレスアプリケーションによって取り込まれるコードやコンテンツの更新をテストするには、AEMオーサーサービスとパブリッシュサービスのローカルインスタンスを含む、ローカルAEMランタイムに更新をデプロイする必要があります。

アップデートが最も重要な場所でアップデートをテストすることが大切なので、ローカル AEM ランタイムの各コンポーネントの違いに注意してください。例えば、オーサーインスタンスでコンテンツのアップデートをテストしたり、パブリッシュインスタンスで新しいコードをテストしたりします。

実稼動システムでは、Dispatcher と HTTP Apache サーバーは常に AEM パブリッシュインスタンスの前に配置されます。これらは AEM システムのキャッシュサービスとセキュリティサービスを提供するので、Dispatcher に対してもコードとコンテンツのアップデートをテストすることが最も重要です。

ローカル開発環境でのコードとコンテンツのローカルプレビュー

AEMヘッドレスプロジェクトを起動用に準備するには、プロジェクトの構成要素がすべて正常に機能していることを確認する必要があります。

それには、コード、コンテンツ、設定をすべて 1 つにまとめ、ローカル開発環境でテストして運用開始準備を行う必要があります。

ローカル開発環境は、次の 3 つの主な領域で構成されます。

  1. AEMプロジェクト — このプロジェクトには、AEM開発者が作業するすべてのカスタムコード、設定およびコンテンツが含まれています
  2. Local AEM Runtime - AEMプロジェクトからコードをデプロイする際に使用される、AEMオーサーサービスおよびパブリッシュサービスのローカルバージョン。
  3. ローカル Dispatcher ランタイム - Dispatcher モジュールを含んだ Apache httpd Web サーバーのローカルバージョン。

ローカル開発環境をセットアップしたら、静的な Node サーバーをローカルにデプロイすることで、React アプリに対するコンテンツ提供をシミュレートできます。

次のステップ

これで、ここでの AEM ヘッドレスデベロッパージャーニーは完了です。次ができるようになったはずです。

  • AEM 開発ツールの詳細
  • ローカル開発ワークフローについて

次にドキュメントを確認して、AEMヘッドレスジャーニーを続行する ヘッドレスアプリケーションの運用開始方法 AEMヘッドレスプロジェクトを実際に運用する場所

その他のリソース

このページ