Experience Modernization Agentの概要 getting-started
Experience Modernization AgentとExperience Modernization Consoleの使用を開始するための最初の手順について説明します。
Edge Delivery GitHub リポジトリの準備 prepare-repo
-
Experience Modernization Consoleで使用するEdge Delivery Services リポジトリを選択します。
- これは、既存のEdge Delivery Services プロジェクトにすることも、開発者チュートリアル に従って、 ボイラープレートリポジトリを使用して新しいプロジェクトを作成することもできます。
-
AEM Code Connectorがリポジトリにインストールされていることを確認します。
- これにより、コンソールでコードを検査できます。
-
AEM Code Sync GitHub アプリ がリポジトリにインストールされていることを確認します。
- これにより、Edge Delivery Servicesでコードを同期できるようになります。
- リポジトリがチュートリアルに基づいている場合、この手順はすでに完了しています。
Experience Modernization Consoleを開きます open-console
aemcoder.adobe.io.に移動します- Adobe IDでログインします。
GitHub リポジトリへの接続 connect-repo
コンソールでは、初めてログインしたときにリポジトリの入力を求めるメッセージが表示されます。
- 「リポジトリを接続」をクリックします。
- これにより、新しいブラウザータブでAEM Code Connector アプリが開きます。 「AEM Code Connectorの認証」をクリックします。
- コンソールに戻り、サイトのプレビューURLを指定します。 プレビューURLは、サイト内の任意のドキュメントをプレビューするか、ブランチ、サイト名、組織から作成することで取得できます。 システムは関連するGithub プロジェクトを自動的に取得します。場合によっては、github座標を提供するように求められることもあります。
- 既存のワークスペースを置換するように求められた場合は、ワークスペースを置換をクリックします。
これでGitHub プロジェクトがコンソールに接続され、ホーム画面に表示されます。
プロンプトを開始 start-prompting
コンソールでコードにアクセスできるようになったので、プロンプトを開始する準備が整いました。
-
サイトのコンテンツを読み込むことができます。
- 「ページ
https://wknd-trendsetters.siteを移行します。」
- 「ページ
-
これにより、サイトのコンテンツがインポートされます。
- コンソールは、関心の分離を監視し、コンテンツとプレゼンテーションを個別に処理します。
- サイトのコンテンツを最初に読み込むのに、数分かかることがあります。
- コンソールは、作業を開始する際に、計画された手順の概要を含む継続的なフィードバックを表示します。
-
サイトが読み込まれると、Workspace パネルにページが表示されます。 ページを選択して、右側のパネルでプレビューします。
-
コンテンツが用意できたので、同じソースからスタイルを読み込むようにプロンプトを表示できます。
- 「一般スタイルを
https://wknd-trendsetters.siteから読み込む」
- 「一般スタイルを
-
最初のコンテンツの読み込みと同様に、読み込みには数分かかる場合があり、コンソールはリクエストを処理し、スタイルを読み込むときにフィードバックを提供します。 タスクが完了したら、右側のパネルで「プレビューを更新」をクリックして、スタイル設定されたコンテンツを表示します。
これで、コンテンツとスタイルの両方がコンソールに読み込まれました。
コンテンツのアップロード upload-content
コンテンツをDocument Authoringにアップロードするには:
-
コンテンツ ビューであることを確認し、右上の「コンテンツをアップロード」ボタンをクリックします。
- デフォルトでは、コンソールに入ると コンテンツ 表示になります。
- ビューは、コンソールの左側に沿ったサイドバーに強調表示されたアイコンで示されます。
-
コンテンツをアップロード ダイアログが開き、宛先の組織とリポジトリが
fstab.yamlから事前入力されています。- 接続されているリポジトリに
fstab.yamlが存在しない場合は、組織と リポジトリ を手動で入力する必要があります。 - ボイラープレートを使用した場合は、
fstab.yamlが提供されます。
- 接続されているリポジトリに
-
アップロードするファイルを選択し、アップロードをクリックします。
-
コンソールには、「アップロード」ボタンがグレー表示され、アップロードプロセスが示されます。
-
完了すると、コンソールの下部に通知が表示されます。
Document Authoringでアップロードされたコンテンツにアクセスするには、アップロード完了時に通知の AEMで表示 をクリックするか、https://da.live/#/{organization}/{repository}に移動します。
読み込んだコンテンツがドキュメントのオーサリングに追加されました。
プッシュコードの変更 push-code-changes
コードに加えた変更に満足したら、GitHub リポジトリにプッシュできます。
- コード ビュー(
</>アイコン、左側のサイドバー)に切り替え、次にGit Changes タブ(右上のブランチアイコン)に切り替えます。
- 変更されたファイルのリストで、一部のファイルがトラッキングされていない状態で表示される場合は、
+ボタンをクリックしてステージングします。 - 右上の「GitHub actions」ボタンをクリックし、ドロップダウンから「プッシュ」を選択します。
- 変更をプッシュ ダイアログで、変更を新しいPR (デフォルト)または現在のブランチにプッシュすることを選択し、確認をクリックしてプッシュします。
- 少しでも疑問を感じたら、現在のブランチにプッシュして、問題をスムーズに進めることができます。
- 完了すると、コンソールの下部に通知が表示されます。
を表示
GitHubのプッシュされた変更に直接アクセスする場合は、プッシュが完了したら、通知の「PRを表示」をクリックします。
GitHub
コードはGitHubにあります。
サイトをプレビュー preview-site
プレビュー環境で変更を表示するには:
-
ドキュメント作成に戻ります。
- コンテンツをアップロードした後、AEMで表示をクリックした後に開いたブラウザータブで、まだ開いている可能性があります。
- または
https://da.live/#/{organization}/{repository}に移動します
-
以前にAEMにアップロードしたページの1つを開きます。
-
紙面アイコン(右上)をクリックし、プレビューを選択します。
おめでとうございます。移行したコンテンツとスタイルは、AEM プレビュー環境で公開されます。
コードをmain以外のブランチにプッシュした場合、Document Authoringから開いたプレビューにはスタイルが表示されません。 プレビューのURLを更新してブランチに変更すると、スタイルを確認できます。
トラブルシューティング troubleshooting
・IP アドレスの許可リストに加える allowlist-ip-addresses
サイトがファイアウォールやアクセス制限の内側にある場合は、バックエンドサービスがサイトをスクレイピングできるように、次のIP アドレスを許可リストに加えるできます。
34.228.136.11254.90.51.393.224.194.242
その他のリソース additional-resources
Experience Modernization Agentとそのコンソールを引き続き検索する場合は、次のドキュメントが役立つ可能性があります。
- Experience Modernization Console - コンソールの詳細、ビュー、オプション、機能
- Experience Modernization Agentのプロンプトガイド - エージェントをプロンプトする方法とそのスキルの活用方法に関するアイデア
- Edge Delivery Services開発者向けチュートリアル - AEMおよびEdge Delivery Services プロジェクトを初めて使用する場合に役立ちます
- ドキュメント オーサリング - コンテンツ管理のドキュメント オーサリングを初めて使用する場合に役立ちます