AEM as a Cloud Service Developer Console developer-console

AEM as a Cloud Service Developer Console包含一組唯讀工具,可用於偵錯雲端環境。 可透過Cloud Manager中的每個環境連結存取該區域,並提供功能來檢視套件組合、OSGi設定、服務和servlet等。

NOTE
TIP
Developer Console是唯讀的。 如果您使用SDK進行本機開發,並且需要修改OSGi設定或存放庫內容,您可以使用:

AEM Developer Console存取權

若要存取及使用AEM Developer Console,必須透過Adobe的Adobe ID將下列許可權授予開發人員的Admin Console。

  1. 確保Adobe組織切換器中的,您可以看到與您要在Adobe Developer Console中檢查的環境相關的AEM組織。
  2. 為了能夠登入AEM Developer Console,開發人員必須是以下任何角色的成員:
    ​+ Cloud Manager產品的​ 開發人員 — Cloud Service ​產品設定檔:在此情況下,開發人員將看到所選AEM Developer Console URL下可用的完整環境清單;如果已在Cloud Manager中選取開發環境或RDE,則可能會顯示相同程式中的其他開發環境或RDE。
    ​+ AEM管理員 AEM作者上的產品設定檔:在此情況下,上一個專案符號中說明的環境清單將限於指派此角色的相關產品設定檔。
  3. 開發人員必須是AEM作者和/或發佈🔗上的​ AEM使用者 ​或​ AEM管理員 ​產品設定檔的成員。
    ​+ 如果此成員資格不存在,狀態傾印將逾時,並出現401未授權錯誤。
NOTE
有時候,Adobe IMS產品設定檔成員資格最多可能需要30分鐘,才能同步至AEM as a Cloud Service。 如果您無法存取AEM Developer Console,請等待30分鐘,然後再試一次。
請清除瀏覽器的Cookie以及應用程式狀態(本機儲存),然後重新登入AEM Developer Console

疑難排解AEM Developer Console存取問題

當我登入時,我沒有看到我正在尋找的環境清單

請確認下列事項:

​+ 您已透過Cloud Manager針對選取的環境按一下三個點,並選取AEM Developer Console ,以選取正確的AEM Developer Console URL。
​+ 您擁有Cloud Manager產品的​ 開發人員 — Cloud Service ​產品設定檔以檢視完整的環境清單,或者您是找不到環境之​AEM作者🔗上的​ AEM管理員 ​產品設定檔的一部分。

401傾印狀態時發生未獲授權的錯誤

AEM Developer Console - 401未獲授權

若要解決未授權的問題:

  1. 確保您的使用者是AEM Developer Console相關聯AEM產品執行個體的適當Adobe IMS產品設定檔成員(AEM管理員或AEM as a Cloud Service使用者)。
    ​+ 請記住,AEM Developer Console存取2個Adobe IMS產品執行個體;AEM as a Cloud Service製作和發佈產品執行個體,因此請確保根據需要透過AEM Developer Console存取的服務層級使用正確的產品設定檔。
  2. 請等候最多30分鐘,讓Adobe IMS產品設定檔成員資格同步至AEM as a Cloud Service。
  3. 登入AEM as a Cloud Service (製作或發佈),並確保您的使用者和群組已正確同步至AEM。
    ​+ AEM Developer Console要求您在對應的AEM服務層級中建立使用者記錄,以便對該服務層級進行驗證。
  4. 清除您的瀏覽器Cookie以及應用程式狀態(本機儲存)並重新登入AEM Developer Console,確保AEM Developer Console所使用的存取權杖正確且未過期。

IP限制 ip-restrictions

能否存取Developer Console取決於您存取作者執行個體的能力。 如果您的組織已在Cloud Manager中的作者服務上設定IP允許清單,則您必須從該允許範圍內的IP位址連線。

例如,如果製作執行個體限制在您的公司VPN中,您只能在連線至該VPN時使用Developer Console。

導覽至Developer Console

透過Cloud Manager在每個AEM as a Cloud Service環境中存取Developer Console。

導覽至Developer Console

  1. 導覽至​Cloud Manager
  2. 開啟包含AEM as a Cloud Service環境的​ 方案 ​以開啟Developer Console。
  3. 找到​環境,然後選取...
  4. 從下拉式清單中選取​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的左上角和右上角。
開發主控台中的新OSGi套件組合畫面

選取環境會觸發重新整理AEM Developer Console中的資料,而您將會看到所選環境的資料。
前往存放庫瀏覽器時,將使用選取的環境在新的索引標籤中開啟存放庫瀏覽器。

選擇器旁邊的重新整理按鈕觸發瀏覽器快取,以清除對cloud manager的程式/環境呼叫。
如果已建立新環境,但在環境清單中看不到,則可以使用此項。
新環境仍可能需要幾分鐘才能在AEM Developer Console中使用。

狀態指示燈表示環境的健康狀態。

  1. 紅色:表示環境不健康且無法使用(可能處於休眠狀態)。
  2. 橙色:環境可能正在重新啟動或降級(部分pod暫時關閉,但仍有健康的pod可用)。
  3. 綠色:運作中,所有pod運作正常

選取環境後,您可以使用標籤導覽至AEM Developer Console的不同檢視。

NOTE
請注意,與舊版AEM開發人員控制檯不同,我們不會再公開個別pod狀態。
您可以檢視環境每一層的狀態。

OSGi組合

開發主控台中的新OSGi套件組合畫面

  • 所選環境型別中部署的OSGI套件組合概觀。 它可啟用全文檢索搜尋。
  • 取得環境中套件組合的實際狀態資訊會很有用。 您可以取得資訊,例如,匯出的套件、匯入的套件、使用的服務等。
  • 開發人員想要在實際環境中驗證,並檢查套件組合是否確實如預期般運作。
  • 範例使用案例:​已在您的套件組合中指定相依性的版本範圍。 相依性發生錯誤。 您想要檢查要連線至您的套件組合中的相依性版本。 若要檢查,請移至套件組合詳細資料,並使用匯入套件/套件來檢查執行階段正在使用的套件組合版本或套件版本。 有了這些資訊,您可以調整您的maven相依性版本範圍或調整您的程式碼。

若要搜尋,請使用搜尋列。 若要將套件組合清單下載為JSON,請按一下右上角的「下載清單」按鈕,以取得完整的JSON傾印。
如果您想要取得發佈或預覽傾印,您可以使用環境選擇器來選取發佈或預覽環境,然後下載清單。

Java套件

開發主控台UI中的 Java套件索引標籤

Java Packages用於疑難排解由於未解析的匯入或指令碼(HTL、JSP等)中的未解析類別而未啟動的套件組合。 如果Java套件報告沒有套件組合匯出Java套件(或版本不符合OSGi套件組合匯入的版本):

​+ 確保您專案的AEM API Maven相依性版本與環境的AEM版本相符(如果可能,請將所有內容更新到最新版本)。
​+ 如果在Maven專案中使用額外的Maven相依性
​+ 決定是否可改用AEM SDK API相依性提供的替代API。
​+ 如果需要額外的相依性,請確保提供它作為OSGi套件(而不是純Jar),並且它內嵌在您的專案的程式碼套件(ui.apps)中,類似於核心OSGi套件內嵌在ui.apps套件中的方式。

按一下套件會前往套件詳細資料:

開發主控台UI中的 Java套件索引標籤

設定 configurations

Dev Console UI中的 組態標籤

  • 可在環境中啟用的設定清單。 您可以透過檢視詳細資訊頁面來檢視組態所提供的屬性。
  • 使用案例範例:​開發人員想要確定他們指定的設定確實存在於環境中。 如果缺少組態,他們可以檢查特徵模型或組態執行模式或資料夾。

如需設定使用者許可權的詳細資訊,請參閱Cloud Manager檔案

Servlet servlets

開發主控台UI中的 Servlet索引標籤

  • 搜尋提示,您可以在其中指定帶有選取器的路徑以及帶有GET或POST的副檔名。 然後會依優先順序提供servlet的結果,以處理Sling中的請求。
  • 範例使用案例:​您有OSGI servlet,應該根據要求啟動,並將輸出列印到回應。 然而,回應會傳回空白,而不是預期的輸出。 您需要檢查由於更具體的選擇器、resourceType、擴充功能或排名,是否有其他servlet優先於您的servlet。 您可以搜尋預期的路徑,並找出另一個排名較高且作用中的servlet。 然後,您可以決定是否要新增選取器,讓您的servlet在排名中名列前茅。

服務 services

Dev Console UI中的 Services標籤

元件會列出所有OSGi服務。

OSGi Services偵錯說明,依據:

​+ 列出AEM中的所有OSGi服務,以及其提供的OSGi套件組合,以及使用該套件的所有OSGi套件組合

OSGi元件 osgi-components

Dev Console UI中的 OSGi元件索引標籤

元件可協助您透過下列方式執行偵錯:

​+ 列出部署至AEM as a Cloud Service的所有OSGi元件
​+ 提供每個OSGi元件的狀態;包括元件是作用中還是不滿意
​+ 將詳細資訊提供給不滿意的服務參考可能會導致OSGi元件變成作用中
​+ 列出繫結至OSGi元件的OSGi屬性及其值。
​+ 這會顯示透過OSGi環境設定變數插入的實際值。

整合 integrations

存放庫 repository

  • 開啟存放庫瀏覽器
  • 注意:您必須能登入AEM服務才能存取存放庫瀏覽器。 如果您無法登入,請聯絡您的系統管理員以取得存取權。
  • 您需要授與您嘗試存取之階層的存取權。 例如,如果您嘗試存取發佈層上的存放庫瀏覽器,您需要擁有發佈層上的存取權(AEM管理員或AEM使用者)。

狀態傾印/查詢 status-dumps-queries

開發主控台UI中的狀態傾印/查詢索引標籤

  • 套件、套件、設定、服務、元件、Sling作業或Oak定義之目前狀態的全文或JSON傾印。
  • 如果開發人員發現一些非預期的狀態,並想要與其他開發人員通訊或記錄此狀態,這個方法就特別有用。 下載傾印會提供狀態的快照,以供您稍後參考。

Sling 工作

Sling作業會列出所有Sling作業佇列。

Sling Jobs可協助您依照以下方式偵錯:

​+ Sling工作佇列及其設定的清單
​+ 提供對作用中、已佇列和已處理Sling工作數量的深入分析,這有助於偵錯工作流程、暫時性工作流程和AEM中Sling工作執行的其他工作的問題。

Oak定義

Oak索引提供/oak:index下定義的節點傾印。 請記住,這不會顯示合併的索引,這在修改AEM索引時發生。

Oak索引可協助您透過以下方式偵錯:

​+ 列出所有Oak索引定義,深入分析搜尋查詢在AEM中的執行方式。 請記住,修改為AEM索引的內容不會反映在此處。 此檢視僅對由AEM單獨提供,或僅由自訂程式碼提供的索引有幫助。

查詢效能工具

  • 查詢有助於提供在AEM上執行搜尋查詢的內容及方式的深入分析。
  • 只有在選取特定pod時,查詢才能運作,因為它會開啟該pod的查詢效能Web主控台,要求開發人員具有登入AEM服務的存取權。

查詢可透過以下方式協助偵錯:

​+ 說明Oak如何解譯、分析和執行查詢。 在追蹤查詢緩慢的原因以及瞭解如何加快查詢速度時,這一點非常重要。
​+ 列出在AEM中執行的最受歡迎查詢,並可加以說明。
​+ 列出AEM中執行速度最慢的查詢,並可加以說明。

更多檔案可在這裡找到。

recommendation-more-help
experience-manager-cloud-service-help-main-toc