フロントエンドパイプラインを有効にする :headding-anchor:enable-front-end-pipeline

サイトテーマを使用してサイトをより迅速にカスタマイズできるように、既存のサイトのフロントエンドパイプラインを有効にする方法について説明します。

概要 :headding-anchor:overview

フロントエンドパイプラインは、サイトテーマサイトテンプレートに基づいて web サイトのフロントエンドコードだけを迅速にデプロイできるメカニズムです。

このパイプラインはフロントエンドコードのみを処理するので、フルスタックデプロイメントよりデプロイメントプロセスが高速になります。これにより、フロントエンド開発者は AEM の知識がなくても、サイトを簡単にカスタマイズできます。

サイトテンプレートに基づくサイトでは、フロントエンドパイプラインをデフォルトで使用できます。このドキュメントでは、フロントエンドパイプラインを利用するように既存のサイトを適応させる方法について説明します。

TIP
フロントエンドパイプラインにも、フロントエンドパイプラインとサイトテンプレートを使用してサイトを迅速にデプロイする方法にも詳しくない場合は、クイックサイト作成ジャーニーで概要を確認してください。

AEM では、サイトがサイトテンプレートとテーマを使用して作成されていない場合でも、既存のクライアントライブラリの上にテーマをレイヤー化することで、フロントエンドパイプラインでデプロイされたテーマを読み込むようにサイトを設定できます。

技術的詳細 :headding-anchor:technical-details

サイトのフロントエンドパイプラインを有効にすると、AEM はサイト構造に次のような変更を加えます。

  • サイトのすべてのページには、追加の CSS および JS ファイルが 1 つ含まれており、専用の Cloud Manager フロントエンドパイプラインを通じて更新をデプロイすることで、このファイルを変更できます。
  • 追加された CSS および JS ファイルは最初は空です。ただし、「テーマソース」フォルダーをダウンロードすると、パイプラインを通じて CSS コードと JS コードの更新をデプロイするために必要なフォルダー構造を設定できます。
  • この操作によって /conf/<site-name>/sling:configs の下に作成される SiteConfig ノードと HtmlPageItemsConfig ノードを削除することで、変更を取り消すことができるのは、開発者のみです。
NOTE
このアクションによって、フロントエンドパイプラインを使用するようにサイトの既存のクライアントライブラリが自動的に変換されることはありません。これらのソースをクライアントライブラリフォルダーからフロントエンドパイプラインフォルダーに移動するには、フロントエンド開発者が手動で行う必要があります。

要件 :headding-anchor:requirements

AEM では、フロントエンドパイプラインを使用するように既存のサイトを自動的に適応させることができます。このワークフローを実行するには、サイトでコアコンポーネントのページコンポーネント v2 以降を使用する必要があります。

フロントエンドパイプラインの有効化 :headding-anchor:enabling

IMPORTANT
フロントエンドパイプラインを使用してサイトを開発する場合や、使用する予定がある場合は、事前に Cloud Manager IP 許可リストを追加する必要があります。
詳しくは、フロントエンドパイプラインでの Cloud Manager IP 許可リストの使用を参照してください。

サイトを有効にするには、Sites コンソールのサイトパネルを使用して行います。

  1. AEM にログインし、グローバルナビゲーションサイト ​を使用して Sites コンソールに移動します。

  2. サイトをコンソールで選択します。サイトの子ページではなくルートを選択します。

  3. サイトが選択された状態で、左側のパネルセレクターを開き、「サイト」を選択します。

  4. サイト ​パネルで「フロントエンドパイプラインを有効化」ボタンをクリックします。

    フロントエンドパイプラインの有効化

  5. 実行される変更の概要が表示され、AEM から確認を求められます。確認すると、サイトに適応されます。

これで、サイトでフロントエンドパイプラインを使用する準備が整いました。フロントエンドパイプラインとサイトテーマの管理について詳しくは、以下を参照してください。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab