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

원격 스토리지 구성

원격 스토리지 모듈은 미디어 파일을 저장하고 AWS S3와 같은 스토리지 서비스를 사용하여 영구적인 원격 스토리지 컨테이너에 가져오기 및 내보내기를 예약하는 옵션을 제공합니다.

기본적으로 Adobe Commerce 애플리케이션은 애플리케이션이 포함된 동일한 파일 시스템에 미디어 파일을 저장합니다. 이는 복잡한 다중 서버 구성에서 비효율적이며 리소스를 공유할 때 성능이 저하될 수 있습니다. 원격 저장소 모듈을 사용하면 미디어 파일을 pub/media 디렉터리에 저장하고 원격 개체 저장소의 var 디렉터리에 파일을 가져오거나 내보내 서버측 이미지 크기 조정을 활용할 수 있습니다.

원격 저장소 과(와) 데이터베이스 저장소를 동시에 사용하도록 설정할 수 없습니다. 원격 저장소를 활성화하기 전에 데이터베이스 저장소를 비활성화해야 합니다.

bin/magento config:set system/media_storage_configuration/media_database 0

원격 스토리지를 활성화하면 기존 개발 환경에 영향을 줄 수 있습니다. 예를 들어 특정 PHP 파일 함수가 예상대로 작동하지 않을 수 있습니다. 파일 작업에 Commerce Framework를 사용해야 합니다. 금지된 PHP 네이티브 함수 목록을 magento-coding-standard 리포지토리에서 사용할 수 있습니다.

원격 스토리지 옵션

remote-storage CLI 명령setup과(와) 함께 ​ 옵션을 사용하여 원격 저장소를 구성할 수 있습니다. remote-storage 옵션은 다음 구문을 사용합니다.

--remote-storage-<parameter-name>="<parameter-value>"

parameter-name은(는) 특정 원격 저장소 매개 변수 이름을 참조합니다. 다음 표에는 원격 스토리지를 구성하는 데 사용할 수 있는 매개 변수가 나와 있습니다.

스토리지 어댑터

기본 저장소 위치는 로컬 파일 시스템에 있습니다. 저장소 어댑터 ​을(를) 사용하면 저장소 서비스에 연결하여 어디에나 파일을 저장할 수 있습니다. Commerce에서 다음 저장소 서비스 구성을 지원합니다.

원격 스토리지 사용

Adobe Commerce 설치 중에 원격 저장소를 설치하거나 기존 Commerce 인스턴스에 원격 저장소를 추가할 수 있습니다. 다음 예제에서는 Commerce remote-storage CLI 명령과 함께 setup 매개 변수 집합을 사용하는 각 메서드를 보여 줍니다. 최소한 driver, bucket 및 region 저장소를 제공해야 합니다.

콘텐츠 마이그레이션

특정 어댑터에 대해 원격 저장소를 사용하도록 설정한 후 CLI를 사용하여 기존 media 파일을 원격 저장소로 마이그레이션할 수 있습니다.

./magento2ce/bin/magento remote-storage:sync