OAuth 認証を使用したマイクロサービスベースの公開の設定
パブリッシングマイクロサービスを使用すると、大規模なパブリッシングワークロードをas a Cloud ServiceのExperience Managerガイドで同時に実行し、業界をリードするAdobe I/O Runtime サーバーレスプラットフォームを活用できます。
公開リクエストごとに、Experience Managerガイドas a Cloud Serviceは、ユーザーリクエストに応じて水平方向に拡大・縮小する個別のコンテナを実行します。 これにより、複数の公開リクエストを実行し、大規模なオンプレミス Adobe Experience Manager サーバーよりも高いパフォーマンスを得ることができます。
Cloud Publishing Service はAdobe IMSの OAuth ベースの認証で保護されているので、次の手順を実行して環境をAdobeのセキュアトークンベースの認証ワークフローと統合し、クラウドベースのスケーラブルな公開ソリューションの使用を開始します。
Adobe Developer コンソールでの IMS 設定の作成
設定の作成に必要な役割: システム管理者
で IMS 設定を作成するには、次の手順を実行します Adobe Developer コンソール:
-
開く Developer Console:
https://developer.adobe.com/console
. -
に切り替え プロジェクト 上部から Tab キーを押します。
{width="500"}
「」を選択します プロジェクト タブ Adobe Developer コンソール
-
新しい空のプロジェクトを作成するには、を選択します。 空のプロジェクト から 新規プロジェクトを作成 ドロップダウン。
{width="500"}
新しい空のプロジェクトを作成します。
-
を選択 API から プロジェクトに追加 ドロップダウンで、IO 管理 API をプロジェクトに追加します。
{width="300"}
ドロップダウンから API プロジェクトを選択します。
{width="500"}
I/O Management API をプロジェクトに追加します。
-
新しい OAuth 認証情報を作成し、保存します。
{width="500"}
API に OAuth 認証情報を設定します。
-
に戻る プロジェクト tab キーを押して選択 プロジェクトの概要 左側。
{width="500"}
新しいプロジェクトの基本を学びます。
-
「」をクリックします Download 上部のボタンをクリックして、サービス JSON をダウンロードします。
{width="500"}
JSON サービスの詳細をダウンロードします。
OAuth 認証の詳細を設定し、JSON サービスの詳細をダウンロードしました。 次の節で必要になるので、このファイルは手元に置いておいてください。
環境への IMS 設定の追加
既存の設定を更新
JWT (非推奨)を使用して公開するために、既にマイクロサービスを使用している場合は、次の手順を実行して設定を更新します。
-
開く Experience Manager 設定する環境が含まれているプログラムを選択します。
-
に切り替え 環境 タブ。
-
設定する環境の名前を選択します。 これで、 環境情報 ページ。
-
に切り替え 設定 タブ。
-
SERVICE_ACCOUNT_DETAILS JSON フィールドを、ダウンロードした新しい OAuth JSON ファイルで更新します。
-
PRIVATE_KEY フィールドを削除します。
{width="500"}
既存の JWT 環境設定を更新します。
初回設定
パブリッシングマイクロサービスを初めて使用するには、次の手順に従って設定を更新します。
-
開く Experience Manager 設定する環境が含まれているプログラムを選択します。
-
に切り替え 環境 タブ。
-
設定する環境の名前を選択します。 これで、 環境情報 ページ。
-
に切り替え 設定 タブ。
-
SERVICE_ACCOUNT_DETAILS JSON フィールドを更新します。 次のスクリーンショットで示したのと同じ名前と設定を使用していることを確認してください。
{width="500"}
環境を初めて設定します。
マイクロサービスベースの公開を初めて使用
IMS 設定を環境に追加したら、次の手順を実行して、OSGi を使用してこれらのプロパティをExperience Managerガイドにリンクします。
-
Cloud Manager Git プロジェクトコードで、次の 2 つのファイル(ファイルの内容は「」を表示)を追加します。 付録)に設定します。
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
-
新しく追加したファイルがによってカバーされていることを確認します。
filter.xml
. -
Git の変更をコミットし、プッシュします。
-
パイプラインを実行して、変更を環境に適用します。
この操作が完了したら、microservice ベースのクラウドパブリッシングを使用できます。
FAQ
- マイクロサービスを使用する OSGi 設定が有効になっている場合、公開プロセスは同じコードベースのローカルExperience Managerサーバーで動作しますか?
- いいえ(フラグの場合)
dxml.use.publish.microservice
はに設定されています。true
は、常にマイクロサービス設定を探します。 を設定dxml.use.publish.microservice
対象:false
公開をローカルサーバーで機能させるために
- いいえ(フラグの場合)
- マイクロサービスベースのパブリッシングを使用する場合、DITA プロセスに割り当てられるメモリの量 これは DITA プロファイルとパラメータによって駆動されますか?
- マイクロサービスベースのパブリッシングでは、メモリ割り当ては DITA プロファイルとパラメーターによって実行されません。 サービスコンテナで使用可能なメモリの合計は 8 GB で、そのうち 6 GB が DITA-OT プロセスに割り当てられます。
付録 appendix
ファイル:com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
コンテンツ:
{
"service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
}
ファイル: com.adobe.fmdita.publishworkflow.PublishWorkflowConfigurationService.xml
コンテンツ:
dxml.use.publish.microservice
:DITA-OT を使用したマイクロサービスベースの公開を有効にするように切り替えますdxml.use.publish.microservice.native.pdf
:マイクロサービスベースのネイティブPDF公開を有効にするように切り替えます
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
jcr:primaryType="sling:OsgiConfig"
dxml.publish.microservice.url="https://adobeioruntime.net/api/v1/web/543112-guidespublisher/default/publishercaller.json"
dxml.use.publish.microservice="{Boolean}true"
dxml.use.publish.microservice.native.pdf="{Boolean}true"
/>