배포를 위한 환경 변수 구성

.magento.env.yaml 파일은 환경 변수를 사용하여 Pro Staging 및 Production을 비롯한 모든 환경에서 빌드 및 배포 작업을 중앙 집중식으로 관리합니다. 각 환경에서 고유한 작업을 구성하려면 각 환경에서 이 파일을 수정해야 합니다.

파일 구조

.magento.env.yaml 파일에 두 개의 섹션(stage 및 log)이 있습니다. stage 섹션은 클라우드 배포 프로세스의 단계 동안 발생하는 작업을 제어합니다.

환경 변수

ece-tools 패키지는 클라우드 변수, Cloud Console에 설정된 변수 및 .magento.env.yaml 구성 파일의 값을 기반으로 env.php 파일에 값을 설정합니다. .magento.env.yaml 파일의 환경 변수는 기존 Commerce 구성을 재정의하여 클라우드 환경을 사용자 지정합니다. 기본값이 Not Set이면 ece-tools 패키지는 NO 동작을 수행하고 Commerce 기본값 또는 MAGENTO_CLOUD_RELATIONSHIPS 구성의 값을 사용합니다. 기본값이 설정되면 ece-tools 패키지가 해당 기본값을 설정하는 역할을 합니다.

다음 항목에는 .magento.env.yaml 파일에서 사용할 수 있는 모든 변수에 대해 기본값이 설정되었는지 여부와 같은 자세한 정의가 포함됩니다.

CLI에서 구성 파일 생성

다음 ece-tools 명령을 사용하여 클라우드 환경에 대한 .magento.env.yaml 구성 파일을 생성할 수 있습니다.

구성 파일 만들기

php ./vendor/bin/ece-tools cloud:config:create `<configuration-json>`

구성 파일의 값 업데이트

php ./vendor/bin/ece-tools cloud:config:update `<configuration-json>`

두 명령 모두 하나 이상의 빌드, 배포 또는 배포 후 변수에 대한 값을 지정하는 JSON 형식의 배열이라는 단일 인수가 필요합니다. 예를 들어 다음 명령은 SCD_THREADS 및 CLEAN_STATIC_FILES 변수에 대한 값을 설정합니다.

php vendor/bin/ece-tools cloud:config:create '{"stage":{"build":{"SCD_THREADS":5}, "deploy":{"CLEAN_STATIC_FILES":false}}}'

다음 설정으로 .magento.env.yaml 파일을 만듭니다.

stage:
  build:
    SCD_THREADS: 5
  deploy:
    CLEAN_STATIC_FILES: false

cloud:config:update 명령을 사용하여 새 파일을 업데이트할 수 있습니다. 예를 들어 다음 명령은 SCD_THREADS 값을 변경하고 SCD_COMPRESSION_TIMEOUT 구성을 추가합니다.

php vendor/bin/ece-tools cloud:config:update '{"stage":{"build":{"SCD_THREADS":3, "SCD_COMPRESSION_TIMEOUT":1000}}}'

업데이트된 파일에는 다음 구성이 포함됩니다.

stage:
  build:
    SCD_THREADS: 3
    SCD_COMPRESSION_TIMEOUT: 1000
  deploy:
    CLEAN_STATIC_FILES: false

구성 파일 유효성 검사

원격 클라우드 환경에 변경 사항을 푸시하기 전에 다음 ece-tools 명령을 사용하여 .magento.env.yaml 구성 파일의 유효성을 검사하십시오.

php ./vendor/bin/ece-tools cloud:config:validate

다음 샘플 응답은 수정할 항목 목록을 제공합니다.

Environment configuration is not valid. Correct the following items in your .magento.env.yaml file:
The SCD_THREADS variable contains an invalid value of type string. Use the following type: integer.
The SCD_STRATEGY variable contains an invalid value fast. Use one of the available value options: compact, quick, standard.
The NOT_EXIST_OPTION variable is not allowed in configuration.

PHP 상수

하드 코딩 값 대신 .magento.env.yaml 파일 정의에 PHP 상수를 사용할 수 있습니다. 다음 예제에서는 PHP 상수를 사용하여 driver_options을(를) 정의합니다.

stage:
  deploy:
    DATABASE_CONFIGURATION:
      connection:
        default:
          driver_options:
            !php/const:\PDO::MYSQL_ATTR_LOCAL_INFILE : 1
        indexer:
          driver_options:
            !php/const:\PDO::MYSQL_ATTR_LOCAL_INFILE : 1
      _merge: true

오류 처리

.magento.env.yaml 구성 파일에 예기치 않은 값이 있어 오류가 발생하면 오류 메시지가 표시됩니다. 예를 들어, 다음 오류 메시지는 예기치 않은 값이 있는 각 항목에 대해 제안된 변경 사항 목록을 나타내며 경우에 따라 유효한 옵션을 제공합니다.

- Environment configuration is not valid. Please correct .magento.env.yaml file with next suggestions:
  Item CRON_CONSUMERS_RUNNER is not supposed to be in stage build. Please move it to one of possible stages: global, deploy
  Item SKIP_SCD has unexpected type string. Please use one of next types: boolean
  Item VERBOSE_COMMANDS has unexpected type boolean. Please use one of next types: string
  Item SKIP_HTML_MINIFICATION has unexpected type string. Please use one of next types: boolean
  Item CRON_CONSUMERS_RUNNER has unexpected type boolean. Please use one of next types: array
  Item VAR_WARM_UP_PAGES is not allowed in configuration.
  Item WARM_UP_PAGES has unexpected type string. Please use one of next types: array

모든 수정, 커밋 및 변경 사항 푸시 오류 메시지가 표시되지 않으면 구성 파일의 변경 사항이 유효성 검사를 통과합니다.

구성 관리 최적화

구성을 덤프한 후 구성 관리를 활성화한 경우 SCD_* 변수를 배포에서 빌드 단계로 이동해야 합니다. 정적 콘텐츠 배포 전략을 참조하세요.

구성 관리 전:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...
    REDIS_USE_SLAVE_CONNECTION: 1

구성 관리를 활성화한 후 SCD_* 변수를 빌드 단계로 이동합니다.

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    REDIS_USE_SLAVE_CONNECTION: 1
  build:
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...