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이 발생합니다.
브라우저의 쿠키와 애플리케이션 상태(로컬 저장소)를 지우고 AEM Developer Console에 다시 로그인하십시오.
AEM Developer Console 액세스 문제 해결
로그인할 때 찾고 있는 환경이 표시되지 않습니다.
다음을 확인하십시오.
+ Cloud Manager을 통해 선택한 환경에 대한 세 점을 클릭하여 올바른 AEM Developer Console URL을 선택하고 AEM Developer Console 를 선택합니다.
+ Cloud Manager 제품의 개발자 - Cloud Service 제품 프로필을 통해 전체 환경 목록을 확인하거나, 찾을 수 없는 환경에 대해 AEM 작성자🔗의 AEM 관리자 제품 프로필에 속해 있습니다.
401 상태를 덤프할 때 승인되지 않은 오류 발생
승인되지 않은 문제를 해결하려면:
- 사용자가 AEM Developer Console의 관련 AEM as a Cloud Service 제품 인스턴스에 적절한 Adobe IMS 제품 프로필(AEM 관리자 또는 AEM 사용자)의 멤버인지 확인합니다.
+ AEM Developer Console은 2개의 Adobe IMS 제품 인스턴스, AEM as a Cloud Service 작성자 및 게시 제품 인스턴스에 액세스하므로 AEM Developer Console을 통해 액세스해야 하는 서비스 계층에 따라 올바른 제품 프로필이 사용되는지 확인하십시오. - Adobe IMS 제품 프로필 멤버십이 AEM as a Cloud Service에 동기화될 때까지 최대 30분 정도 기다립니다.
- AEM as a Cloud Service(작성자 또는 게시)에 로그인하고 사용자 및 그룹이 AEM에 제대로 동기화되었는지 확인합니다.
+ AEM Developer Console을 사용하려면 해당 서비스 계층에 사용자 레코드를 인증해야 합니다. - 브라우저 쿠키와 애플리케이션 상태(로컬 저장소)를 지우고 AEM Developer Console에 다시 로그인하여 AEM Developer Console이 사용 중인 액세스 토큰이 올바르고 만료되지 않았는지 확인합니다.
IP 제한 사항 ip-restrictions
Developer Console에 대한 액세스 권한은 작성자 인스턴스에 도달하는 기능에 따라 다릅니다. 조직에서 Cloud Manager의 작성자 서비스에 IP 허용 목록에 추가하다를 구성한 경우 허용된 범위 내의 IP 주소에서 연결해야 합니다.
예를 들어 작성자 인스턴스가 회사 VPN으로 제한된 경우 해당 VPN에 연결되어 있는 동안에만 Developer Console을 사용할 수 있습니다.
Developer Console으로 이동
Developer Console은 Cloud Manager을 통해 AEM as a Cloud Service 환경별로 액세스됩니다.
- Cloud Manager(으)로 이동
- AEM as a Cloud Service 환경이 포함된 Program을 열어 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에서 새 환경을 사용할 수 있으려면 아직 몇 분이 걸릴 수 있습니다.
상태 표시등은 환경의 상태를 나타냅니다.
- 빨간색: 환경이 정상이 아니고 사용할 수 없음을 나타냅니다(최대 절전 모드일 수 있음).
- 주황: 환경이 다시 시작되거나 성능이 저하될 수 있습니다(일부 Pod가 일시적으로 중단되었지만 아직 사용 가능한 건강한 Pod가 있음).
- 녹색: 실행, 모든 포드 작동 및 건강
환경을 선택하면 탭을 사용하여 AEM Developer Console의 다양한 보기로 이동할 수 있습니다.
환경의 각 계층 상태를 확인할 수 있습니다.
OSGi 번들
- 선택한 환경 유형에 배포되는 OSGI 번들에 대한 개요입니다. 전체 텍스트 검색이 가능합니다.
- 환경의 실제 번들 상태 정보를 가져오는 것이 유용합니다. 내보낸 패키지, 가져온 패키지, 사용된 서비스 등과 같은 정보를 가져올 수 있습니다.
- 개발자는 실제 환경에서 번들이 예상대로 작동하는지 확인하려고 합니다.
- 예제 사용 사례: 종속 항목의 버전 범위가 번들에 지정되어 있습니다. 종속성에서 문제가 발생합니다. 번들에 연결할 종속 항목의 버전을 확인하려고 합니다. 확인하려면 번들 세부 정보로 이동하고 번들/패키지 가져오기를 사용하여 런타임 시 사용 중인 번들 버전 또는 패키지 버전을 확인합니다. 이 정보를 사용하여 Maven 종속성 버전 범위를 조정하거나 코드를 조정할 수 있습니다.
검색하려면 검색 창을 사용하십시오. 번들 목록을 json으로 다운로드하려면 오른쪽 상단에 있는 목록 다운로드 버튼을 클릭하여 전체 JSON 덤프를 가져옵니다.
게시 또는 미리보기 덤프를 가져오려면 환경 선택기를 사용하여 게시 또는 미리보기 환경을 선택한 다음 목록을 다운로드할 수 있습니다.
Java 패키지
Java 패키지는 해결되지 않은 가져오기 또는 스크립트(HTL, JSP 등)의 해결되지 않은 클래스로 인해 번들이 시작되지 않는 문제를 해결하는 데 사용됩니다. Java Packages에서 어떤 번들도 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 Services는 다음을 통해 디버깅에 도움이 됩니다.
+ 제공 OSGi 번들 및 이를 사용하는 모든 OSGi 번들과 함께 AEM의 모든 OSGi 서비스 나열
OSGi 구성 요소 osgi-components
개발 콘솔 UI의
구성 요소는 다음을 통해 디버깅에 도움이 됩니다.
+ AEM as a Cloud Service에 배포된 모든 OSGi 구성 요소 나열
+ 각 OSGi 구성 요소의 상태 제공(활성 또는 미충족 여부 포함)
+ 충족되지 않은 서비스 참조에 세부 정보를 제공하면 OSGi 구성 요소가 활성화될 수 있습니다
+ OSGi 구성 요소에 바인딩된 OSGi 속성 및 해당 값 나열.
+ OSGi 환경 구성 변수를 통해 삽입된 실제 값을 표시합니다.
통합 integrations
- 시스템 관리자에게는 서비스 자격 증명과 개발자 토큰을 생성하고, 이름을 바꾸고, 삭제할 수 있는 기능이 있습니다.
- 이에 대한 자세한 내용은 서버측 API에 대한 액세스 토큰 생성에서 확인할 수 있습니다.
저장소 repository
- 저장소 브라우저를 엽니다.
- 참고: 저장소 브라우저에 액세스하려면 AEM 서비스에 로그인할 수 있어야 합니다. 로그인할 수 없는 경우 시스템 관리자에게 문의하여 액세스 권한을 받으십시오.
- 액세스하려는 계층에서 액세스 권한이 필요합니다. 예를 들어 게시 계층에서 저장소 브라우저에 액세스하려면 게시 계층에서 액세스 권한(AEM 관리자 또는 AEM 사용자)이 부여되어야 합니다.
상태 덤프/쿼리 status-dumps-queries
- 번들, 패키지, 구성, 서비스, 구성 요소, 슬링 작업 또는 Oak 정의의 현재 상태에 대한 전체 텍스트 또는 JSON 덤프입니다.
- 특히 개발자가 예기치 않은 상태를 발견하여 다른 개발자에게 전달하거나 문서화하려는 경우에 유용합니다. 덤프를 다운로드하면 나중에 참조할 수 있도록 상태의 스냅샷이 제공됩니다.
Sling 작업
슬링 작업은 모든 슬링 작업 대기열을 나열합니다.
Sling 작업 도움말 디버깅 방법:
+ Sling 작업 큐 및 구성 목록
+ 활성, 큐에 있음 및 처리된 Sling 작업의 수에 대한 통찰력을 제공합니다. 이는 AEM의 Sling 작업에서 수행되는 워크플로우, 임시 워크플로우 및 기타 작업과 관련된 문제를 디버깅하는 데 유용합니다.
Oak 정의
Oak 인덱스는 /oak:index 아래에 정의된 노드 덤프를 제공합니다. AEM 색인을 수정할 때 발생하는 병합된 색인은 표시되지 않습니다.
Oak 색인은 다음을 통해 디버깅에 도움이 됩니다.
+ AEM에서 검색 쿼리가 실행되는 방식에 대한 통찰력을 제공하는 모든 Oak 색인 정의를 나열합니다. AEM 색인으로 수정된 사항은 여기에 반영되지 않습니다. 이 보기는 AEM에서 단독으로 제공하거나 사용자 지정 코드에서 단독으로 제공하는 인덱스에만 유용합니다.
쿼리 성능 도구
- 쿼리는 AEM에서 검색 쿼리가 실행되는 내용과 방법에 대한 통찰력을 제공하는 데 도움이 됩니다.
- 쿼리는 특정 pod를 선택한 경우에만 작동합니다. 해당 pod의 쿼리 성능 웹 콘솔이 열리면 개발자가 AEM 서비스에 로그인할 수 있는 액세스 권한을 보유해야 합니다.
쿼리는 다음을 통해 디버깅에 도움이 됩니다.
+ Oak에서 쿼리를 해석, 분석 및 실행하는 방법에 대해 설명합니다. 이는 쿼리가 느린 이유를 추적하고 쿼리의 속도를 높이는 방법을 이해할 때 매우 중요합니다.
+ 설명 기능과 함께 AEM에서 실행되는 가장 인기 있는 쿼리를 나열합니다.
+ 설명 기능과 함께 AEM에서 실행 중인 가장 느린 쿼리를 나열합니다.
여기에서 추가 설명서를 찾을 수 있습니다.