Cloud Manager의 환경 변수 environment-variables

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

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

환경 변수 정보 overview

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

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

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

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

환경 변수 추가 add-variables

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

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

환경 변수를 추가하려면:

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

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

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

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

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

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

    구성 탭

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

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    필드 설명
    이름

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

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

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

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

    변수 추가

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

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

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

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

변수 업데이트

환경 변수 업데이트 update-variables

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

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

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

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

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

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

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

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

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

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

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

    변수 편집 또는 삭제

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

    변수 편집

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

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

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

환경 변수 삭제 delete-env-variable

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

환경 변수 사용 using

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

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

${env.VARIABLE_NAME}

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

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

환경 변수 가용성 availability

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

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

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

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