AEM as a Cloud Service Developer Console (새 UI) developer-console

마지막 업데이트: 2026년 8월 27일

적용 대상:
Experience Manager as a Cloud Service

주제:
Developing

작성 대상:

Admin
Developer

AEM as a Cloud Service Developer Console에는 클라우드 환경을 디버깅하기 위한 읽기 전용 도구 세트가 포함되어 있습니다. Cloud Manager의 환경별 링크를 통해 액세스할 수 있으며 번들, OSGi 설정, 서비스 및 서블릿 등을 볼 수 있는 기능을 제공합니다.

NOTE

AEM as a Cloud Service Developer Console을 비슷한 이름의 Adobe Developer Console.과 혼동하면 안 됩니다.

TIP

Developer Console은 읽기 전용입니다. SDK을 사용하여 로컬 개발 작업을 수행하는 중에 OSGi 설정이나 저장소 콘텐츠를 수정해야 하는 경우 다음을 사용할 수 있습니다.

사전 요구 사항 prerequisites

Developer Console은 특정 프로그램에서 특정 역할을 가진 사용자만 액세스할 수 있습니다.

프로덕션 프로그램의 경우 Adobe Admin Console의 "Cloud Manager - 개발자 역할"이 Developer Console에 대한 액세스를 제어합니다. 이 역할은 프로그램 및 환경 전반에 걸쳐 광범위한 액세스를 제공합니다.
샌드박스 프로그램의 경우 AEM 액세스 권한을 부여하는 제품 프로필을 가진 모든 사용자는 Developer Console을 사용할 수 있습니다.
모든 프로그램의 경우 상태 덤프 및 저장소 브라우저 액세스에 "Cloud Manager - 개발자 역할"이 필요합니다.

또는 작성자 인스턴스에서 AEM 관리자(으)로 할당된 사용자가 Developer Console에 액세스할 수 있습니다. 광범위한 “Cloud Manager - 개발자 역할” 대신 세분화된 액세스 권한을 더 부여하려면 이 옵션을 사용합니다.

작성자 및 게시 서비스 모두에서 데이터를 보려면 각 서비스의 “AEM 사용자” 또는 “AEM 관리자” 제품 프로필에도 사용자를 할당해야 합니다. 액세스 권한은 계층별로 부여되므로 보려는 데이터가 있는 계층에 프로필을 할당하십시오. 예:

게시 인스턴스에 대한 OSGi 번들 또는 저장소 브라우저를 보려면 프로필에 "AEM 사용자 - 게시"를 할당해야 합니다.
작성자 인스턴스에서 OSGi 구성 요소를 보려면 프로필에 할당된 "AEM 사용자 - 작성자"가 필요합니다.

사용자 권한 설정에 대한 자세한 내용은 Cloud Manager 설명서를 참조하십시오.

NOTE

새 권한이 할당되면 적용되는 데 최대 30분이 걸릴 수 있습니다. 권한을 테스트하려면 시크릿(비공개) 브라우저 창에서 콘솔에 로그인합니다.

IP 제한 사항 ip-restrictions

Developer Console에 대한 액세스 권한은 작성자 인스턴스에 도달하는 기능에 따라 다릅니다. 조직에서 Cloud Manager의 작성자 서비스에 IP 허용 목록에 추가하다를 구성한 경우 허용된 범위 내의 IP 주소에서 연결해야 합니다.

예를 들어 작성자 인스턴스가 회사 VPN으로 제한된 경우 해당 VPN에 연결되어 있는 동안에만 Developer Console을 사용할 수 있습니다.

프로그램 및 환경 선택기 program-environment-selector

프로그램 및 환경 선택기를 사용하여 Developer Console에서 검사할 프로그램 및 환경을 선택합니다.

"Cloud Manager - 개발자 역할"이 할당된 경우 선택기에 사용 가능한 모든 프로그램 및 환경이 나열됩니다.
대신 작성자 인스턴스에 “AEM 관리자” 역할이 할당된 경우 선택기에 액세스 권한이 있는 프로그램만 나열됩니다.

환경 선택기에는 작성자, 게시, 미리 보기 및 미리 보기와 같이 선택할 수 있는 계층이 표시됩니다. 계층을 선택하면 통합 보기를 제외한 모든 보기에 적용되며, 이 보기의 기본값은 항상 작성자 계층으로 설정됩니다.

예:

저장소 브라우저에서 게시를 확인하려면 환경 선택기에서 게시 계층을 선택한 다음 저장소 브라우저 링크를 클릭합니다.
미리 볼 패키지를 검색하려면 미리 보기 계층을 선택한 다음 패키지 검색을 시작하십시오.

환경 선택기에는 선택한 계층의 상태 표시등도 표시됩니다.

녹색 — 실행 중입니다.
주황색 — 성능이 저하되거나 다시 시작됩니다.
빨강 — 다운 이 계층을 선택할 수 없습니다.

상태 표시등에는 실행 중, 다시 시작, 최대 절전 모드 또는 중지됨 등의 상태 텍스트가 함께 표시됩니다. 계층이 실행 중이지만(녹색) 회색으로 표시되면 액세스 권한이 없습니다. 계층에 적절한 권한이 할당되었는지 확인합니다.

OSGi 번들 탭 osgi-bundles

OSGi 번들 탭에서는 선택한 환경에 배포되고 전체 텍스트 검색을 제공하는 OSGi 번들에 대한 개요를 제공합니다.

Developer Console의 새 OSGi 번들 화면

탭에는 내보낸 패키지, 가져온 패키지, 사용된 서비스 등과 같은 환경의 실제 번들 상태에 대한 정보가 제공됩니다.
번들이 수행할 것으로 예상되는 작업을 수행하는지 번들 상태를 확인하는 데 이상적입니다.

예제 사용 사례: 번들에서 종속성에 대한 버전 범위를 지정했다고 가정해 보겠습니다. 그러나 종속성에 문제가 발생하여 번들이 실제로 사용하는 종속성 버전을 확인해야 합니다. 확인하려면 Developer Console을 열고 OSGi 번들 탭에서 번들 이름을 클릭하여 번들 세부 정보에 액세스하고 번들 가져오기 아코디언을 사용하여 런타임 시 사용 중인 번들 버전 또는 패키지 버전을 확인합니다. 이 정보를 사용하여 Maven 종속성 버전 범위를 조정하거나 코드를 조정할 수 있습니다.

Java 패키지 탭 java-packages

Java 패키지 탭은 환경의 OSGi 시스템에서 활성 상태인 패키지를 검색하는 검색 필드를 제공합니다.

Developer Console UI의 Java 패키지 탭

패키지를 내보내거나 제공하는 번들과 패키지를 가져오거나 사용하는 번들을 확인할 수 있습니다.
중복 패키지(동일한 패키지, 다른 버전)를 확인할 수도 있으므로 경우에 따라 문제가 발생할 수 있습니다.

예제 사용 사례: 동적 클래스 로더를 사용하는 사용자 지정 서비스가 버전을 지정하지 않고 클래스를 로드한다고 가정해 보겠습니다. 여러 번들이 서로 다른 버전을 내보내므로 구현이 달라져 동작이 변경됩니다. 기능 모델을 분석하지 않고 환경에 있는 패키지를 확인할 수 있습니다. 이 탭을 사용하여 패키지를 검색하고 내보낸 모든 버전을 볼 수 있으며 그런 다음 더 나은 버전 범위를 사용할 수 있습니다.

구성 탭 configurations

구성 탭은 환경에서 활성화된 구성의 검색 가능한 목록을 제공합니다. 각 구성을 클릭하고 세부 정보 페이지를 보면 각 구성에서 제공하는 속성을 확인할 수 있습니다.

Developer Console UI의 구성 탭

예제 사용 사례: 지정한 구성이 실제로 환경에 있는지 확인하려고 합니다. 콘솔에서 구성 탭을 검색했는데 구성이 누락된 경우 기능 모델, 구성 실행 모드 또는 폴더를 확인할 수 있습니다.

서블릿 탭 servlets

서블릿 탭에는 선택기를 사용하여 경로를 지정하고 GET 또는 POST를 사용하여 확장을 지정할 수 있는 검색 필드가 있습니다. 그런 다음 Sling에서 요청을 처리하는 기본 설정 순서대로 서블릿 목록을 제공합니다.

Developer Console UI의 서블릿 탭

예제 사용 사례: 요청 시 활성화하고 출력을 응답에 인쇄해야 하는 OSGi 서블릿이 있다고 가정해 보겠습니다. 그러나 예상 출력 대신 빈 응답이 표시됩니다. 더 구체적인 선택기, resourceType, 확장 또는 순위로 인해 일부 다른 서블릿이 서블릿보다 우선하는지 확인해야 합니다. 예상 경로를 검색하고 순위가 높은 다른 서블릿이 활성 상태임을 확인합니다. 그런 다음 예를 들어 선택기를 추가하여 서블릿의 등급을 늘릴 수 있는지 여부를 결정할 수 있습니다.

서비스 탭 services

서비스 탭에서는 선택한 환경에 있는 서비스에 대한 개요를 제공하고 전체 텍스트 검색을 제공합니다.

Developer Console UI의 서비스 탭

세부 정보를 보려면 서비스를 클릭하십시오.

OSGi 구성 요소 탭 osgi-components

OSGi 구성 요소 탭에서는 선택한 환경 유형에 있고 전체 텍스트 검색을 제공하는 OSGi 구성 요소에 대한 개요를 제공합니다. 환경에서 OSGi 구성 요소의 라이브 상태 및 이를 충족하는 서비스, 이를 제공하는 번들 및 활성화 유형(즉시 또는 지연)을 볼 수 있습니다.

Developer Console UI의 OSGi 구성 요소 탭

사용 사례 1 예: 예기치 않은 동작이 발생했으므로 구성을 통해 활성화된 구성 요소가 특정 환경에서 활성화되었는지 확인해야 합니다. 검색에서 구성 요소를 조회하고 구성 요소가 활성 상태인지 확인하면 됩니다.
사용 사례 2 예: 환경에서 사용할 수 있는 기본 구성 요소를 확인하고 Adobe Experience Manager as a Cloud Service에 대해 자세히 알아보기 위해 해당 구성 요소가 지원하는 서비스를 식별해 보겠습니다. 구성 요소 목록에서 구성 요소를 확인할 수 있습니다.