[PaaS만]{class="badge informative" title="Adobe Commerce 온 클라우드 프로젝트(Adobe 관리 PaaS 인프라) 및 온프레미스 프로젝트에만 적용됩니다."}

변수 배포

다음 배포 변수는 배포 단계에서 작업을 제어하며 전역 변수에서 값을 상속하고 재정의할 수 있습니다. .magento.env.yaml 파일의 deploy 단계에 다음 변수를 삽입합니다.

stage:
  deploy:
    DEPLOY_VARIABLE_NAME: value

빌드 및 배포 프로세스 사용자 지정에 대한 자세한 내용은 다음을 참조하십시오.

CACHE_CONFIGURATION

Redis 페이지 및 기본 캐싱을 구성합니다. cm_cache_backend_redis 매개 변수를 설정할 때는 server, port 및 database 옵션을 지정해야 합니다.

stage:
  deploy:
    CACHE_CONFIGURATION:
      frontend:
        default:
          backend: file
        page_cache:
          backend: file

기본적으로 배포 프로세스는 env.php 파일의 모든 설정을 덮어쓰지만 모든 값을 덮어쓰지 않고 서비스 구성에 대해 하나 이상의 값을 병합하도록 선택할 수 있습니다.

_merge 옵션을 다음 중 하나로 설정하십시오.

다음 예제에서는 새 값을 기존 구성에 병합합니다.

stage:
  deploy:
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          backend_options:
            database: 10
        page_cache:
          backend_options:
            database: 11

다음 예제에서는 구성 안내서​에 정의된 대로 Redis 미리 로드 기능을 사용합니다.

stage:
  deploy:
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          id_prefix: '061_'
          backend_options:
            preload_keys:
              - '061_EAV_ENTITY_TYPES:hash'
              - '061_GLOBAL_PLUGIN_LIST:hash'
              - '061_DB_IS_UP_TO_DATE:hash'
              - '061_SYSTEM_DEFAULT:hash'

사용자 지정 REDIS_BACKEND 모델(허용 목록에서만)을 사용하려면 _custom_redis_backend 옵션을 true(으)로 설정하여 다음 예제와 같이 올바른 유효성 검사를 사용하도록 설정하십시오.

stage:
  deploy:
    CACHE_CONFIGURATION:
      frontend:
        default:
          _custom_redis_backend: true
          backend: '\CustomRedisModel'

CLEAN_STATIC_FILES

빌드 또는 배포 단계에서 생성된 정적 콘텐츠 파일을(를) 정리하거나 사용하지 않도록 설정합니다. 개발에서 기본값 true​을(를) 사용하는 것이 좋습니다.

별도의 프로세스를 통해 정적 콘텐츠를 수정하는 경우 값을 false(으)로 설정하십시오.

stage:
  deploy:
    CLEAN_STATIC_FILES: false

배포 전에 정적 보기 파일을 정리하지 않으면 이전 버전을 제거하지 않고 기존 파일에 업데이트를 배포할 경우 문제가 발생할 수 있습니다. 정적 파일 대체 규칙으로 인해 디렉터리에 동일한 파일의 버전이 여러 개 있는 경우 대체 작업에 잘못된 파일이 표시될 수 있습니다.

CRON_CONSUMERS_RUNNER

이 환경 변수를 사용하여 배포 후 메시지 큐가 실행 중인지 확인하십시오.

각 소비자에 대해 생성할 특정 consumers 및 multiple_processes을(를) 실행하는 예제 배열:

stage:
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 1000
      consumers:
        - example_consumer_1
        - example_consumer_2
-     multiple_processes:
        example_consumer_1: 4
        example_consumer_2: 3

consumers을(를) 모두 실행하는 빈 배열의 예:

stage:
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 1000
      consumers: []

기본적으로 배포 프로세스는 env.php 파일의 모든 설정을 덮어씁니다. 온-프레미스 Adobe Commerce에 대해서는 Commerce 구성 가이드​의 메시지 큐 관리를 참조하세요.

CONSUMERS_WAIT_FOR_MAX_MESSAGES

다음 옵션 중 하나를 선택하여 consumers에서 메시지 큐의 메시지를 처리하는 방법을 구성하십시오.

stage:
  deploy:
    CONSUMERS_WAIT_FOR_MAX_MESSAGES: false

CRYPT_KEY

설치 프로세스 없이 데이터베이스를 한 환경에서 다른 환경으로 이동할 때는 해당 암호화 정보가 필요합니다. Adobe Commerce에서는 Cloud Console에 설정된 암호화 키 값을 env.php 파일의 crypt/key 값으로 사용합니다.

DATABASE_CONFIGURATION

.magento.app.yaml 파일의 관계 속성에서 데이터베이스를 정의한 경우 배포를 위해 데이터베이스 연결을 사용자 지정할 수 있습니다.

stage:
  deploy:
    DATABASE_CONFIGURATION:
      some_config: 'some_value'

기본적으로 배포 프로세스는 env.php 파일의 모든 설정을 덮어쓰지만 모든 값을 덮어쓰지 않고 서비스 구성에 대해 하나 이상의 값을 병합하도록 선택할 수 있습니다.

_merge 옵션을 다음 중 하나로 설정하십시오.

다음 예제에서는 새 값을 기존 구성에 병합합니다.

stage:
  deploy:
    DATABASE_CONFIGURATION:
      some_config: 'some_new_value'
      _merge: true

또한 테이블 접두사를 구성할 수 있습니다.

다음 예제에서는 _merge 옵션 대신 기본 연결 설정과 함께 ece_ 테이블 접두사를 사용합니다.

stage:
  deploy:
    DATABASE_CONFIGURATION:
      connection:
        default:
          username: user
          host: host
          dbname: magento
          password: password
      table_prefix: 'ece_'

샘플 출력:

MariaDB [main]> SHOW TABLES;
+-------------------------------------+
| Tables_in_main                      |
+-------------------------------------+
| ece_admin_passwords                 |
| ece_admin_system_messages           |
| ece_admin_user                      |
| ece_admin_user_session              |
| ece_adminnotification_inbox         |
| ece_amazon_customer                 |
| ece_authorization_rule              |
| ece_cache                           |
| ece_cache_tag                       |
| ece_captcha_log                     |
...

ELASTICSUITE_CONFIGURATION

배포 간에 사용자 지정된 Elastic Suite 서비스 설정을 유지하고 기본 Elastic Suite 구성의 'system/default/smile_elasticsuite_core_base_settings' 섹션에서 사용합니다. Elastic Suite 작성기 패키지가 설치되어 있으면 자동으로 구성됩니다.

stage:
  deploy:
    ELASTICSUITE_CONFIGURATION:
      es_client:
        servers: 'remote-host:9200'
      indices_settings:
        number_of_shards: 1
        number_of_replicas: 0

           indices_settings:
               number_of_shards: 3
               number_of_replicas: 2

기본적으로 배포 프로세스는 env.php 파일의 모든 설정을 덮어쓰지만 모든 값을 덮어쓰지 않고 서비스 구성에 대해 하나 이상의 값을 병합하도록 선택할 수 있습니다.

_merge 옵션을 다음 중 하나로 설정하십시오.

다음 예제에서는 새 값을 기존 구성에 병합합니다.

stage:
  deploy:
    ELASTICSUITE_CONFIGURATION:
      indices_settings:
        number_of_shards: 3
        number_of_replicas: 2
      _merge: true

알려진 제한 사항:

ENABLE_GOOGLE_ANALYTICS

스테이징 및 통합 환경에 배포할 때 Google Analytics을 활성화하고 비활성화합니다. 기본적으로 Google Analytics은 프로덕션 환경에만 true입니다. 스테이징 및 통합 환경에서 Google Analytics을 사용하려면 이 값을 true(으)로 설정하십시오.

ENABLE_GOOGLE_ANALYTICS 환경 변수를 .magento.env.yaml 파일의 deploy 단계에 추가합니다.

stage:
  deploy:
    ENABLE_GOOGLE_ANALYTICS: true

FORCE_UPDATE_URLS

Pro 또는 스타터 스테이징 및 프로덕션 환경에 배포할 때 이 변수는 데이터베이스의 Adobe Commerce 기본 URL을 MAGENTO_CLOUD_ROUTES 변수에 지정된 프로젝트 URL로 바꿉니다. 스테이징 또는 프로덕션 환경에 배포할 때 무시되는 UPDATE_URLS 배포 변수의 기본 동작을 무시하려면 이 설정을 사용합니다.

stage:
  deploy:
    FORCE_UPDATE_URLS: true

LOCK_PROVIDER

잠금 공급자는 중복 크론 작업 및 크론 그룹의 시작을 방지합니다. 프로덕션 환경에서 file 잠금 공급자를 사용합니다. 스타터 환경 및 Pro 통합 환경에서는 MAGENTO_CLOUD_LOCKS_DIR 변수를 사용하지 않으므로 ece-tools이(가) db 잠금 공급자를 자동으로 적용합니다.

stage:
  deploy:
    LOCK_PROVIDER: "db"

설치 가이드​에서 잠금 구성을 참조하십시오.

MYSQL_USE_SLAVE_CONNECTION

Adobe Commerce은 여러 데이터베이스를 비동기식으로 읽을 수 있습니다. 데이터베이스에 대한 읽기 전용 연결을 자동으로 사용하여 마스터가 아닌 노드에서 읽기 전용 트래픽을 받도록 true(으)로 설정하십시오. 이 연결은 한 노드만 읽기/쓰기 트래픽을 처리하기 때문에 로드 밸런싱을 통해 성능을 향상시킵니다. env.php 파일에서 기존 읽기 전용 연결 배열을 제거하려면 false(으)로 설정하십시오.

stage:
  deploy:
    MYSQL_USE_SLAVE_CONNECTION: true

MYSQL_USE_SLAVE_CONNECTION 변수가 true(으)로 설정되면 Pro 스테이징 및 프로덕션 환경의 env.php 파일에서 synchronous_replication 매개 변수는 기본적으로 true(으)로 설정됩니다. MYSQL_USE_SLAVE_CONNECTION을(를) false(으)로 설정하면 synchronous_replication 매개 변수가 구성되지 않습니다.

QUEUE_CONFIGURATION

이 환경 변수를 사용하여 배포 간에 사용자 지정된 큐 서비스 설정을 유지합니다. 이 변수는 AMQP(RabbitMQ의 경우) 및 STOMP(ActiveMQ Artemis의 경우) 프로토콜을 모두 지원합니다. 예를 들어, 클라우드 인프라에 의존하지 않고 기존 메시지 큐 서비스를 사용하여 자동으로 만들고자 하는 경우 QUEUE_CONFIGURATION 환경 변수를 사용하여 사이트에 연결하십시오.

stage:
  deploy:
    QUEUE_CONFIGURATION:
      amqp:
        host: test.host
        port: 1234
      amqp2:
        host: test.host2
        port: 12345
      mq:
        host: mq.host
        port: 1234

STOMP 프로토콜을 사용하는 ActiveMQ Artemis의 경우:

stage:
  deploy:
    QUEUE_CONFIGURATION:
      stomp:
        host: activemq.host
        port: 61616
        user: username
        password: password

기본적으로 배포 프로세스는 env.php 파일의 모든 설정을 덮어쓰지만 모든 값을 덮어쓰지 않고 서비스 구성에 대해 하나 이상의 값을 병합하도록 선택할 수 있습니다.

_merge 옵션을 다음 중 하나로 설정하십시오.

다음 예제에서는 새 값을 기존 구성에 병합합니다.

stage:
  deploy:
    QUEUE_CONFIGURATION:
      _merge: true
      amqp:
        host: changed1.host
        port: 5672
      amqp2:
        host: changed2.host2
        port: 12345
      mq:
        host: changedmq.host
        port: 1234

REDIS_BACKEND

Redis 캐시에 대한 백엔드 모델 구성을 지정합니다.

Adobe Commerce 버전 2.3.0 이상에는 다음 백엔드 모델이 포함되어 있습니다.

REDIS_BACKEND을(를) 설정하는 방법의 예

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

REDIS_USE_SLAVE_CONNECTION

Adobe Commerce은 여러 Redis 인스턴스를 비동기식으로 읽을 수 있습니다. Redis 인스턴스에 대한 읽기 전용 연결을 자동으로 사용하여 마스터가 아닌 노드에서 읽기 전용 트래픽을 받도록 하려면 true(으)로 설정하십시오. 이 연결은 한 노드만 읽기/쓰기 트래픽을 처리하기 때문에 로드 밸런싱을 통해 성능을 향상시킵니다. env.php 파일에서 기존 읽기 전용 연결 배열을 제거하려면 false(으)로 설정하십시오.

stage:
  deploy:
    REDIS_USE_SLAVE_CONNECTION: true

.magento.app.yaml 파일 및 services.yaml 파일에 Redis 서비스가 구성되어 있어야 합니다.

ECE-Tools 버전 2002.0.18 이상에서는 내결함성 설정을 더 많이 사용합니다. Adobe Commerce에서 Redis 슬레이브 인스턴스에서 데이터를 읽을 수 없는 경우 Redis 마스터 인스턴스에서 데이터를 읽습니다.

통합 환경에서 또는 CACHE_CONFIGURATION 변수을(를) 사용하는 경우 읽기 전용 연결을 사용할 수 없습니다.

VALKEY_BACKEND

VALKEY_BACKEND은(는) Valkey 캐시에 대한 백엔드 모델 구성을 지정합니다.

Adobe Commerce 버전 2.8.0 이상에는 다음 백엔드 모델이 포함되어 있습니다.

다음 예제에서는 VALKEY_BACKEND을(를) 설정하는 방법을 설명합니다.

stage:
  deploy:
  VALKEY_USE_SLAVE_CONNECTION: true
  VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

VALKEY_USE_SLAVE_CONNECTION

Adobe Commerce은 여러 Redis 인스턴스를 비동기식으로 읽을 수 있습니다. VALKEY_USE_SLAVE_CONNECTION Redis 인스턴스에 대한 읽기 전용 연결을 자동으로 사용하여 마스터가 아닌 노드에서 읽기 전용 트래픽을 받도록 하려면 true(으)로 설정하십시오. 이 연결은 한 노드만 읽기/쓰기 트래픽을 처리하기 때문에 로드 밸런싱을 통해 성능을 향상시킵니다. env.php 파일에서 기존 읽기 전용 연결 배열을 제거하려면 VALKEY_USE_SLAVE_CONNECTION을(를) false(으)로 설정하십시오.

stage:
  deploy:
    VALKEY_USE_SLAVE_CONNECTION: true

.magento.app.yaml 파일 및 services.yaml 파일에 Redis 서비스가 구성되어 있어야 합니다.

ECE-Tools 버전 2002.0.18 이상에서는 내결함성 설정을 더 많이 사용합니다. Adobe Commerce에서 Valkey slave 인스턴스에서 데이터를 읽을 수 없는 경우 Redis master 인스턴스에서 데이터를 읽습니다.

통합 환경에서 또는 CACHE_CONFIGURATION 변수을(를) 사용하는 경우 읽기 전용 연결을 사용할 수 없습니다.

RESOURCE_CONFIGURATION

리소스 이름을 데이터베이스 연결에 매핑합니다. 이 구성은 env.php 파일의 resource 섹션에 해당합니다.

기본적으로 배포 프로세스는 env.php 파일의 모든 설정을 덮어쓰지만 모든 값을 덮어쓰지 않고 서비스 구성에 대해 하나 이상의 값을 병합하도록 선택할 수 있습니다.

_merge 옵션을 다음 중 하나로 설정하십시오.

다음 예제에서는 새 값을 기존 구성에 병합합니다.

stage:
  deploy:
    RESOURCE_CONFIGURATION:
      _merge: true
      default_setup:
        connection: default

SCD_COMPRESSION_LEVEL

정적 콘텐츠를 압축할 때 사용할 gzip 압축 수준(0 ~ 9)을 지정합니다. 0은(는) 압축을 사용하지 않도록 설정합니다.

stage:
  deploy:
    SCD_COMPRESSION_LEVEL: 5

SCD_COMPRESSION_TIMEOUT

정적 자산을 압축하는 데 걸리는 시간이 압축 시간 제한 을 초과하면 배포 프로세스를 중단합니다. 정적 콘텐츠 압축 명령의 최대 실행 시간(초)을 설정합니다.

stage:
  deploy:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_MATRIX

테마당 여러 로케일을 구성할 수 있습니다. 이 맞춤화는 불필요한 테마 파일의 수를 줄여 배포 프로세스를 가속화합니다. 예를 들어 magento/backend 테마는 영어로, 사용자 지정 테마는 다른 언어로 배포할 수 있습니다.

다음 예제에서는 세 개의 로케일로 Magento/backend 테마를 배포합니다.

stage:
  deploy:
    SCD_MATRIX:
      "magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA

또한 테마를 배포하지 않도록 선택할 수 있습니다.

stage:
  deploy:
    SCD_MATRIX:
      "magento/backend": [ ]

SCD_MAX_EXECUTION_TIME

정적 콘텐츠 배포에 대한 최대 예상 실행 시간을 늘릴 수 있습니다.

기본적으로 Adobe Commerce은 최대 예상 실행을 900초로 설정하지만, 일부 시나리오에서는 클라우드 프로젝트에 대한 정적 콘텐츠 배포를 완료하는 데 더 많은 시간이 필요할 수 있습니다.

stage:
  deploy:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_NO_PARENT

배포 단계에서 부모 테마에 대한 정적 콘텐츠 생성이 배포 단계 동안 발생하지 않도록 SCD_NO_PARENT: true을(를) 설정하십시오. 이 설정은 배포 시간을 최소화하고, 배포 중에 정적 콘텐츠 빌드가 실패할 경우 발생할 수 있는 사이트 가동 중단을 방지합니다. 정적 콘텐츠 배포를 참조하세요.

stage:
  deploy:
    SCD_NO_PARENT: true

SCD_STRATEGY

정적 콘텐츠에 대한 배포 전략을(를) 사용자 지정할 수 있습니다. 정적 보기 파일 배포를 참조하세요.

로케일이 두 개 이상인 경우 only 옵션을 사용합니다.

stage:
  deploy:
    SCD_STRATEGY: "compact"

SCD_THREADS

정적 콘텐츠 배포를 위한 스레드 수를 설정합니다. 기본값은 감지된 CPU 스레드 수를 기반으로 설정되며 값 4를 초과하지 않습니다. 스레드 수를 늘리면 정적 콘텐츠 배포 속도가 빨라지고 스레드 수를 줄이면 속도가 느려집니다. 다음과 같이 스레드 값을 설정할 수 있습니다.

stage:
  deploy:
    SCD_THREADS: 2

배포 시간을 더 줄이려면 scd-dump 명령과 함께 구성 관리를 사용하여 정적 배포를 빌드 단계로 이동하십시오.

SEARCH_CONFIGURATION

이 환경 변수를 사용하여 배포 간에 사용자 지정된 검색 서비스 설정을 유지합니다. For example:

Elasticsearch 구성:

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: elasticsearch
      elasticsearch_server_hostname: http://elasticsearch.internal
      elasticsearch_server_port: '9200'
      elasticsearch_index_prefix: magento2
      elasticsearch_server_timeout: '15'

OpenSearch 구성(Commerce 2.4.6 이상):

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: opensearch
      opensearch_server_hostname: 'http://opensearch.internal'
      opensearch_server_port: '9200'
      opensearch_index_prefix: 'magento2'
      opensearch_server_timeout: '15'

기본적으로 배포 프로세스는 env.php 파일의 모든 설정을 덮어쓰지만 모든 값을 덮어쓰지 않고 서비스 구성에 대해 하나 이상의 값을 병합하도록 선택할 수 있습니다.

_merge 옵션을 다음 중 하나로 설정하십시오.

다음 예제에서는 새 값을 기존 구성에 병합합니다.

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: elasticsearch
      elasticsearch_server_port: '9200'
      _merge: true

SESSION_CONFIGURATION

Redis 세션 저장소를 구성합니다. 세션 저장소 변수에 save, redis, host, port 및 database 옵션이 필요합니다. For example:

stage:
  deploy:
    SESSION_CONFIGURATION:
      redis:
        bot_first_lifetime: 100
        bot_lifetime: 10001
        database: 0
        disable_locking: 1
        host: redis.internal
        max_concurrency: 10
        max_lifetime: 10001
        min_lifetime: 100
        port: 6379
      save: redis

기본적으로 배포 프로세스는 env.php 파일의 모든 설정을 덮어쓰지만 모든 값을 덮어쓰지 않고 서비스 구성에 대해 하나 이상의 값을 병합하도록 선택할 수 있습니다.

_merge 옵션을 다음 중 하나로 설정하십시오.

다음 예제에서는 새 값을 기존 구성에 병합합니다.

stage:
  deploy:
    SESSION_CONFIGURATION:
      _merge: true
      redis:
        max_concurrency: 10

SKIP_SCD

배포 단계 동안 정적 콘텐츠 배포를 건너뛰려면 true(으)로 설정하십시오.

배포 단계에서 배포 단계 동안 정적 콘텐츠 빌드가 발생하지 않도록 SKIP_SCD: true을(를) 설정하십시오. 이 설정은 배포 시간을 최소화하고, 배포 중에 정적 콘텐츠 빌드가 실패할 경우 발생할 수 있는 사이트 가동 중단을 방지합니다. 정적 콘텐츠 배포를 참조하세요.

stage:
  deploy:
    SKIP_SCD: true

UPDATE_URLS

배포 시 데이터베이스의 Adobe Commerce 기본 URL을 MAGENTO_CLOUD_ROUTES 변수에 지정된 프로젝트 URL로 바꾸십시오. 이 구성은 로컬 환경에 대한 기본 URL이 설정되는 로컬 개발에 유용합니다. Cloud 환경에 배포하면 프로젝트 URL을 사용하여 상점 및 관리자에 액세스할 수 있도록 URL이 업데이트됩니다.

Pro 또는 스타터 스테이징 및 프로덕션 환경에 배포할 때 URL을 업데이트해야 하는 경우 FORCE_UPDATE_URLS 변수를 사용하십시오.

stage:
  deploy:
    UPDATE_URLS: false

VERBOSE_COMMANDS

배포 단계에서 수행되는 bin/magento CLI 명령에 대해 Symfony 디버그 세부 정보 수준을 활성화하거나 비활성화합니다.

로그에 제공되는 세부 사항 수준을 선택합니다.

stage:
  deploy:
    VERBOSE_COMMANDS: "-vv"