변수 배포

마지막 업데이트: 2026년 4월 8일

작성 대상:

{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

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

stage:
  deploy:
    DEPLOY_VARIABLE_NAME: value

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

`CACHE_CONFIGURATION`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

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

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

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

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

true—환경 변수 값을 사용하여 구성된 서비스 값을 병합합니다.
false—구성된 서비스 값을 환경 변수 값으로 덮어씁니다.

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

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
버전—Adobe Commerce 2.1.4 이상

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

true - 업데이트된 정적 콘텐츠를 배포하기 전에 기존 정적 콘텐츠를 모두 제거합니다.
false - 생성된 콘텐츠에 최신 버전이 포함된 경우 배포는 기존 정적 콘텐츠 파일만 덮어씁니다.

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

stage:
  deploy:
    CLEAN_STATIC_FILES: false

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

`CRON_CONSUMERS_RUNNER`

기본값—cron_run = false, max_messages = 1000
버전—Adobe Commerce 2.2.0 이상

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

cron_run—consumers_runner cron 작업을 활성화하거나 비활성화하는 부울 값입니다(기본값 = false).
max_messages—종료하기 전에 각 소비자가 처리해야 하는 최대 메시지 수를 지정하는 숫자입니다(기본값 = 1000). 이 값을 0(으)로 설정하여 소비자가 종료되는 것을 방지할 수 있습니다.
consumers—실행할 소비자를 지정하는 문자열 배열입니다. 빈 배열은 모두 소비자를 실행합니다.
multiple_processes-각 소비자에 대해 생성할 프로세스 수를 지정하는 숫자입니다. Commerce 2.4.4 이상에서 지원됩니다.

NOTE

메시지 큐 consumers 목록을 반환하려면 원격 환경에서 ./bin/magento queue:consumers:list 명령을 실행하십시오.

각 소비자에 대해 생성할 특정 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`

기본값—false
버전—Adobe Commerce 2.2.0 이상

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

false—Consumers이(가) 큐에서 사용 가능한 메시지를 처리하고 TCP 연결을 닫고 종료합니다. Consumers은(는) 처리된 메시지 수가 CRON_CONSUMERS_RUNNER 배포 변수에 지정된 max_messages 값보다 작더라도 추가 메시지가 대기열에 들어갈 때까지 기다리지 않습니다.
true—Consumers은(는) TCP 연결을 닫고 소비자 프로세스를 종료하기 전에 CRON_CONSUMERS_RUNNER 배포 변수에 지정된 최대 메시지 수(max_messages)에 도달할 때까지 메시지 큐에서 메시지를 계속 처리합니다. max_messages에 도달하기 전에 큐를 비우면 소비자는 더 많은 메시지가 도착할 때까지 기다립니다.

WARNING

크론 작업을 사용하는 대신 작업자를 사용하여 consumers을(를) 실행하는 경우 이 변수를 true로 설정하십시오.

stage:
  deploy:
    CONSUMERS_WAIT_FOR_MAX_MESSAGES: false

`CRYPT_KEY`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

WARNING

.magento.env.yaml 파일 대신 Cloud Console을(를) 통해 CRYPT_KEY 값을 설정하여 환경에 대한 소스 코드 리포지토리의 키가 노출되지 않도록 하십시오. 환경 및 프로젝트 변수 설정을 참조하십시오.

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

`DATABASE_CONFIGURATION`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

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

stage:
  deploy:
    DATABASE_CONFIGURATION:
      some_config: 'some_value'

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

true—환경 변수 값을 사용하여 구성된 서비스 값을 병합합니다.
false—구성된 서비스 값을 환경 변수 값으로 덮어씁니다.

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

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

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

WARNING

테이블 접두사와 함께 병합 옵션을 사용하지 않는 경우 기본 연결 설정을 제공해야 합니다. 그렇지 않으면 배포가 유효성 검사에 실패합니다.

다음 예제에서는 _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`

기본값—설정되지 않음
버전—Adobe Commerce 2.2.0 이상

배포 간에 사용자 지정된 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

NOTE

세 개의 노드(또는 크기 조정된 아키텍처에 세 개의 서비스 노드)가 있는 Pro Staging/Production 클러스터에서는 indices_settings을(를) 다음과 같이 설정해야 합니다.

code language-yaml
`indices_settings: number_of_shards: 1 number_of_replicas: 2`

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

true—환경 변수 값을 사용하여 구성된 서비스 값을 병합합니다.
false—구성된 서비스 값을 환경 변수 값으로 덮어씁니다.

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

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

알려진 제한 사항:

검색 엔진을 elasticsuite이(가) 아닌 다른 형식으로 변경하면 적절한 유효성 검사 오류가 발생하는 배포 오류가 발생합니다
Elasticsearch 서비스를 제거하면 적절한 유효성 검사 오류가 발생하는 배포 오류가 발생합니다

NOTE

Adobe Commerce에서 Elastic Suite 플러그인을 사용하거나 문제를 해결하는 방법에 대한 자세한 내용은 Elastic Suite 설명서를 참조하십시오.

`ENABLE_GOOGLE_ANALYTICS`

기본값—false
버전—Adobe Commerce 2.1.4 이상

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

true - 스테이징 및 통합 환경에서 Google Analytics을 사용하도록 설정합니다.
false - 스테이징 및 통합 환경에서 Google Analytics을 사용하지 않도록 설정합니다.

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

stage:
  deploy:
    ENABLE_GOOGLE_ANALYTICS: true

NOTE

배포 프로세스를 통해 프로덕션 환경에서 Google Analytics이 항상 활성화됩니다.

`FORCE_UPDATE_URLS`

기본값—true
버전—Adobe Commerce 2.1.4 이상

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

stage:
  deploy:
    FORCE_UPDATE_URLS: true

`LOCK_PROVIDER`

기본값— 프로덕션 및 스테이징 환경에서 기본값은 file입니다. Pro 통합 및 스타터 환경의 경우 기본값은 db입니다.
버전—Adobe Commerce 2.2.5 이상

잠금 공급자는 중복 크론 작업 및 크론 그룹의 시작을 방지합니다. Commerce on Cloud는 file 및 db 잠금 공급자만 지원합니다.

프로덕션 및 스테이징 환경의 경우 기본값 file이(가) MAGENTO_CLOUD_LOCKS_DIR에 의해 설정되어 재정의할 수 없습니다. Starter 환경 및 Pro 통합 환경의 경우 ece-tools에서 db 잠금 공급자를 자동으로 설정합니다. 이러한 환경에서 기본값을 file(으)로 변경하여 로컬 성능 및 미러 프로덕션 아키텍처를 최적화할 수 있습니다.

stage:
  deploy:
    LOCK_PROVIDER: "db"

`MYSQL_USE_SLAVE_CONNECTION`

기본값—false
버전—Adobe Commerce 2.1.4 이상

TIP

MYSQL_USE_SLAVE_CONNECTION 변수는 클라우드 인프라 스테이징 및 Production Pro 클러스터 환경의 Adobe Commerce에서만 지원되며 시작 프로젝트에서는 지원되지 않습니다.

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`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

이 환경 변수를 사용하여 배포 간에 사용자 지정된 큐 서비스 설정을 유지합니다. 이 변수는 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

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

true—환경 변수 값을 사용하여 구성된 서비스 값을 병합합니다.
false—구성된 서비스 값을 환경 변수 값으로 덮어씁니다.

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

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`

기본값—Cm_Cache_Backend_Redis
버전—Adobe Commerce 2.3.0 이상

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

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

Cm_Cache_Backend_Redis
\Magento\Framework\Cache\Backend\Redis
\Magento\Framework\Cache\Backend\RemoteSynchronizedCache

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

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

NOTE

L2 캐시를 사용하도록 Redis 백 엔드 모델로 \Magento\Framework\Cache\Backend\RemoteSynchronizedCache을(를) 지정하면 ece-tools에서 캐시 구성을 자동으로 생성합니다. Adobe Commerce 구성 가이드에서 예제 구성 파일을(를) 참조하십시오. 생성된 캐시 구성을 재정의하려면 CACHE_CONFIGURATION 배포 변수를 사용하십시오.

`REDIS_USE_SLAVE_CONNECTION`

기본값—false
버전—Adobe Commerce 2.1.16 이상

TIP

REDIS_USE_SLAVE_CONNECTION 변수는 클라우드 인프라 스테이징 및 Production Pro 클러스터 환경의 Adobe Commerce에서만 지원되며 시작 프로젝트에서는 지원되지 않습니다.

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`

기본값—Cm_Cache_Backend_Redis
버전—Adobe Commerce 2.4.8 이상

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

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

Cm_Cache_Backend_Redis
\Magento\Framework\Cache\Backend\Redis
\Magento\Framework\Cache\Backend\RemoteSynchronizedCache

Adobe Commerce 2.4.9 이상 버전은 최신 Symfony 캐시 기반 L2 캐시 구현을 가능하게 하는 symfony_l2 백엔드 모델도 지원합니다.

동기화된 원격 캐시 구성

Adobe Commerce 2.4.8의 경우 다음 예제에서는 VALKEY_BACKEND을(를) 동기화된 원격 캐시로 설정하는 방법을 설명합니다.

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

Valkey 백 엔드 모델로 원격 동기화 캐시를 지정하면 L2 캐시가 활성화되고 ece-tools이(가) 캐시 구성을 자동으로 생성합니다. 예제 구성 파일을 참조하십시오. 구성을 재정의하려면 CACHE_CONFIGURATION 배포 변수를 사용하십시오.

`VALKEY_USE_SLAVE_CONNECTION`

기본값—false
버전—Adobe Commerce 2.4.8 이상

TIP

VALKEY_USE_SLAVE_CONNECTION 변수는 클라우드 인프라 스테이징 및 Production Pro 클러스터 환경의 Adobe Commerce에서만 지원되며 시작 프로젝트에서는 지원되지 않습니다.

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`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

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

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

true—환경 변수 값을 사용하여 구성된 서비스 값을 병합합니다.
false—구성된 서비스 값을 환경 변수 값으로 덮어씁니다.

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

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

`SCD_COMPRESSION_LEVEL`

기본값—4
버전—Adobe Commerce 2.1.4 이상

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

stage:
  deploy:
    SCD_COMPRESSION_LEVEL: 5

`SCD_COMPRESSION_TIMEOUT`

기본값—600
버전—Adobe Commerce 2.1.4 이상

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

stage:
  deploy:
    SCD_COMPRESSION_TIMEOUT: 800

`SCD_MATRIX`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

테마당 여러 로케일을 구성할 수 있습니다. 이 맞춤화는 불필요한 테마 파일의 수를 줄여 배포 프로세스를 가속화합니다. 예를 들어 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 2.2.0 이상

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

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

stage:
  deploy:
    SCD_MAX_EXECUTION_TIME: 3600

WARNING

사용자 지정 테마 파일이 누락되는 등 배포 후 애플리케이션에 정적 콘텐츠 파일에 문제가 있는 경우 최대 예상 실행 시간을 900초 이상으로 늘리십시오.

`SCD_NO_PARENT`

기본값—false
버전—Adobe Commerce 2.4.2 이상

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

stage:
  deploy:
    SCD_NO_PARENT: true

`SCD_STRATEGY`

기본값—quick
버전—Adobe Commerce 2.2.0 이상

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

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

standard - 모든 패키지에 대한 모든 정적 보기 파일을 배포합니다.
quick—(default)은(는) 배포 시간을 최소화합니다.
compact - 서버의 디스크 공간을 절약합니다. Adobe Commerce 버전 2.2.4 및 이전 버전에서 이 설정은 값이 1인 scd_threads의 값을 재정의합니다.

stage:
  deploy:
    SCD_STRATEGY: "compact"

`SCD_THREADS`

기본값—자동
버전—Adobe Commerce 2.1.4 이상

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

stage:
  deploy:
    SCD_THREADS: 2

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

`SEARCH_CONFIGURATION`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

이 환경 변수를 사용하여 배포 간에 사용자 지정된 검색 서비스 설정을 유지합니다. 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'

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

true—환경 변수 값을 사용하여 구성된 서비스 값을 병합합니다.
false—구성된 서비스 값을 환경 변수 값으로 덮어씁니다.

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

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

`SESSION_CONFIGURATION`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

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

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

true—환경 변수 값을 사용하여 구성된 서비스 값을 병합합니다.
false—구성된 서비스 값을 환경 변수 값으로 덮어씁니다.

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

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

`SKIP_SCD`

기본값— 설정되지 않음
버전—Adobe Commerce 2.1.4 이상

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

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

stage:
  deploy:
    SKIP_SCD: true

`UPDATE_URLS`

기본값—true
버전—Adobe Commerce 2.1.4 이상

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

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

stage:
  deploy:
    UPDATE_URLS: false

`USE_LUA`

기본값—false
버전—Adobe Commerce 2.4.7 이상

기본 캐시 프론트엔드에 대해 env.php의 use_lua 캐시 백 엔드 옵션을 제어합니다(그리고 symfony_l2 백 엔드를 사용하는 경우 stale_cache_enabled 백 엔드의 원격 백 엔드 옵션). 이 옵션은 page_cache 프런트 엔드에 적용되지 않습니다.

Adobe 지원이 명시적으로 다르게 지정하지 않는 한 기본값 false을(를) 사용하십시오.

stage:
  deploy:
    USE_LUA: false

WARNING

Adobe Commerce 2.4.7 및 2.4.8에서 USE_LUA: true을(를) 설정하면 캐시 손상 및 GraphQL 캐시 누락 문제가 발생할 수 있습니다.

Adobe Commerce 2.4.9부터 Commerce 버전에 대해 Valkey 캐시 구성 지침을 사용하고 새 배포에 USE_LUA을(를) 사용하지 마십시오. 기본 및 페이지 캐시에 대한 Redis 구성을 참조하십시오.

`LUA_KEY`

LUA_KEY 변수는 더 이상 사용되지 않습니다. LUA_KEY이(가) .magento.env.yaml에 포함된 경우 마이그레이션하는 동안 제거하십시오. 대신 USE_LUA 및 USE_LUA_ON_GC 변수를 사용하십시오.

`USE_LUA_ON_GC`

기본값—true
버전—Adobe Commerce 2.4.8 이상

가비지 수집을 위해 기본 캐시 프론트엔드에 대한 env.php의 use_lua_on_gc 캐시 백 엔드 옵션(및 symfony_l2 백 엔드를 사용하는 경우 stale_cache_enabled 백 엔드의 원격 백 엔드 옵션)을 제어합니다. 이 옵션은 page_cache 프런트 엔드에 적용되지 않습니다.

backend_clean_cache cron 작업 동안 원자 캐시 태그 정리를 유지하려면 기본값 true을(를) 사용합니다.

stage:
  deploy:
    USE_LUA_ON_GC: true

WARNING

Adobe Commerce 2.4.8에서 USE_LUA_ON_GC: false을(를) 설정하면 태그 기반 캐시 무효화가 자동으로 실패하여 복구할 전체 캐시 플러시가 필요할 수 있습니다.

2.4.9 이상에서는 설치된 버전의 캐시 서비스 지침을(를) 따릅니다.

`VERBOSE_COMMANDS`

기본값—설정되지 않음
버전—Adobe Commerce 2.1.4 이상

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

NOTE

VERBOSE_COMMANDS 설정을 사용하여 성공 및 실패한 bin/magento CLI 명령에 대한 명령 출력의 세부 정보를 제어하려면 MIN_LOGGING_LEVEL debug을(를) 설정해야 합니다.

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

-v= 일반 출력
-vv= 더 자세한 출력
-vvv = 디버그에 적합한 세부 정보 출력

stage:
  deploy:
    VERBOSE_COMMANDS: "-vv"

recommendation-more-help

commerce-on-cloud-help-cloud-guide

변수 배포

CACHE_CONFIGURATION

CLEAN_STATIC_FILES

CRON_CONSUMERS_RUNNER

CONSUMERS_WAIT_FOR_MAX_MESSAGES

CRYPT_KEY

DATABASE_CONFIGURATION

ELASTICSUITE_CONFIGURATION

ENABLE_GOOGLE_ANALYTICS

FORCE_UPDATE_URLS

LOCK_PROVIDER

MYSQL_USE_SLAVE_CONNECTION

QUEUE_CONFIGURATION

REDIS_BACKEND

REDIS_USE_SLAVE_CONNECTION

VALKEY_BACKEND

동기화된 원격 캐시 구성

최신 Symfony L2 캐시 구현 구성

VALKEY_USE_SLAVE_CONNECTION

RESOURCE_CONFIGURATION

SCD_COMPRESSION_LEVEL

SCD_COMPRESSION_TIMEOUT

SCD_MATRIX

SCD_MAX_EXECUTION_TIME

SCD_NO_PARENT

SCD_STRATEGY

SCD_THREADS

SEARCH_CONFIGURATION

SESSION_CONFIGURATION

SKIP_SCD

UPDATE_URLS

USE_LUA

LUA_KEY

USE_LUA_ON_GC

VERBOSE_COMMANDS

`CACHE_CONFIGURATION`

`CLEAN_STATIC_FILES`

`CRON_CONSUMERS_RUNNER`

`CONSUMERS_WAIT_FOR_MAX_MESSAGES`

`CRYPT_KEY`

`DATABASE_CONFIGURATION`

`ELASTICSUITE_CONFIGURATION`

`ENABLE_GOOGLE_ANALYTICS`

`FORCE_UPDATE_URLS`

`LOCK_PROVIDER`

`MYSQL_USE_SLAVE_CONNECTION`

`QUEUE_CONFIGURATION`

`REDIS_BACKEND`

`REDIS_USE_SLAVE_CONNECTION`

`VALKEY_BACKEND`

`VALKEY_USE_SLAVE_CONNECTION`

`RESOURCE_CONFIGURATION`

`SCD_COMPRESSION_LEVEL`

`SCD_COMPRESSION_TIMEOUT`

`SCD_MATRIX`

`SCD_MAX_EXECUTION_TIME`

`SCD_NO_PARENT`

`SCD_STRATEGY`

`SCD_THREADS`

`SEARCH_CONFIGURATION`

`SESSION_CONFIGURATION`

`SKIP_SCD`

`UPDATE_URLS`

`USE_LUA`

`LUA_KEY`

`USE_LUA_ON_GC`

`VERBOSE_COMMANDS`