신속한 개발 환경 rapid-development-environments

변경 사항을 배포하기 위해 현재 클라우드 개발 환경에서는 CI/CD 파이프라인이라는 광범위한 코드 보안 및 품질 규칙을 사용하는 프로세스를 사용해야 합니다. 빠르고 반복적인 변경이 필요한 상황에 대해 Adobe은 신속한 개발 환경(RDE)을 도입했습니다.

RDE를 사용하면 개발자가 변경 사항을 신속하게 배포하고 검토할 수 있으므로 로컬 개발 환경에서 작동하는 것으로 입증된 기능을 테스트하는 데 필요한 시간을 최소화할 수 있습니다.

RDE에서 변경 사항을 테스트하면 Cloud Manager 파이프라인을 통해 일반 클라우드 개발 환경에 배포할 수 있습니다.

RDE를 사용하여 설정 방법, 사용 방법 및 개발 수명 주기를 보여 주는 추가 비디오를 볼 수 있습니다.

소개 introduction

RDE는 코드, 콘텐츠 및 Apache 또는 Dispatcher 구성에 사용할 수 있습니다. 일반 클라우드 개발 환경과 달리 개발자는 로컬 명령줄 도구를 사용하여 로컬로 빌드된 코드를 RDE에 동기화할 수 있습니다.

모든 프로그램은 RDE로 프로비저닝됩니다. Sandbox 계정이 있는 경우 몇 시간 동안 사용하지 않으면 최대 절전 모드로 전환됩니다.

생성 시 RDE는 가장 최근에 사용 가능한 Adobe Experience Manager(AEM) 버전으로 설정됩니다. Cloud Manager을 사용하여 수행할 수 있는 RDE 재설정은 RDE를 순환시키고 가장 최근에 사용할 수 있는 AEM 버전으로 설정합니다.

일반적으로 RDE는 특정 기능을 테스트 및 디버깅하기 위해 주어진 시간에 단일 개발자에 의해 사용됩니다. 개발 세션이 완료되면 RDE는 다음 사용을 위해 기본 상태로 재설정될 수 있습니다.

프로덕션(샌드박스가 아닌) 프로그램에 대해 추가 RDE에 라이센스가 부여될 수 있습니다.

프로그램에서 RDE 활성화 enabling-rde-in-a-program

Cloud Manager을 사용하여 프로그램에 대한 RDE를 만들 수 있도록 다음 단계를 따르십시오.

이제 개요 화면에 환경 카드에 새 환경이 표시됩니다.

생성 시 RDE는 가장 최근에 사용할 수 있는 AEM 버전으로 설정됩니다. Cloud Manager을 사용하여 수행할 수도 있는 RDE 재설정은 RDE를 순환시키고 가장 최근에 사용할 수 있는 AEM 버전으로 설정합니다.

Cloud Manager을 사용하여 환경을 만들고, 환경에 액세스할 수 있는 사용자를 관리하고, 사용자 지정 도메인을 할당하는 방법에 대한 자세한 내용은 Cloud Manager 설명서를 참조하십시오.

RDE 명령줄 도구 설치 installing-the-rde-command-line-tools

Cloud Manager을 사용하여 프로그램에 대한 RDE를 추가한 후 다음 단계에 설명된 대로 명령줄 도구를 설정하여 상호 작용할 수 있습니다.

대화형 설정 installing-the-rde-command-line-tools-interactive

setup 명령은 제공된 구성을 로컬로 저장할지 또는 전역으로 저장할지를 묻습니다.

Setup the CLI configuration necessary to use the RDE commands.
? Do you want to store the information you enter in this setup procedure locally? (y/N)

no 선택

yes 선택

로컬 또는 글로벌 구성을 선택하면 setup 명령은 현재 로그인에서 조직 ID를 읽은 다음 조직의 프로그램을 읽습니다. 조직을 찾을 수 없는 경우 몇 가지 지침과 함께 수동으로 입력할 수 있습니다.

Selected only organization: XYXYXYXYXYXYXYXXYY
retrieving programs of your organization ...

프로그램이 검색되면 사용자는 목록에서 선택하고 필터링할 내용을 입력할 수 있습니다.
프로그램을 선택하면 선택할 수 있는 RDE 환경 목록이 나열됩니다.
사용 가능한 프로그램 및/또는 RDE 환경이 한 개만 있는 경우 자동으로 선택됩니다.

현재 환경 컨텍스트를 보려면 다음을 실행합니다.

aio aem rde setup --show

명령은 다음과 유사한 결과로 응답합니다.

Current configuration: cm-p1-e1: programName - environmentName (organization: ...@AdobeOrg)

비대화형 환경에서의 수동 설정 절차 manual-setup

사용자가 위에 설명된 대로 설정 명령을 대화식으로 실행할 수 없는 환경(예: CI/CD 또는 스크립트)의 경우 다음 단계에 따라 조직, 프로그램 및 환경에 대한 세 가지 매개 변수를 수동으로 구성할 수 있습니다.

새 기능을 개발하는 동안 RDE 사용 using-rde-while-developing-a-new-feature

Adobe은 새 기능을 개발하기 위해 다음 워크플로를 권장합니다.

RDE를 사용하여 기존 기능 디버그 use-rde-to-debug-an-existing-feature

이 워크플로우는 새 기능을 개발하는 것과 유사합니다. 차이점은 RDE에 동기화되는 코드가 문제가 발견된 환경에 푸시된 모든 것의 git 레이블을 반영한다는 것입니다. 또한 업스트림 환경과 일치하는 콘텐츠를 배포하는 것이 유용할 수 있습니다. 이 작업은 콘텐츠 패키지를 내보내고 가져와서 수행할 수 있습니다.

동일한 RDE에서 공동 작업 중인 여러 개발자 multiple-developers-collaborating-on-the-same-rde

RDE는 한 번에 하나의 프로젝트를 지원합니다. 코드는 로컬 개발 환경에서 RDE 환경으로 동기화되므로 한 개발자가 주어진 시간에 직접 사용하는 것이 가장 자연스럽습니다.

그러나 신중하게 조정하면 두 명 이상의 개발자가 특정 기능을 검증하거나 특정 문제를 디버깅할 수 있습니다. 중요한 것은 각 개발자가 로컬 프로젝트를 계속 동기화하여 특정 개발자의 코드 변경 사항이 다른 개발자에게 흡수되도록 하는 것입니다. 그렇지 않으면 한 개발자가 실수로 다른 개발자의 코드를 덮어쓸 수 있습니다. 권장되는 전략은 각 개발자가 RDE로 동기화하기 전에 공유 git 분기에 변경 사항을 커밋하여 다른 개발자가 직접 변경하기 전에 변경 사항을 가져오는 것입니다.

RDE 명령줄 도구 명령 rde-cli-commands

도움말/일반 정보 help

글로벌 플래그 global-flags

RDE에 배포 deploying-to-rde

이 섹션에서는 번들, OSGI 구성, 콘텐츠 패키지, 개별 콘텐츠 파일 및 Apache 또는 Dispatcher 구성의 배포, 설치 또는 업데이트에 RDE CLI를 사용하는 방법에 대해 설명합니다.

일반적인 사용 패턴은 aio aem:rde:install <artifact>입니다.

다음은 몇 가지 예입니다.

컨텐츠 패키지 배포 deploy-content-package

aio aem:rde:install sample.demo.ui.apps.all-1.0.0-SNAPSHOT.zip

성공적인 배포에 대한 응답은 다음과 같습니다.

...
#1: deploy completed for content-package sample.demo.ui.apps.all-1.0.0-SNAPSHOT.zip on author,publish - done by 9E072FC75D54FE1A2B49431C@AdobeID at 2022-09-13T11:32:06.229Z

필요한 경우 원격 저장소를 참조할 수 있습니다.

aio aem:rde:install -t content-package "https://repo1.maven.org/maven2/com/adobe/aem/guides/aem-guides-wknd.all/2.1.0/aem-guides-wknd.all-2.1.0.zip"

기본적으로 아티팩트는 작성자 및 게시 계층 모두에 배포되지만 "-s" 플래그를 사용하여 특정 계층을 타깃팅할 수 있습니다.

코드, 콘텐츠가 있는 패키지 또는 컨테이너 패키지("모든" 패키지라고도 함)와 같은 모든 AEM 패키지를 배포할 수 있습니다.

OSGI 구성 배포 deploy-OSGI-config

aio aem:rde:install com.adobe.granite.demo.MyServlet.cfg.json

성공적인 배포에 대한 응답은 다음과 같습니다.

...
#2: deploy completed for osgi-config com.adobe.granite.demo.MyServlet.cfg.json on author,publish - done by 9E0725C05D54FE1A0B49431C@AdobeID at 2022-09-13T11:54:36.390Z

번들 배포 deploy-bundle

번들을 배포하려면 다음을 사용합니다.

aio aem:rde:install ~/.m2/repository/org/apache/felix/org.apache.felix.gogo.jline/1.1.8/org.apache.felix.gogo.jline-1.1.8.jar

성공적인 배포에 대한 응답은 다음과 같습니다.

...
#3: deploy staged for osgi-bundle org.apache.felix.gogo.jline-1.1.8.jar on author,publish - done by 9E0725C05D53BE1A0B49431C@AdobeID at 2022-09-14T07:54:28.882Z

컨텐츠 파일 배포 deploy-content-file

컨텐츠 파일을 배포하려면 다음을 사용합니다.

aio aem:rde:install world.txt -p /apps/hello.txt

성공적인 배포에 대한 응답은 다음과 같습니다.

..
#4: deploy completed for content-file world.txt on author,publish - done by 9E0729C05C54FE1A0B49431C@AdobeID at 2022-09-14T07:49:30.644Z

Apache/Dispatcher 구성 배포 deploy-apache-config

이러한 유형의 구성을 위해서는 전체 폴더 구조가 zip 파일 형식이어야 합니다.

AEM 프로젝트의 dispatcher 모듈에서 아래 maven 명령을 실행하여 Dispatcher 구성을 압축할 수 있습니다.

mvn clean package

또는 dispatcher 모듈의 src 디렉터리에서 아래 zip 명령을 사용합니다.

zip -y -r dispatcher.zip .

그런 다음 이 명령을 사용하여 구성을 배포합니다.

aio aem:rde:install target/aem-guides-wknd.dispatcher.cloud-X.X.X-SNAPSHOT.zip

배포가 성공하면 다음과 유사한 응답이 생성됩니다.

..
#5 deploy completed for dispatcher-config dispatcher.zip on author,publish - done by 9E0735C05T54FE1A0B49431C@AdobeID at 2022-10-03T10:26:31.286Z
Logs:
  Cloud manager validator 2.0.49
  2022/10/03 10:26:37 No issues found
  Syntax OK

RDE에 배포된 코드는 Cloud Manager 파이프라인 및 관련 품질 게이트를 거치지 않습니다. 그러나 이 코드는 아래 코드 샘플에 표시된 대로 오류를 보고하는 몇 가지 분석을 수행합니다.

$ aio aem:rde:install ~/.m2/repository/org/apache/felix/org.apache.felix.gogo.jline/1.1.8/org.apache.felix.gogo.jline-1.1.8.jar
...
#19: deploy staged for osgi-bundle org.apache.felix.gogo.jline-1.1.8.jar on author,publish - done by 9E0725C05D74FR1A0B49431C@AdobeID at 2022-09-14T07:54:28.882Z
Logs:
The analyser found the following errors for author :
[requirements-capabilities] com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8: Artifact com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8 requires [org.apache.felix.gogo.jline/1.1.8] org.apache.felix.gogo; filter:="(&(org.apache.felix.gogo=command.implementation)(version>=1.0.0)(!(version>=2.0.0)))"; effective:=active in start level 20 but no artifact is providing a matching capability in this start level.
[api-regions-exportsimports] com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8: Bundle org.apache.felix.gogo.jline:1.1.8 is importing package(s) [org.jline.builtins, org.jline.utils, org.apache.felix.service.command, org.apache.felix.service.threadio, org.jline.terminal, org.jline.reader, org.apache.felix.gogo.runtime, org.jline.reader.impl] in start level 20 but no bundle is exporting these for that start level.
The analyser found the following errors for publish :
[requirements-capabilities] com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8: Artifact com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8 requires [org.apache.felix.gogo.jline/1.1.8] org.apache.felix.gogo; filter:="(&(org.apache.felix.gogo=command.implementation)(version>=1.0.0)(!(version>=2.0.0)))"; effective:=active in start level 20 but no artifact is providing a matching capability in this start level.
[api-regions-exportsimports] com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8: Bundle org.apache.felix.gogo.jline:1.1.8 is importing package(s) [org.jline.builtins, org.jline.utils, org.apache.felix.service.command, org.apache.felix.service.threadio, org.jline.terminal, org.jline.reader, org.apache.felix.gogo.runtime, org.jline.reader.impl] in start level 20 but no bundle is exporting these for that start level.

위의 코드 샘플은 번들이 해결되지 않는 경우의 동작을 보여 줍니다. 이 경우 "스테이징됨"이며 다른 코드 설치를 통해 요구 사항(이 경우 누락된 가져오기)이 충족되는 경우에만 설치됩니다.

구성 파이프라인 관련 구성 배포(yaml 구성) deploy-config-pipeline

문서 구성 파이프라인 사용에 설명된 환경별 구성(1개 이상의 yaml 파일)은 다음과 같이 배포할 수 있습니다.

aio aem:rde:install -t env-config ./my-config-folder
여기서 my-config-folder는 yaml 구성이 들어 있는 상위 폴더입니다.

또는 구성 폴더 트리가 포함된 zip 파일을 설치할 수도 있습니다.

aio aem:rde:install -t env-config config.zip

yaml 파일의 envTypes 배열에는 아래 예와 같이 값 rde ​이(가) 포함되어야 합니다.

kind: "CDN"
version: "1"
metadata:
  envTypes: ["rde"]

사이트 테마 및 사이트 템플릿을 기반으로 프론트엔드 코드 배포 deploying-themes-to-rde

RDE는 사이트 테마 및 사이트 템플릿을 기반으로 프론트엔드 코드를 지원합니다. RDE를 사용하면 다른 환경 유형에 사용되는 Cloud Manager 프론트엔드 파이프라인이 아니라 명령줄 지시문을 사용하여 프론트엔드 패키지를 배포할 수 있습니다.

평소대로 npm을 사용하여 프론트엔드 패키지를 빌드합니다.

npm run build

프론트엔드 패키지 폴더에 package.json 파일과 dist 폴더가 포함되도록 dist/ 폴더를 생성해야 합니다.

ls ./path-to-frontend-pkg-folder/
...
dist
package.json

이제 프론트엔드 패키지 폴더를 가리키면 프론트엔드 패키지를 RDE에 배포할 준비가 되었습니다.

aio aem:rde:install -t frontend ./path-to-frontend-pkg-folder/
...
#1: deploy completed for frontend frontend-pipeline.zip on author,publish - done by ... at 2024-01-18T15:33:22.898Z
Logs:
> Deployed artifact wknd-1.0.0-1705592008-26e7ec1a
> with workspace hash 692021864642a20d6d298044a927d66c0d9cf2adf42d4cca0c800a378ac3f8d3

또는 package.json 파일과 dist 폴더를 압축하고 해당 zip 파일을 배포할 수 있습니다.

zip -r frontend-pkg.zip ./path-to-frontend-pkg-folder/dist ./path-to-frontend-pkg-folder/package.json

aio aem:rde:install -t frontend frontend-pkg.zip
...
#1: deploy completed for frontend frontend-pipeline.zip on author,publish - done by ... at 2024-01-18T15:33:22.898Z
Logs:
> Deployed artifact wknd-1.0.0-1705592008-26e7ec1a
> with workspace hash 692021864642a20d6d298044a927d66c0d9cf2adf42d4cca0c800a378ac3f8d3

RDE 상태 확인 checking-rde-status

RDE CLI를 사용하여 RDE 플러그인을 통해 배포된 내용과 같이 환경을 배포할 준비가 되었는지 확인할 수 있습니다.

실행 중:

aio aem:rde:status

다음을 반환합니다.

Info for cm-p12345-e987654
Environment: Ready
- Bundles Author:
 com.adobe.granite.sample.demo-1.0.0.SNAPSHOT
- Bundles Publish:
 com.adobe.granite.sample.demo-1.0.0.SNAPSHOT
- Configurations Author:
 com.adobe.granite.demo.MyServlet
- Configurations Publish:
 com.adobe.granite.demo.MyServlet

인스턴스 배포에 대한 메모를 반환하는 경우 계속해서 다음 업데이트를 수행할 수 있지만 마지막 업데이트가 아직 인스턴스에 표시되지 않을 수 있습니다.

배포 내역 표시 show-deployment-history

다음을 실행하여 RDE에 대한 배포 내역을 확인할 수 있습니다.

aio aem:rde:history

응답 형식을 반환합니다.

#1: deploy completed for content-package aem-guides-wknd.all-2.1.0.zip on author,publish - done by 029039A55D4DE16A0A494025@AdobeID at 2022-09-12T14:41:55.393Z

RDE에서 삭제 deleting-from-rde

CLI 도구를 통해 이전에 RDE에 배포된 구성 및 번들을 삭제할 수 있습니다. 삭제할 수 있는 항목 목록에 status 명령을 사용하십시오. 이 목록에는 번들 bsn 및 delete 명령에서 참조할 구성 pid이(가) 포함됩니다.

예를 들어 com.adobe.granite.demo.MyServlet.cfg.json이(가) 설치된 경우 bsn은(는) cfg.json 접미사가 없는 com.adobe.granite.demo.MyServlet입니다.

컨텐츠 패키지 또는 컨텐츠 파일 삭제는 지원되지 않습니다. 이를 제거하려면 RDE를 재설정해야 하며, 이렇게 하면 RDE가 기본 상태로 돌아갑니다.

자세한 내용은 아래 예를 참조하십시오.

aio aem:rde:delete com.adobe.granite.csrf.impl.CSRFFilter
#13: delete completed for osgi-config com.adobe.granite.csrf.impl.CSRFFilter on author - done by karl at 2022-09-12T22:01:01.955Z
#14: delete completed for osgi-config com.adobe.granite.csrf.impl.CSRFFilter on publish - done by karl at 2022-09-12T22:01:12.979Z

자세한 내용과 데모는 비디오 튜토리얼 RDE 명령 사용 방법(10:01)을 참조하세요.

로그 rde-logging

다른 환경 유형과 유사하게 OSGi 구성을 수정하여 로그 수준을 설정할 수 있지만, 위에서 설명한 대로 RDE에 대한 배포 모델에 Cloud Manager 배포가 아닌 명령줄이 포함됩니다. 로그를 보고 다운로드하고 해석하는 방법에 대한 자세한 내용은 로깅 설명서를 참조하세요.

RDE CLI에는 기록해야 하는 클래스와 패키지 및 로그 수준을 빠르게 구성하는 데 사용할 수 있는 자체 log 명령도 있습니다. 이러한 구성은 버전 제어에서 OSGI 속성을 수정하지 않으므로 사용 후 삭제로 볼 수 있습니다. 이 기능은 먼 과거의 로그를 조회하는 것보다 실시간으로 로그를 추적하는 데 중점을 둡니다.

다음 예제에서는 하나의 패키지를 디버그 로그 수준으로 설정하고 두 패키지(공백으로 구분)를 정보 디버그 수준으로 설정하여 작성자 계층을 추적하는 방법을 보여 줍니다. auth 패키지가 포함된 출력이 강조 표시됩니다.

aio aem:rde:logs --target=author --debug=org.apache.sling --info=org.apache.sling.commons.threads.impl org.apache.sling.jcr.resource.internal.helper.jcr -H .auth.

aio aem:rde:reset

명령줄 옵션의 전체 집합은 aio aem:rde:logs --help을(를) 참조하십시오.

기능은 다음과 같습니다.

로그는 RDE의 메모리에 저장되며 이러한 로그는 재활용되므로 꼬리가 붙지 않거나 네트워크가 너무 느리면 삭제됩니다.

재설정 reset-rde

RDE를 재설정하면 작성자 및 게시 인스턴스 모두에서 모든 사용자 지정 코드, 구성 및 콘텐츠가 제거됩니다. 이 재설정은 예를 들어 RDE가 특정 기능을 테스트하는 데 사용되었고 다른 기능을 테스트할 수 있도록 기본 상태로 재설정하려는 경우 유용합니다.

재설정하면 RDE가 가장 최근에 사용할 수 있는 AEM 버전으로 설정됩니다.

Cloud Manager을 사용하여 아래 단계를 수행하여 RDE를 재설정할 수 있습니다.

RDE 재설정 프로세스가 시작되면 일반적으로 완료되어 환경을 기본 상태로 되돌리는 데 몇 분이 소요됩니다. 재설정 프로세스의 상태는 언제든지 환경 카드의 상태 열 또는 환경 창에서 볼 수 있습니다.

개요 페이지의 환경 카드에서 바로 줄임표 버튼을 사용하여 RDE를 재설정할 수도 있습니다.

Cloud Manager을 사용하여 환경을 관리하는 방법에 대한 자세한 내용은 Cloud Manager 설명서를 참조하세요.

JSON 출력을 지원하는 명령 json-commands

대부분의 명령은 콘솔 출력을 억제하고 스크립트에서 처리할 유효한 json을 반환하는 전역 --json 플래그를 지원합니다. 다음은 json 출력의 예와 함께 몇 가지 지원되는 명령입니다.

상태 status

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "Modification in progress | Deployment in progress | Upload in progress | Ready (instances are currently deploying) | Ready",
  "author": {
    "osgiBundles": [],
    "osgiConfigs": []
  },
  "publish": {
    "osgiBundles": [],
    "osgiConfigs": []
  }
}

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "Ready",
  "author": {
    "osgiBundles": [
      {
        "id": "author_osgi-bundle_com.adobe.granite.hotdev.demo",
        "updateId": "80",
        "service": "author",
        "type": "osgi-bundle",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        }
      }
    ],
    "osgiConfigs": [
      {
        "id": "publish_osgi-config_com.adobe.granite.demo.MyServlet",
        "updateId": "80",
        "service": "publish",
        "type": "osgi-config",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "configPid": "com.adobe.granite.demo.MyServlet"
        }
      }
    ]
  },
  "publish": {
    "osgiBundles": [
      {
        "id": "author_osgi-bundle_com.adobe.granite.hotdev.demo",
        "updateId": "80",
        "service": "author",
        "type": "osgi-bundle",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        }
      }
    ],
    "osgiConfigs": [
      {
        "id": "publish_osgi-config_com.adobe.granite.demo.MyServlet",
        "updateId": "80",
        "service": "publish",
        "type": "osgi-config",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "configPid": "com.adobe.granite.demo.MyServlet"
        }
      }
    ]
  }
}

설치 install

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "items": [
    {
      "updateId": "4",
      "info": "deploy",
      "action": "deploy",
      "metadata": {
        "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip"
      },
      "services": [
        "author",
        "publish"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T12:30:44.578Z",
        "processed": "2024-05-21T12:31:07.886468Z"
      },
      "user": "userId",
      "type": "content-package",
      "hash": "2ad73507",
      "logs": [
        "No logs available for this update."
      ]
    }
  ]
}

삭제 delete

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "items": [
    {
      "updateId": "84",
      "info": "delete author_osgi-bundle_com.adobe.granite.hotdev.demo",
      "action": "delete",
      "metadata": {},
      "services": [
        "author"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T11:49:16.889Z",
        "processed": "2024-05-21T11:49:18.188420Z"
      },
      "user": "userId",
      "type": "osgi-bundle",
      "deletedArtifact": {
        "id": "author_osgi-bundle_com.adobe.granite.hotdev.demo",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        },
        "service": "author",
        "type": "osgi-bundle",
        "updateId": "83"
      },
      "hash": "636f6d2e",
      "logs": [
        "No logs available for this update."
      ]
    },
    {
      "updateId": "85",
      "info": "delete publish_osgi-bundle_com.adobe.granite.hotdev.demo",
      "action": "delete",
      "metadata": {},
      "services": [
        "publish"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T11:49:23.857Z",
        "processed": "2024-05-21T11:49:25.237930Z"
      },
      "user": "userId",
      "type": "osgi-bundle",
      "deletedArtifact": {
        "id": "publish_osgi-bundle_com.adobe.granite.hotdev.demo",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        },
        "service": "publish",
        "type": "osgi-bundle",
        "updateId": "83"
      },
      "hash": "636f6d2e",
      "logs": [
        "No logs available for this update."
      ]
    }
  ]
}

이력 history

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "Ready",
  "items": [
    {
      "updateId": "112",
      "info": "delete publish_osgi-bundle_com.adobe.granite.hotdev.demo",
      "action": "delete",
      "metadata": {},
      "services": [
        "publish"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T12:53:07.934Z",
        "processed": "2024-05-21T12:53:09.118766Z"
      },
      "user": "userId",
      "type": "osgi-bundle",
      "deletedArtifact": {
        "id": "publish_osgi-bundle_com.adobe.granite.hotdev.demo",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        },
        "service": "publish",
        "type": "osgi-bundle",
        "updateId": "110"
      },
      "hash": "636f6d2e"
    },
    {
      "updateId": "111",
      "info": "delete author_osgi-bundle_com.adobe.granite.hotdev.demo",
      "action": "delete",
      "metadata": {},
      "services": [
        "author"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T12:53:00.824Z",
        "processed": "2024-05-21T12:53:02.101560Z"
      },
      "user": "userId",
      "type": "osgi-bundle",
      "deletedArtifact": {
        "id": "author_osgi-bundle_com.adobe.granite.hotdev.demo",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        },
        "service": "author",
        "type": "osgi-bundle",
        "updateId": "110"
      },
      "hash": "636f6d2e"
    },
    {
      "updateId": "110",
      "info": "deploy",
      "action": "deploy",
      "metadata": {
        "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip"
      },
      "services": [
        "author",
        "publish"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T12:52:12.123Z",
        "processed": "2024-05-21T12:52:31.026147Z"
      },
      "user": "userId",
      "type": "content-package",
      "hash": "2ad73507"
    }
  ]
}

재설정 reset

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "resetting"
}

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "reset"
}

다시 시작 restart

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "restarted"
}

실행 모드 runmodes

아래 예와 같이 폴더 이름에 접미사를 사용하여 RDE별 OSGI 구성을 적용할 수 있습니다.

실행 모드에 대한 일반적인 정보는 실행 모드 설명서를 참조하세요.

RDE는 컨텐츠를 /apps 아래의 install.rde 폴더(또는 install.author.rde 또는 install.publish.rde)에 설치할 수 있다는 점에서 다른 환경과 구별됩니다. 이렇게 하면 명령줄 도구를 사용하여 콘텐츠를 git에 커밋하고 RDE에 전달할 수 있습니다.

컨텐츠로 채우기 populating-content

RDE가 재설정되면 모든 컨텐츠가 제거되므로 원할 경우 컨텐츠를 추가하려면 명시적인 작업을 수행해야 합니다. RDE에서 기능의 유효성을 검사하거나 디버깅하기 위한 테스트 콘텐츠로 사용할 콘텐츠 세트를 어셈블하는 것이 좋습니다. 해당 콘텐츠로 RDE를 채우는 몇 가지 가능한 전략이 있습니다.

콘텐츠 패키지를 동기화할 때는 1GB로 제한됩니다.

RDE는 클라우드 개발 환경과 어떻게 다릅니까? how-are-rds-different-from-cloud-development-environments

RDE는 여러 가지 면에서 클라우드 개발 환경과 유사하지만 코드를 빠르게 동기화할 수 있는 일부 사소한 아키텍처 차이점이 있습니다. RDE에 코드를 가져오는 메커니즘은 다릅니다. RDE의 경우 로컬 개발 환경에서 하나의 코드가 동기화되고, 클라우드 개발 환경의 경우 Cloud Manager을 통해 코드를 배포합니다.

이러한 이유로 RDE 환경에서 코드를 확인한 후 비프로덕션 파이프라인을 사용하여 클라우드 개발 환경에 코드를 배포하는 것이 좋습니다. 마지막으로 프로덕션 파이프라인으로 배포하기 전에 코드를 테스트합니다.

또한 다음 고려 사항을 참고하십시오.

몇 개의 RDE가 필요합니까? how-many-rds-do-i-need

RDE는 라이센스가 부여된 각 솔루션에 대해 사용할 수 있으며 Adobe은 프로덕션(샌드박스가 아닌) 프로그램에 대해 라이센스가 부여될 수 있는 추가 RDE도 제공합니다.

필요한 RDE 수는 조직의 구성과 프로세스에 따라 다릅니다. 가장 유연한 모델은 조직에서 각 AEM Cloud Service 개발자를 위한 전용 RDE를 구매하는 것입니다. 이 모델에서 각 개발자는 RDE 환경을 사용할 수 있는지 여부에 대해 다른 팀 구성원과 조정하지 않고 RDE에서 코드를 테스트할 수 있습니다.

반면에 단일 RDE를 사용하는 팀은 내부 프로세스를 사용하여 주어진 시간에 환경을 사용할 수 있는 개발자를 조정할 수 있습니다. 개발자가 중간 기능 이정표에 도달하여 필요한 변경을 신속하게 수행할 수 있는 클라우드 환경에서 유효성 검사를 수행할 준비가 될 때마다 이러한 상황이 발생할 수 있습니다.

중간 모델은 조직에서 여러 RDE를 구매하여 사용하지 않는 RDE를 사용할 수 있는 가능성이 높은 모델입니다. 한 가지 전략은 스크럼 팀 또는 주요 기능당 RDE를 할당하는 것입니다. 내부 프로세스들은 환경들의 사용을 조정하기 위해 사용될 수 있다.

AEM Forms Cloud Service RDE(신속한 개발 환경)는 다른 환경과 어떻게 다릅니까? how-are-forms-rds-different-from-cloud-development-environments

Forms 개발자는 AEM Forms Cloud Service 신속 개발 환경을 사용하여 적응형 Forms, 워크플로 및 핵심 구성 요소 맞춤화, 서드파티 시스템과의 통합 등과 같은 사용자 정의를 신속하게 개발할 수 있습니다. AEM Forms RDE(Cloud Service 빠른 개발 환경)에는 통신 API가 지원되지 않습니다. 또한 적응형 양식 제출 시 기록 문서 생성과 같이 기록 문서가 필요한 기능이 지원되지 않습니다. 아래에 나열된 AEM Forms 기능은 RDE(Rapid Development Environment)에서 사용할 수 없습니다.

RDE 자습서

AEM as a Cloud Service의 RDE에 대해 알아보려면 설정 방법, 사용 방법 및 개발 수명 주기(01:25)를 보여 주는 비디오 튜토리얼을 참조하십시오.

​# 문제 해결

RDE 문제 해결(#rde-troublehooting)

기존 RDE에 대한 최신 AEM 버전을 얻는 방법 get-latest-aem-version

생성 시 RDE는 가장 최근에 사용 가능한 Adobe Experience Manager(AEM) 버전으로 설정됩니다. Cloud Manager 또는 aio aem:rde:reset 명령을 사용하여 수행할 수 있는 RDE 재설정,은(는) RDE를 순환하고 가장 최근에 사용 가능한 AEM 버전으로 설정합니다.

aio RDE 플러그인 문제 해결 aio-rde-plugin-troubleshooting

권한 부족 관련 오류 insufficient-permissions

RDE 플러그인을 사용하려면 Cloud Manager 개발자 - Cloud Service 제품 프로필의 멤버여야 합니다. 자세한 내용은 Cloud Manager 제품 프로필에 팀원 할당 - 개발자 제품 프로필 할당을 참조하십시오.

또는 이 명령을 실행하여 개발자 콘솔에 로그인할 수 있는 경우 이 개발자 역할이 있는지 확인할 수 있습니다.

aio cloudmanager:environment:open-developer-console

aio plugins:install @adobe/aio-cli-plugin-cloudmanager

를 실행하여 로그인이 성공적으로 완료되었는지 확인합니다.

aio cloudmanager:list-programs

구성된 조직의 모든 프로그램을 나열하고 올바른 역할이 할당되었는지 확인해야 합니다.

더 이상 사용되지 않는 컨텍스트 "aio-cli-plugin-cloudmanager" 사용 aio-rde-plugin-troubleshooting-deprecatedcontext

'aio-cli-plugin-aem-rde'의 연혁으로 인해 'aio-cli-plugin-cloudmanager'라는 컨텍스트 이름이 한동안 사용되었습니다. 이제 rde 플러그인은 컨텍스트 정보를 처리하는 IMS 방식을 사용합니다. 즉, 컨텍스트 정보를 전역 또는 로컬에 저장하는 옵션이 있을 뿐만 아니라 원하는 경우 구성된 기본값으로 모든 aio 호출을 기본값으로 설정합니다. 구성된 기본 컨텍스트는 로컬에 저장되고 개발자가 폴더 내에서 개별 컨텍스트 및 해당 정보를 추적하고 사용할 수 있도록 합니다. 자세한 내용은 위의 로컬 컨텍스트를 설정하는 예제를 참조하십시오.

aio-cli-plugin-cloudmanager와 aio-cli-plugin-aem-rde 두 플러그인을 모두 사용하고 모든 정보를 동일한 컨텍스트로 유지하고자 하는 개발자는 지금 옵션을 사용해야 합니다.

'aio-cli-plugin-cloudmanager' 컨텍스트 계속 사용

컨텍스트를 계속 사용할 수 있으며 RDE 플러그인에 사용 중단 경고가 표시됩니다. 이 경고는 --quiet 모드를 사용하여 제거할 수 있습니다. 최신 버전의 RDE 플러그인은 더 이상 'aio-cli-plugin-cloudmanager' 컨텍스트를 읽기 위한 대체를 제공하지 않습니다. 이 설정을 사용하려면 기본 컨텍스트를 'aio-cli-plugin-cloudmanager'로 구성하기만 하면 됩니다. 위의 로컬 컨텍스트를 설정하는 예제를 참조하십시오.

Cloud Manager 플러그인에도 다른 컨텍스트 이름을 사용하십시오

Cloud Manager 플러그인은 사용할 컨텍스트를 정의하는 매개 변수를 제공합니다. 아직 IMS 기본 컨텍스트 구성을 지원하지 않습니다. 이렇게 하려면 로컬 컨텍스트를 설정하는 예제를 사용하여 RDE 플러그인을 구성하고 Cloud Manager 플러그인에 모든 호출에서 --imsContextName=myContext과(와) 같은 'myContext'를 사용하도록 합니다.