저장소 구성 관리

저장소에 대한 기본 구성은 해당 모듈의 config.xml에 저장됩니다. Commerce 관리 또는 CLI bin/magento config:set 명령에서 설정을 변경하면 변경 내용이 코어 데이터베이스, 특히 core_config_data 테이블에 반영됩니다. 이러한 설정은 config.xml 파일에 저장된 기본 구성을 덮어씁니다.

관리자 스토어 > 설정 > 구성 섹션의 구성을 참조하는 스토어 설정은 구성 유형에 따라 배포 구성 파일에 저장됩니다.

구성 관리는 파이프라인 배포를 사용하여 가동 중단을 최소화하면서 환경 전체에 일관된 저장소 설정을 배포하는 방법을 제공합니다. Adobe Commerce on cloud infrastructure 프로젝트에는 빌드 서버, 빌드 및 배포 스크립트, 파이프라인 배포 전략을 염두에 두고 설계된 배포 환경이 포함되어 있습니다.

구성 재정의 스키마

모든 시스템 구성은 다음 재정의 체계에 따라 빌드 및 배포 단계 동안 설정됩니다.

요약하면 환경 변수는 다른 모든 값을 재정의합니다.

동일한 설정이 여러 위치에 구성된 경우 애플리케이션은 다음 구성 계층 구조를 사용하여 환경에 적용할 값을 결정합니다.

구성 덤프

다음 ece-tools 명령을 사용하여 현재 저장소 구성이 모두 포함된 config.php 파일을 생성할 수 있습니다.

./vendor/bin/ece-tools config:dump

app/etc/config.php 파일에 대한 "덤프됨" 데이터는 잠김 ​이 됩니다. 즉, Commerce 관리자의 해당 필드는 읽기 전용 ​이 됩니다. config.php 파일에는 사용자가 구성한 설정만 포함되어 있습니다. 기본값이 잠기지 않습니다. 업데이트하는 값만 잠그면 스테이징 및 프로덕션 환경에서 사용되는 모든 확장이 읽기 전용 구성, 특히 Fastly로 인해 중단되지 않습니다.

중요 데이터

bin/magento app:config:dump 명령을 사용할 때 중요한 구성은 app/etc/env.php 파일로 내보냅니다. CLI 명령 bin/magento config:sensitive:set을(를) 사용하여 중요한 값을 설정할 수 있습니다. 구성 설정을 중요하거나 시스템별로 지정하는 방법에 대해 알아보려면 Commerce PHP 확장 안내서의 중요 및 환경별 설정을 참조하십시오.

구성 가이드 ​에서 중요 또는 시스템별 설정 목록을 확인하세요.

SCD 성능

저장소 크기에 따라 배포할 정적 콘텐츠 파일이 많을 수 있습니다. 일반적으로 정적 콘텐츠는 애플리케이션이 유지 관리 모드에 있는 경우 배포 단계 동안 배포됩니다. 가장 최적의 구성은 빌드 단계 중에 정적 콘텐츠를 생성하는 것입니다. 배포 전략 선택을 참조하세요.

구성을 덤프한 후 구성 관리를 활성화한 경우 배포 단계의 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:
      ...

설정 관리 절차

다음은 이 프로세스에 대한 높은 수준의 개요를 보여 줍니다.

저장소를 구성하고 구성 파일을 생성하려면:

배포가 완료되면 업데이트된 환경의 관리자에 로그인하여 설정을 확인합니다. 필요에 따라 추가 구성을 스테이징 및 프로덕션 환경에 계속 병합합니다.

구성 업데이트

관리자를 통해 환경을 수정하고 명령을 다시 실행하면 새 구성이 config.php 파일의 코드에 추가됩니다.

구성 파일 복원

배포 프로세스 중에 원본 app/etc/env.php 및 app/etc/config.php 파일의 복사본을 만들어 동일한 폴더에 저장했습니다. 다음은 동일한 app/etc 폴더에 있는 BAK(백업 파일)와 PHP(원본 파일)를 보여 줍니다.

...
config.php.bak
di.xml
env.php.bak
vendor_path.php
config.php
db_schema.xml
env.php
...

이전 구성에서 app/etc/config.local.php 파일을 사용했습니다. 이전 구성 마이그레이션을 참조하십시오.

구성 파일을 복원하려면:

이전 구성 마이그레이션

Cloud Infrastructure 2.2 이상에서 Adobe Commerce으로 업그레이드하는 경우 config.local.php 파일에서 새 config.php 파일로 설정을 마이그레이션할 수 있습니다. 관리자의 구성 설정이 파일의 내용과 일치하면 지침에 따라 config.php 파일을 생성하고 추가하십시오.

서로 다른 경우 config.local.php 파일의 내용을 새 config.php 파일에 추가할 수 있습니다.

이 마이그레이션은 한 번만 완료합니다. 마이그레이션 후 config.php 파일을 사용하십시오.

로케일 변경

복잡한 구성 가져오기 및 내보내기 프로세스를 따르지 않고 저장소 로케일을 변경할 수 있습니다. if SCD_ON_DEMAND을(를) 사용하도록 설정했습니다. 관리자를 사용하여 로케일을 업데이트할 수 있습니다.

통합 분기에서 SCD_ON_DEMAND을(를) 활성화하여 스테이징 또는 프로덕션 환경에 다른 로케일을 추가하고, 새 로케일 정보가 포함된 업데이트된 config.php 파일을 생성하고, 구성 파일을 대상 환경에 복사할 수 있습니다.