설명서AEMAEM 튜토리얼AEM as a Cloud Service 튜토리얼

개발 도구 설정

마지막 업데이트: 2025년 5월 5일
  • 적용 대상:
  • Experience Manager as a Cloud Service
  • 주제:
  • 개발자 도구

작성 대상:

  • 초급
  • 개발자

AEM(Adobe Experience Manager) 개발을 위해 최소한의 개발 도구 세트를 설치하고 개발자 시스템에 설정해야 합니다. 이러한 도구는 AEM 프로젝트의 개발 및 빌드를 지원합니다.

~은(는) 사용자 디렉터리의 약어로 사용됩니다. Windows에서는 %HOMEPATH%에 해당합니다.

Java 설치

Experience Manager은 Java 애플리케이션이므로 개발 및 AEM as a Cloud Service SDK을 지원하려면 Java SDK이 필요합니다.

  1. 최신 릴리스 Java 11 SDK 다운로드 및 설치
  2. 다음 명령을 실행하여 Oracle Java 11 SDK이 설치되어 있는지 확인합니다.
$ java --version

$ java -version

$ java --version

Java

Homebrew 설치

Homebrew 사용은 선택 사항이지만 권장됩니다.

Homebrew는 macOS, Windows 및 Linux용 오픈 소스 패키지 관리자입니다. 모든 지원 도구를 별도로 설치할 수 있으며, Homebrew는 Experience Manager 개발에 필요한 다양한 개발 도구를 편리하게 설치하고 업데이트할 수 있는 방법을 제공합니다.

  1. 터미널 열기
  2. brew --version 명령을 실행하여 Homebrew가 이미 설치되어 있는지 확인하십시오.
  3. Homebrew가 설치되지 않은 경우 Homebrew를 설치합니다.
macOS

macOS의 Homebrew에는 다음 명령을 통해 설치할 수 있는 Xcode 또는 명령줄 도구가 필요합니다.

$ xcode-select --install
Windows
Windows 10에 Homebrew 설치
Linux
Linux에 Homebrew 설치
  1. brew --version 명령을 실행하여 Homebrew가 설치되어 있는지 확인합니다.

Homebrew

Homebrew를 사용하는 경우 아래 섹션에서 Homebrew를 사용하여 설치 지침을 따르십시오. Homebrew를 사용하고 있는 사용자가 not ​인 경우 OS별 링크를 사용하여 도구를 설치하십시오.

Git 설치

Git은(는) Adobe Cloud Manager에서 사용하는 소스 제어 관리 시스템이므로 개발에 필요합니다.

Homebrew를 사용하여 Git 설치

  1. 터미널/명령 프롬프트 열기

  2. 명령 실행: $ brew install git

  3. 다음 명령을 사용하여 Git이 설치되었는지 확인합니다. $ git --version

Git 다운로드 및 설치

  1. Git 다운로드 및 설치

  2. 터미널/명령 프롬프트 열기

  3. 다음 명령을 사용하여 Git이 설치되었는지 확인합니다. $ git --version

Git

Node.js(및 npm) 설치

Node.js은(는) AEM 프로젝트 ui.frontend 하위 프로젝트의 프론트엔드 에셋으로 작업하는 데 사용되는 JavaScript 런타임 환경입니다. Node.js는 JavaScript 종속성을 관리하는 데 사용되는 실질적인 Node.js 패키지 관리자인 npm과(와) 함께 배포됩니다.

Homebrew를 사용하여 Node.js 설치

  1. 터미널/명령 프롬프트 열기

  2. 명령 실행: $ brew install node

  3. 다음 명령을 사용하여 Node.js가 설치되었는지 확인하십시오. $ node -v

  4. $ npm -v 명령을 사용하여 npm이 설치되었는지 확인합니다.

Node.js 다운로드 및 설치

  1. Node.js 다운로드 및 설치

  2. 터미널/명령 프롬프트 열기

  3. 다음 명령을 사용하여 Node.js가 설치되었는지 확인하십시오. $ node -v

  4. $ npm -v 명령을 사용하여 npm이 설치되었는지 확인합니다.

Node.js 및 npm

TIP
AEM Project Archetype 기반 AEM Projects는 빌드 시 격리된 버전의 Node.js를 설치합니다. AEM Maven 프로젝트의 Reactor pom.xml에 지정된 Node.js 및 npm 버전과 로컬 개발 시스템의 버전을 동기화하거나 가까운 상태로 유지하는 것이 좋습니다.
Node.js 및 npm 빌드 버전을 찾을 위치에 대해서는 이 예제 AEM Project Reactor pom.xml을 참조하십시오.

Maven 설치

Apache Maven은 AEM Project Maven Archetype에서 생성된 AEM 프로젝트를 빌드하는 데 사용되는 오픈 소스 Java 명령줄 툴입니다. 모든 주요 IDE(IntelliJ IDEA, Visual Studio Code, Eclipse 등)에 Maven 지원이 통합되었습니다.

Homebrew를 사용하여 Maven 설치

  1. 터미널/명령 프롬프트 열기

  2. 명령 실행: $ brew install maven

  3. $ mvn -v 명령을 사용하여 Maven이 설치되었는지 확인합니다.

Maven 다운로드 및 설치

  1. Maven 다운로드

  2. Maven 설치

  3. 터미널/명령 프롬프트 열기

  4. $ mvn -v 명령을 사용하여 Maven이 설치되었는지 확인합니다.

Maven

Adobe I/O CLI 설정

Adobe I/O CLI 또는 aio은(는) Cloud Manager 및 Asset Compute을(를) 포함하여 다양한 Adobe 서비스에 대한 명령줄 액세스를 제공합니다. Adobe I/O CLI는 개발자에게 다음과 같은 기능을 제공하기 때문에 AEM as a Cloud Service에서 개발에 필수적인 역할을 합니다.

  • AEM as a Cloud Services의 테일 로그
  • CLI에서 Cloud Manager 파이프라인 관리
  • AEM 빠른 개발 환경에 배포

Adobe I/O CLI 설치

  1. Adobe I/O CLI가 npm 모듈이므로 Node.js가 설치되어 있는지 확인
    • node --version을(를) 실행하여 확인
  2. npm install -g @adobe/aio-cli을(를) 실행하여 aio npm 모듈을 전체적으로 설치합니다.

Adobe I/O CLI Cloud Manager 플러그인 설정

Adobe I/O Cloud Manager 플러그인을 사용하면 aio CLI가 aio cloudmanager 명령을 통해 Adobe Cloud Manager과 상호 작용할 수 있습니다.

  1. aio plugins:install @adobe/aio-cli-plugin-cloudmanager을(를) 실행하여 aio Cloud Manager 플러그인을(를) 설치합니다.

Adobe I/O CLI 인증 설정

Adobe I/O CLI가 Cloud Manager과 통신하려면 Adobe I/O 콘솔에서 Cloud Manager 통합을 만들어야하며, 인증하려면 자격 증명을 획득해야 합니다.

  1. console.adobe.io에 로그인

  2. 연결할 Cloud Manager 제품이 포함된 조직이 Adobe 조직 전환기에서 활성화되어 있는지 확인합니다.

  3. 새 프로그램을 만들거나 기존 Adobe I/O 프로그램 열기

    • Adobe I/O 콘솔 프로젝트는 통합 관리 방법을 기반으로 통합을 만들거나 사용 및 기존 프로젝트를 조직으로 그룹화한 것입니다.
    • 새 프로젝트를 만드는 경우 메시지가 표시되면 "빈 프로젝트"를 선택합니다(또는 "템플릿에서 만들기").
    • Adobe I/O 콘솔 프로그램은 Cloud Manager 프로그램과 다른 개념입니다

  4. 새 Cloud Manager API 통합 만들기

    • "Oauth 서버 간" 자격 증명 유형을 선택합니다.
    • "배포 관리자 - Cloud Service" 제품 프로필을 선택합니다.
    • 구성된 API 저장

  5. 새로 만든 "OAuth 서버 간" 자격 증명을 열고 오른쪽 상단 작업 표시줄에서 "JSON 다운로드"를 선택하여 자격 증명을 획득하려면 Adobe I/O CLI의 config.json을(를) 채워야 합니다.

  6. 다운로드한 JSON 파일을 열고 모든 키의 이름을 소문자로 바꿉니다. 예를 들어 CLIENT_ID은(는) client_id이(가) 됩니다.

  7. Adobe I/O CLI에 config.json 파일 로드

    • $ aio config:set ims.contexts.aio-cli-plugin-cloudmanager /path/to/downloaded/json --file --json

Adobe I/O CLI를 통해 Cloud Manager에 대해 명령 실행을 시작합니다.

AEM 빠른 개발 환경 플러그인 설정

AEM 빠른 개발 환경 플러그인을 사용하면 aio CLI가 aio aem:rde 명령을 통해 AEM as a Cloud Service 빠른 개발 환경과(와) 상호 작용할 수 있습니다.

  1. aio plugins:install @adobe/aio-cli-plugin-aem-rde을(를) 실행하여 AEM 빠른 개발 환경 플러그 인을(를) 설치합니다.

Adobe I/O CLI Asset Compute 플러그인 설정

Adobe I/O Cloud Manager 플러그인을 사용하면 aio CLI에서 aio asset-compute 명령을 통해 Asset Compute 작업자를 생성하고 실행할 수 있습니다.

  1. aio plugins:install @adobe/aio-cli-plugin-asset-compute을(를) 실행하여 aio Asset Compute 플러그인을(를) 설치합니다.

개발 IDE 설정

AEM 개발은 주로 Java 및 프론트엔드(JavaScript, CSS 등) 개발 및 XML 관리로 구성됩니다. 다음은 AEM 개발에 가장 인기 있는 IDE입니다.

IntelliJ IDEA

IntelliJ IDEA ​은(는) Java 개발용 강력한 IDE입니다. IntelliJ IDEA는 무료 커뮤니티 버전과 상용(유료) Ultimate 버전, 이렇게 두 가지 버전으로 제공됩니다. 사용 가능한 커뮤니티 버전은 AEM 개발에 충분하지만, Ultimate 이(가) 기능 집합을 확장합니다.

https://video.tv.adobe.com/v/39745?quality=12&learn=on&captions=kor
  • IntelliJ IDEA 다운로드
  • 보고서 도구 다운로드

Microsoft Visual Studio 코드

Visual Studio Code(VS Code)는 프런트 엔드 개발자를 위한 무료 오픈 소스 도구입니다. Visual Studio Code는 Adobe 도구인 repo ​를 사용하여 AEM과 콘텐츠 동기화를 통합하도록 설정할 수 있습니다.

Visual Studio Code는 주로 프론트엔드 코드인 JavaScript, CSS 및 HTML을 만드는 프론트엔드 개발자에게 이상적인 선택입니다. VS 코드는 확장을 통해 Java를 지원하지만 더 많은 Java용으로 제공되는 일부 고급 기능이 부족할 수 있습니다.

https://video.tv.adobe.com/v/25907?quality=12&learn=on
  • Visual Studio 코드 다운로드
  • 보고서 도구 다운로드
  • AEM 동기화 VS 코드 확장 다운로드

Eclipse

Eclipse IDE ​은(는) Java 개발용으로 많이 사용되는 IDE이며 Adobe에서 제공하는 AEM 개발자 도구 플러그인을 지원하며, 작성에 IDE 내 GUI를 제공하고 JCR 콘텐츠를 로컬 AEM 인스턴스와 동기화합니다.

https://video.tv.adobe.com/v/25906?quality=12&learn=on
  • Eclipse 다운로드
  • Eclipse 개발 도구 다운로드
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69