변수 수준

프로젝트 변수는 프로젝트 내의 모든 환경에 적용됩니다. 환경 변수는 특정 환경 또는 분기에 적용됩니다. 환경 부모 환경에서 변수 정의를 상속 ​합니다.

환경에 특별히 변수를 정의하여 상속된 값을 재정의할 수 있습니다. 예를 들어 개발에 사용할 변수를 설정하려면 통합 환경의 .magento.env.yaml 파일에 변수 값을 정의하십시오. 통합 환경에서 분기하는 모든 환경은 해당 값을 상속합니다. .magento.env.yaml 파일을 사용하여 환경을 구성하는 방법에 대한 자세한 내용은 배포 구성을 참조하세요.

CLI

Cloud CLI를 사용하여 변수를 설정하려면:

  • 프로젝트별 변수—프로젝트의 모든 환경에 대해 동일한 값을 설정합니다. 이러한 변수는 모든 환경의 빌드 및 런타임에 사용할 수 있습니다.

    code language-bash
    magento-cloud variable:create --level project --name <variable-name> --value <variable-value>
    
  • 환경별 변수 - 특정 환경에 대한 고유한 값을 설정합니다. 이러한 변수는 런타임 시 사용할 수 있으며 하위 환경에 상속됩니다. -e 옵션을 사용하여 명령에 환경을 지정하십시오.

    code language-bash
    magento-cloud variable:create --level environment --name <variable-name> --value <variable-value>
    

프로젝트별 변수를 설정한 후에는 변경 사항을 적용하려면 원격 환경을 수동으로 다시 배포해야 합니다. 재배포를 트리거하기 위해 새 커밋을 푸시합니다.

콘솔

변수를 설정하려면Cloud Console ​을(를) 사용합니다.

  1. Cloud Console ​에서 프로젝트 탐색 오른쪽의 구성 아이콘을 클릭합니다.

    프로젝트 구성 {width="36"}

  2. 프로젝트 수준 변수를 설정하려면 프로젝트 설정 ​에서 변수 ​을 클릭하십시오.

    프로젝트 변수

  3. 환경 수준 변수를 설정하려면 환경 목록에서 환경을 선택하고 Variables 탭을 클릭하십시오.

    환경 변수 탭

  4. Create variable ​을(를) 클릭합니다.

  5. 변수의 이름과 값을 입력합니다. 다음 옵션 중에서 선택합니다.

    • 런타임 중에 사용 가능
    • 작성 시간 동안 사용 가능
    • JSON 값
    • 중요한 변수(콘솔 및 CLI 응답에서 숨겨진 값)
    • 상속 가능(하위 환경이 환경 수준 변수를 상속할 수 있음)
  6. Create variable ​을(를) 클릭합니다.

note caution
CAUTION
Cloud Console에서 환경별 변수를 설정하면 환경이 자동으로 다시 배포됩니다.

가시성

--visible-<build|runtime> 명령을 사용하여 빌드 또는 런타임 중에 변수의 가시성을 제한할 수 있습니다. 상속과 민감도를 설정하는 옵션도 있습니다.

변수가 보이거나 상속되지 않도록 하려면 다음 옵션을 사용하십시오.

  • --inheritable false - 하위 환경의 상속을 비활성화합니다. 이 기능은 master 분기에서 프로덕션 전용 값을 설정하고 다른 모든 환경에서 동일한 이름의 프로젝트 수준 변수를 사용할 수 있도록 하는 데 유용합니다.
  • --sensitive true—변수를 Cloud Console에서 읽을 수 없음(으)로 표시합니다. 사용자 인터페이스에서는 변수를 볼 수 없지만 다른 변수와 마찬가지로 응용 프로그램 컨테이너에서는 변수를 볼 수 있습니다.

다음은 변수가 보이거나 상속되지 않도록 하는 특정 사례를 보여 줍니다. CLI에서는 이러한 옵션만 지정할 수 있습니다. 이 경우 사용 가능한 모든 환경 변수와 관련이 없습니다.

magento-cloud variable:create --name <variable-name> --value <variable-value> --inheritable false --sensitive true

변수 수준 및 값 확인

Cloud CLI를 사용하여 기존 변수 목록을 볼 수 있습니다.

magento-cloud variables
Variables on the project Project-Name (<project-id>), environment <environment-name>:
+----------------------------+-------------+-------------------------------------------+
| Name                       | Level       | Value                                     |
+----------------------------+-------------+-------------------------------------------+
| env:COMPOSER_AUTH          | project     | {                                         |
|                            |             |    "http-basic": {                        |
|                            |             |       "repo.magento.com": {               |
|                            |             |       "username":                         |
|                            |             | "<public-key>",                           |
|                            |             |       "password":                         |
|                            |             | "<private-key>"                           |
|                            |             |     }                                     |
|                            |             |   }                                       |
|                            |             | }                                         |
| ADMIN_EMAIL                | project     | admin@123.com                             |
| ADMIN_EMAIL                | environment | admin@123.com                             |
| ADMIN_PASSWORD             | environment | password                                  |
| ADMIN_URL                  | environment | admin123                                  |
| ADMIN_USERNAME             | environment | admin                                     |
| php:newrelic.license       | environment | xxxx71fb030366182117f955a22e4baf8exxxxxx  |
+----------------------------+-------------+-------------------------------------------+
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26