설명서AEM as a Cloud Service사용 안내서

Cloud Manager의 환경 변수

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager as a Cloud Service
  • 주제:
  • Cloud Manager
  • 개발

작성 대상:

  • 관리자
  • 개발자

표준 환경 변수는 Cloud Manager를 통해 구성 및 관리할 수 있습니다. 런타임 환경에 제공되며 OSGi 구성에서 사용할 수 있습니다.

환경 변수는 변경되는 내용에 따라 환경별 값 또는 환경 비밀일 수 있습니다.

환경 변수 정보

환경 변수는 AEM as a Cloud Service 사용자에게 다음과 같은 이점을 제공합니다.

  • 이를 통해 코드와 애플리케이션의 비헤이비어가 컨텍스트와 환경에 따라 달라질 수 있습니다. 예를 들어 비용이 많이 드는 실수를 피하기 위해 프로덕션 또는 스테이징 환경과 비교하여 개발 환경에서 다른 구성을 활성화하는 데 사용할 수 있습니다.
  • 한 번만 구성 및 설정하면 되며 필요할 때 업데이트 및 삭제할 수 있습니다.
  • 해당 값은 언제든지 업데이트할 수 있으며 코드를 변경하거나 배포할 필요 없이 즉시 적용됩니다.
  • 구성에서 코드를 분리하여 버전 제어에 민감한 정보를 포함할 필요가 없습니다.
  • 코드 외부에 있기 때문에 AEM as a Cloud Service 애플리케이션의 보안을 향상시킵니다.

환경 변수를 사용하는 일반적인 사용 사례는 다음과 같습니다.

  • AEM 애플리케이션을 다양한 외부 엔드포인트와 연결
  • 코드베이스에 직접 저장하는 대신 암호 저장 시 참조 사용
  • 프로그램에 여러 개발 환경이 존재하고 일부 구성이 환경마다 다른 경우

환경 변수 추가

Adobe 여러 변수를 추가하려면 첫 번째 변수를 추가한 다음 환경 구성 대화 상자에서 추가 아이콘 추가 ​을 사용하여 변수를 추가하는 것이 좋습니다. 이 메서드는 한 번의 업데이트로 환경에 추가할 수 있음을 의미합니다.

환경 변수를 추가, 업데이트 또는 삭제하려면 배포 관리자 역할의 구성원이어야 합니다.

환경 변수를 추가하려면:

  1. my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직을 선택합니다.

  2. 내 프로그램 콘솔에서 관리할 프로그램을 선택합니다.

  3. 사이드 메뉴에서 환경 ​을 클릭합니다.

  4. 환경 페이지에서 환경 변수를 추가할 환경이 있는 테이블의 행을 선택합니다.

  5. 환경의 세부 정보 페이지에서 구성 탭을 클릭합니다.

  6. 추가/업데이트 - 원 아이콘 추가 추가/업데이트 ​를 클릭합니다.
    환경 변수를 처음 추가하는 경우 페이지 중앙에 있는 구성 추가 ​를 클릭합니다.

    구성 탭

  7. 환경 구성 대화 상자에서 표의 첫 행에 세부 정보를 입력합니다.

    필드
    설명
    이름

    구성 변수의 고유 이름입니다. 환경에서 사용되는 특정 변수를 식별합니다. 다음 명명 규칙을 준수해야 합니다.

    • 변수에는 영숫자와 밑줄(_)만 포함될 수 있습니다.
    • 환경당 200개의 변수 제한이 있습니다.
    • 각 이름은 100자 이하여야 합니다.
    값
    변수가 보유한 값입니다.
    적용된 단계

    변수가 적용되는 서비스를 선택합니다. 모든 서비스에 변수를 적용하려면 모두 ​를 선택하십시오.

    • 모두
    • 작성자
    • Publish
    • 미리보기
    유형
    변수가 일반인지 비밀인지 선택합니다.

    변수 추가

  8. 추가 아이콘 추가 ​을 클릭합니다.

    필요에 따라 변수를 추가합니다.

  9. 저장 ​을 클릭합니다.

    업데이트 중 상태의 회전기가 표의 오른쪽 위 모서리에 표시됩니다. 새로 추가된 변수의 왼쪽에는 회전기가 표시됩니다. 이러한 상태는 구성이 적용되어 환경이 업데이트되고 있음을 나타냅니다. 완료된 후에 새 환경 변수가 표에 표시됩니다.

변수 업데이트

환경 변수 업데이트

환경 변수를 만든 후에는 추가/업데이트 - 원형 추가 아이콘 추가/업데이트 ​를 사용하여 업데이트하여 환경 구성 대화 상자를 열 수 있습니다.

Adobe 여러 변수를 업데이트하려면 저장 ​을 클릭하기 전에 환경 구성 대화 상자를 사용하여 필요한 모든 변수를 한 번에 업데이트하는 것이 좋습니다. 이렇게 하면 한 번의 업데이트로 환경에 여러 변수를 추가할 수 있습니다.

환경 변수를 업데이트하려면:

  1. my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직을 선택합니다.

  2. 내 프로그램 콘솔에서 관리할 프로그램을 선택합니다.

  3. 사이드 메뉴에서 환경 ​을 클릭합니다.

  4. 환경 페이지에서 변수를 업데이트할 환경이 있는 테이블의 행을 선택합니다.

  5. 환경의 세부 정보 페이지에서 구성 탭을 클릭합니다.

  6. 추가/업데이트 - 원 아이콘 추가 추가/업데이트 ​를 클릭합니다.

  7. 환경 구성 대화 상자에서 변경할 변수 행의 마지막 열에 있는 줄임표 - 자세히 아이콘 을 클릭합니다.

  8. 드롭다운 메뉴에서 편집 ​을 클릭합니다.

    변수 편집 또는 삭제

  9. 필요에 따라 환경 변수의 값을 업데이트합니다.
    암호를 편집할 때 값은 볼 수 없고 업데이트만 가능합니다.

    변수 편집

  10. 다음 중 하나를 수행하십시오.

    • 변경 내용을 적용하려면 적용 - 확인 표시 아이콘 을 클릭하십시오.
    • 변경을 취소하려면 실행 취소 아이콘 을 클릭하십시오.
  11. 저장 ​을 클릭합니다.

    업데이트 중 상태의 회전기가 표의 오른쪽 위 모서리에 표시됩니다. 업데이트된 변수 왼쪽에 회전기가 나타나기도 합니다. 이러한 상태는 구성이 적용되어 환경이 업데이트되고 있음을 나타냅니다. 완료되면 업데이트된 환경 변수가 표에 표시됩니다.

환경 변수 삭제

  1. my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직을 선택합니다.
  2. 내 프로그램 콘솔에서 관리할 프로그램을 선택합니다.
  3. 사이드 메뉴에서 환경 ​을 클릭합니다.
  4. 환경 페이지에서 변수를 업데이트할 환경이 있는 테이블의 행을 선택합니다.
  5. 환경의 세부 정보 페이지에서 구성 탭을 클릭합니다.
  6. 추가/업데이트 - 원 아이콘 추가 추가/업데이트 ​를 클릭합니다.
  7. 환경 구성 대화 상자에서 변경할 변수 행의 마지막 열에 있는 줄임표 - 자세히 아이콘 을 클릭합니다.
  8. 드롭다운 메뉴에서 삭제 ​를 클릭하여 변수를 즉시 제거합니다.
  9. 저장 ​을 클릭합니다.

환경 변수 사용

환경 변수를 사용하면 pom.xml 구성을 보다 안전하고 유연하게 만들 수 있습니다. 예를 들어 암호를 하드 코딩할 필요가 없으며 환경 변수의 값을 기반으로 구성을 조정할 수 있습니다.

다음과 같이 XML을 통해 환경 변수 및 비밀에 액세스할 수 있습니다.

${env.VARIABLE_NAME}

pom.xml 파일에서 두 가지 유형의 변수를 모두 사용하는 방법에 대한 예는 프로젝트 설정을 참조하십시오.

자세한 내용은 공식 Maven 설명서를 참조하십시오.

환경 변수 가용성

환경 변수는 다음과 같이 여러 위치에서 사용할 수 있습니다.

환경 변수를 사용할 수 있는 경우
설명
작성, 미리보기 및 게시
일반 환경 변수와 비밀은 작성, 미리보기 및 게시 환경에서 사용할 수 있습니다.
Dispatcher

Dispatcher에서는 일반 환경 변수만 사용할 수 있습니다.

  • 시크릿은 사용할 수 없습니다.
  • IfDefine 지시문에서는 환경 변수를 사용할 수 없습니다.
  • 배포하기 전에 로컬에서 Dispatcher를 사용하여 환경 변수 사용을 확인합니다.
OSGi 구성
OSGi 구성에서 일반 환경 변수와 암호를 모두 사용할 수 있습니다.
파이프라인 변수
환경 변수 외에도 빌드 단계 중에 노출되는 파이프라인 변수도 있습니다. 빌드 환경의 파이프라인 변수에 대해 자세히 알아보세요.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab