자체 범용 편집기 서비스 실행 local-ue-service
로컬 개발을 위해 또는 자체 인프라의 일부로 고유한 범용 편집기 서비스를 실행하는 방법에 대해 알아봅니다.
개요 overview
Universal Editor Service는 Universal Editor와 백엔드 시스템을 바인딩하는 서비스입니다. 범용 편집기에서 로컬로 개발하려면 범용 편집기 서비스의 로컬 복사본을 실행해야 합니다. 이유는 다음과 같습니다.
- Adobe의 공식 범용 편집기 서비스는 전 세계적으로 호스팅되며 로컬 AEM 인스턴스를 인터넷에 노출해야 합니다.
- 로컬 AEM SDK를 사용하여 개발하는 동안 인터넷에서 Adobe의 Universal Editor 서비스에 액세스할 수 없습니다.
- AEM 인스턴스에 IP 제한이 있고 Adobe의 Universal Editor 서비스가 정의된 IP 범위에 있지 않은 경우 직접 호스팅할 수 있습니다.
사용 사례 use-cases
범용 편집기 서비스의 사용자 복사본은 다음 경우에 유용합니다.
- 범용 편집기에서 사용할 AEM을 로컬로 개발합니다.
- Adobe의 Universal Editor Service와 관계없이 자체 인프라의 일부로 Universal Editor Service를 실행하십시오.
두 사용 사례가 모두 지원됩니다. 이 문서에서는 범용 편집기 서비스의 로컬 복사본과 함께 HTTPS로 AEM을 실행하는 방법을 설명합니다.
자체 인프라의 일부로 범용 편집기 서비스를 실행하려는 경우 로컬 개발 예와 동일한 단계를 따릅니다.
HTTPS에서 실행할 AEM 설정 aem-https
HTTPS로 보호되는 외부 프레임 내에서는 비보안 HTTP 프레임을 로드할 수 없습니다. Universal Editor Service가 HTTPS에서 실행되므로 AEM 또는 다른 원격 페이지도 HTTPS에서 실행되어야 합니다.
이를 위해 HTTPS에서 실행하려면 AEM을 설정해야 합니다. 개발 목적으로 자체 서명된 인증서를 사용할 수 있습니다.
사용할 수 있는 자체 서명된 인증서를 포함하여 HTTPS에서 실행되는 AEM을 설정하는 방법은 이 문서를 참조하십시오.
Universal Editor Service 설치 install-ue-service
범용 편집기 서비스는 범용 편집기의 전체 복사본이 아니라 로컬 AEM 환경의 호출이 인터넷을 통해 라우팅되지 않고 사용자가 제어하는 정의된 끝점에서 라우팅되도록 하는 기능의 하위 집합일 뿐입니다.
NodeJS 버전 20은(는) 유니버설 편집기 서비스의 로컬 복사본을 실행해야 합니다.
범용 편집기 서비스는 소프트웨어 배포를 통해 사용할 수 있습니다. 액세스 방법에 대한 자세한 내용은 소프트웨어 배포 설명서를 참조하세요.
소프트웨어 배포의 universal-editor-service.cjs
파일을 로컬 개발 환경에 저장합니다.
HTTPS를 사용하여 Universal Editor Service를 실행할 인증서 만들기 ue-https
또한 Universal Editor Service를 사용하려면 개발 환경의 HTTPS에서 실행할 인증서가 필요합니다.
다음 명령을 실행합니다.
$ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem
명령은 key.pem
및 certificate.pem
파일을 생성합니다. 이 파일을 universal-editor-service.cjs
파일과 같은 경로로 저장합니다.
범용 편집기 서비스 구성 설정 setting-up-service
Universal Editor Service를 로컬에서 실행하려면 NodeJS에서 여러 환경 변수를 설정해야 합니다.
universal-editor-service.cjs
, key.pem
및 certificate.pem
파일과 같은 경로에서 다음 콘텐츠로 .env
파일을 만듭니다.
UES_PORT=8000
UES_PRIVATE_KEY=./key.pem
UES_CERT=./certificate.pem
UES_TLS_REJECT_UNAUTHORIZED=false
이 예제에서 로컬 개발에 필요한 최소값은 다음과 같습니다. 다음 표에서는 이러한 값과 사용 가능한 추가 값에 대해 자세히 설명합니다.
UES_PORT
8080
UES_PRIVATE_KEY
UES_CERT
UES_TLS_REJECT_UNAUTHORIZED
true
UES_DISABLE_IMS_VALIDATION
false
UES_ENDPOINT_MAPPING
예:
UES_ENDPOINT_MAPPING='[{"https://your-public-facing-author-domain.net": "http://10.0.0.1:4502"}]'
결과: Universal Editor Service가 제공된 연결
https://your-public-facing-author-domain.net
대신 http://10.0.0.1:4502
에 연결합니다.UES_LOG_LEVEL
info
silly
, trace
, debug
, verbose
, info
, log
, warn
, error
및 fatal
입니다.UES_SPLUNK_HEC_URL
UES_SPLUNK_TOKEN
UES_SPLUNK_INDEX
UES_SPLUNK_SOURCE
universal-editor-service
.env
파일에 다음 변수가 필요했습니다. 이러한 값은 이전 버전과의 호환성을 위해 2024년 10월 1일까지 지원됩니다.EXPRESS_PORT=8000
EXPRESS_PRIVATE_KEY=./key.pem
EXPRESS_CERT=./certificate.pem
NODE_TLS_REJECT_UNAUTHORIZED=0
Universal Editor Service 실행 running-ue
Universal Editor 서비스를 시작하려면 다음 명령을 실행합니다.
$ node ./universal-editor-service.cjs
터미널로 다음 항목이 출력되어야 합니다.
Universal Editor Service listening on port 8000 as HTTPS Server
서비스가 HTTP 서버가 아닌 HTTPS 서버를 시작하는지 확인합니다.
글로벌 서비스 대신 로컬 Universal Editor Service 사용 using-local-ue
Universal Editor는 페이지 구성 방식에 따라 페이지를 편집하는 데 사용할 Universal Editor Service를 인식합니다. 이는 Universal Editor에 로드된 페이지의 메타 태그를 통해 수행됩니다.
로컬 Universal Editor Service를 사용하여 페이지를 편집하려면 다음 메타 태그를 설정해야 합니다.
<meta name="urn:adobe:aue:config:service" content="https://localhost:8000">
설정되면 모든 콘텐츠 업데이트 호출이 기본 Universal Editor Service 대신 https://localhost:8000
으로 이동하는 것을 확인할 수 있습니다.
https://localhost:8000
에 직접 액세스하려고 하면 404
오류가 발생합니다. 이는 예상되는 비헤이비어입니다.https://localhost:8000/corslib/LATEST
을(를) 사용하십시오. 자세한 내용은 다음 섹션을 참조하세요.로컬 Universal Editor Service를 사용하여 페이지 편집 editing
Universal Editor Service가 로컬에서 실행하고 콘텐츠 페이지를 구성하여 로컬 서비스를 사용하면 편집기를 시작할 수 있습니다.
- 브라우저를 열고
https://localhost:8000/corslib/LATEST
으로 이동합니다. - 자체 서명된 인증서를 허용하도록 브라우저를 내보냅니다.
- 자체 서명된 인증서를 신뢰하는 경우 로컬 Universal Editor Service를 사용하여 페이지를 편집할 수 있습니다.