AEM as a Cloud Service Developer Console developer-console
AEM as a Cloud Service Developer Consoleには、クラウド環境のデバッグ用の読み取り専用ツールのセットが含まれています。 Cloud Managerの環境ごとのリンクからアクセスでき、バンドル、OSGi設定、サービス、サーブレットなどを表示する機能を提供しています。
- AEM Developer Console(Cloud Service)は、同様の名前のAdobe Developer Console.と混同しないでください
AEM Developer Consoleへのアクセス
AEM Developer Consoleにアクセスして使用するには、AdobeとAdmin Consoleを介して、開発者のAdobe IDに次の権限を付与する必要があります。
- Adobe組織スイッチャーで、AEM Developer Consoleで調べたい環境に関連するAdobe組織を確認できることを確認します。
- AEM Developer Consoleにログインするには、開発者が次のいずれかのロールのメンバーである必要があります。
+ Cloud Manager製品の 開発者 – Cloud Service 製品プロファイル :この場合、選択したAEM Developer Console URLで使用可能な環境の完全なリストが表示されます。Cloud Managerで開発環境またはRDEが選択されている場合、同じプログラム内の他の開発環境またはRDEが表示される場合があります。
+ AEM 管理者 AEM オーサーの製品プロファイル:この場合、前の箇条書きで説明した環境のリストは、この役割が割り当てられている関連製品プロファイルに限定されます。 - 開発者は、AEM オーサーまたはパブリッシュの AEM ユーザーまたは AEM 管理者製品プロファイルのメンバーであることが必要です。
+ このメンバーシップが存在しない場合、 ステータスダンプは 401 Unauthorized エラーでタイムアウトします。
ブラウザーのCookieとアプリケーションの状態(ローカルストレージ)を消去し、AEM Developer Consoleに再度ログインしてください
AEM Developer Consoleへのアクセスのトラブルシューティング
ログインしても、探している環境がリストに表示されません
以下を確認してください。
+ Cloud Managerを使用して、選択した環境の3つのドットをクリックし、「AEM Developer Console」を選択して、正しいAEM Developer Console URLを選択しました。
+ 環境の完全なリストを表示するには Cloud Manager 製品の開発者 - Cloud Service 製品プロファイル、見つからない環境については AEM オーサーの AEM 管理者製品プロファイルのいずれかを持っている。
ステータスのダンピング時の 401 Unauthorized エラー
不正な問題を解決するには:
- ユーザーが、AEM Developer Consoleの関連するAEM製品インスタンスの適切なAdobe IMS製品プロファイル(AEM管理者またはAEM as a Cloud Service ユーザー)のメンバーであることを確認します。
+ AEM Developer Consoleは、AEM Developer Console経由でアクセスする必要があるサービス層に応じて、AEM as a Cloud Service オーサーとパブリッシュの2つのAdobe IMS製品インスタンスにアクセスできるので、正しい製品プロファイルが使用されていることを確認してください。 - Adobe IMS製品プロファイルメンバーシップがAEM as a Cloud Serviceに同期されるまで、最大30分待ちます。
- AEM as a Cloud Service(オーサーまたはパブリッシュ)にログインし、ユーザーとグループが AEM に正しく同期されていることを確認します。
+ AEM Developer Consoleでは、対応するAEM サービス層でユーザーレコードを作成し、そのサービス層に対して認証する必要があります。 - ブラウザーのCookieとアプリケーションの状態(ローカルストレージ)を消去し、AEM Developer Consoleに再ログインして、AEM Developer Consoleが使用しているアクセストークンが正しく期限切れになっていることを確認します。
IPの制限 ip-restrictions
Developer Consoleへのアクセスは、オーサーインスタンスにアクセスできるかどうかによって異なります。 組織がCloud ManagerのオーサーサービスにIP許可リストを設定している場合は、許可された範囲内のIP アドレスから接続する必要があります。
例えば、オーサーインスタンスが自社のVPNに制限されている場合、そのVPNに接続している間のみDeveloper Consoleを使用できます。
Developer Console に移動します。
Developer Console には、AEM as a Cloud Service 環境ごとに、Cloud Manager を介してアクセスします。
- Cloud Manager に移動します。
- AEM as a Cloud Service 環境を含んだ プログラム を開いて、Developer Console を開きます。
- 環境を見つけて、「
...」を選択します。 - ドロップダウンリストから、「Developer Console」を選択します。
または、次のURLを開いてログインしてください:https://experience.adobe.com/skyline-console
または、Cloud Manager CLIから次のコマンドを使用します。
aio cloudmanager:open-developer-console <ENVIRONMENTID> --programId <PROGRAMID>
環境/プログラムセレクター
AEM Developer Consoleを使用するには、検査する環境とプログラムを選択する必要があります。
セレクターは、AEM Developer Console UIの左上隅および右上隅にあります。
環境を選択すると、AEM Developer Consoleのデータの更新がトリガーされ、選択した環境のデータが表示されます。
リポジトリブラウザーに移動すると、選択した環境を使用して、新しいタブでリポジトリブラウザーを開きます。
セレクターの横にある更新ボタンをクリックすると、Cloud Managerに対するプログラムや環境の呼び出しに対してブラウザーのキャッシュがクリアされるトリガーが表示されます。
新しい環境が作成され、環境のリストに表示されない場合は、これを使用できます。
新しい環境がAEM Developer Consoleで利用できるようになるまでに、まだ数分かかる場合があります。
ステータスライトは環境の健全性を示します。
- 赤:環境が正常ではなく、利用できない(休止状態の可能性があります)ことを示します。
- オレンジ:環境が再起動または低下している可能性があります(一部のポッドは一時的に停止していますが、正常なポッドがまだ利用可能です)。
- グリーン:ランニング、すべてのポッドが起動し、正常に動作
環境を選択したら、タブを使用してAEM Developer Consoleの様々なビューに移動できます。
環境の各層のステータスを確認できます。
OSGi バンドル
- 選択した環境タイプにデプロイされている OSGI バンドルの概要。 全文検索が可能です。
- 環境内のバンドルの実際の状態に関する情報を取得するのに役立ちます。 書き出されたパッケージ、読み込まれたパッケージ、使用されたサービスなどの情報を取得できます。
- 開発者は、実際の環境で検証し、バンドルが期待どおりに動作するかどうかを確認したいと考えています。
- ユースケースの例:バンドル内で依存関係のバージョン範囲が指定されています。 依存関係に問題が発生しています。 バンドルに紐付けられている依存関係のバージョンを確認したいとします。 確認するには、バンドルの詳細に移動し、「バンドル/パッケージを読み込み」を使用して、実行時に使用されているバンドルバージョンまたはパッケージバージョンを確認します。 この情報を使用して、Maven 依存関係のバージョン範囲やコードを調整できます。
検索するには、検索バーを使用します。 バンドルのリストをjsonとしてダウンロードするには、右上の「リストをダウンロード」ボタンをクリックして、完全なJSON ダンプを取得します。
パブリッシュまたはプレビューダンプを取得する場合は、環境セレクターを使用してパブリッシュ環境またはプレビュー環境を選択し、リストをダウンロードできます。
Java パッケージ
Java パッケージを使用すると、未解決の読み込みやスクリプト(HTL や JSP など)内の未解決のクラスが原因でバンドルが起動されない問題をトラブルシューティングすることができます。 Java パッケージを書き出しているバンドルがないと「Java パッケージ」タブにレポートされる場合(またはバージョンが OSGi バンドルで読み込まれたバージョンと一致しない場合)は、以下の指示に従います。
+ プロジェクトの AEM API Maven 依存関係のバージョンが、環境の AEM リリースバージョンと一致することを確認します(また、可能な場合はすべてを最新のバージョンに更新します)。
+ Maven プロジェクトで追加の Maven 依存関係が使用されている場合は、以下の指示に従います。
+ AEM SDK API の依存関係で提供されている代替 API を代わりに使用できるかどうかを判断します。
+ 追加の依存関係が必要な場合は、それが(普通の Jar ではなく)OSGi バンドルとして提供されることと、コア OSGi バンドルを ui.apps パッケージに組み込む場合と同様の方法でプロジェクトのコードパッケージ(ui.apps)に組み込まれることを確認します。
パッケージをクリックすると、パッケージの詳細に移動します。
設定 configurations
- 環境内でアクティブな設定の検索可能なリスト。 詳細ページをチェックアウトすることで、設定で提供されるプロパティを確認できます。
- ユースケースの例:開発者は、指定した設定が環境に実際に存在するかどうかを確認したいと考えています。 設定が不足している場合は、機能モデル、設定の実行モードまたはフォルダーを確認できます。
ユーザー権限の設定について詳しくは、Cloud Manager のドキュメントを参照してください。
サーブレット servlets
- セレクターでパスを指定し、GET または POST で拡張子を指定できる検索プロンプト。 次に、Sling でリクエストを処理するサーブレットの結果を、優先順位に従って表示します。
- ユースケースの例:リクエストに応じてアクティブ化し、応答に出力を印刷する OSGi サーブレットがあります。 ただし、期待される出力ではなく、応答では空を返します。 より具体的なセレクター、
resourceType、拡張機能またはランキングにより、他のサーブレットが自分のサーブレットよりも優先されていないか確認する必要があります。 期待されるパスを検索すると、より高いランキングでアクティブになっている別のサーブレットが見つかります。 次に、セレクターを追加するなどして、自分のサーブレットを上位ランキングにできるかどうかを判断します。
サービス services
コンポーネントは、すべての OSGi サービスを一覧表示します。
「OSGi サービス」は、次の方法でデバッグに役立ちます。
+ AEM のすべての OSGi サービス、それぞれのサービスで提供される OSGi バンドルおよび使用されるすべての OSGi バンドルを一覧表示する
OSGi のコンポーネント osgi-components
「コンポーネント」は、次の方法でデバッグに役立ちます。
+ AEM as a Cloud Service にデプロイされているすべての OSGi コンポーネントを一覧表示する
+ アクティブか未解決かを含め、それぞれの OSGi コンポーネントの状態を提供する
+ OSGi コンポーネントがアクティブにならない原因となっている可能性のある未解決のサービス参照に関する詳細を提供する
+ OSGi コンポーネントにバインドされている OSGi プロパティとその値を一覧表示する。
+ これは、OSGi 環境設定変数を通じて挿入された実際の値を表示します。
統合 integrations
- システム管理者は、サービス資格情報および開発者トークンを生成、名前変更、削除する機能を備えています。
- これについて詳しくは、 サーバーサイド APIのアクセストークンの生成を参照してください。
リポジトリ repository
- リポジトリブラウザーを開きます。
- 注意:リポジトリブラウザーにアクセスするには、AEM サービスでログインできる必要があります。 ログインできない場合は、システム管理者に連絡してアクセス権を取得してください。
- アクセスしようとしている階層でアクセスが許可されている必要があります。 例えば、パブリッシュ層のリポジトリブラウザーにアクセスする場合は、パブリッシュ層でアクセス権(AEM AdministratorまたはAEM User)が付与されている必要があります。
ステータスダンプ/クエリ status-dumps-queries
- バンドル、パッケージ、設定、サービス、コンポーネント、Sling ジョブまたは Oak 定義の現在の状態の完全なテキストまたは JSON ダンプ。
- 特に、開発者が予期せぬ状態を発見し、その状態を他の開発者に通信したり、文書化したりしたい場合に役立ちます。 ダンプをダウンロードすることで、状態のスナップショットを取得し、後で参照できます。
Sling ジョブ
Sling ジョブには、すべての Sling ジョブキューが表示されます。
「Sling ジョブ」は、次の方法でデバッグに役立ちます。
+ Sling ジョブキューとその設定を一覧表示する
+ アクティブ、待機中および処理済みの Sling ジョブの数に関するインサイトを提供する(AEM の Sling ジョブで実行されるワークフロー、一時的なワークフローおよびその他の作業に関する問題のデバッグに役立ちます)。
Oak定義
Oak インデックスは、/oak:index 下に定義されたノードのダンプを提供します。 AEM インデックスが変更されたときに発生する結合インデックスは表示されないことに注意してください。
「Oak インデックス」は、次の方法でデバッグに役立ちます。
+ AEM での検索クエリの実行方法に関するインサイトを提供するすべての Oak インデックス定義を一覧表示する。 AEM インデックスに対する変更はここには反映されないことに注意してください。 このビューは、AEM でのみ提供されるインデックスまたはカスタムコードでのみ提供されるインデックスの場合にのみ役に立ちます。
クエリパフォーマンスツール
- 「クエリ」タブは、AEM での検索クエリの実行内容および方法に関するインサイトを提供します。
- 「クエリ」タブは、特定のポッドが選択されている場合にのみ機能します。これは、そのポッドのクエリパフォーマンス web コンソールを開くので、開発者が AEM サービスにログインするためのアクセス権を持っている必要があるからです。
「クエリ」タブは、次の方法でデバッグに役立ちます。
+ Oak によるクエリの解釈、分析および実行方法を説明する。 これは、クエリの処理速度が遅い理由を追跡し高速化する方法を理解するうえで非常に重要です。
+ AEM で実行中の最も一般的なクエリを一覧表示し、それらのクエリを説明する機能を提供する。
+ AEM で実行中の最も遅いクエリを一覧表示し、それらのクエリを説明する機能を提供する。
詳細なドキュメントについては、こちらを参照してください。