원격 스토리지 구성
원격 스토리지 모듈은 미디어 파일을 저장하고 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🔗 저장소에서 사용할 수 있습니다.
-
원격 저장소는 Commerce 버전 2.4.2 이상에서만 사용할 수 있습니다. 2.4.2 릴리스 정보를 참조하세요.
-
원격 스토리지 모듈에 클라우드 인프라의 Adobe Commerce에 대한 제한 지원이 있습니다. Adobe이 타사 스토리지 어댑터 서비스의 문제를 완전히 해결할 수 없습니다. 클라우드 프로젝트를 위한 원격 스토리지 구현에 대한 지침은 Commerce on Cloud 인프라🔗에 대한 원격 스토리지 구성을 참조하십시오.
원격 저장소 옵션
CLI 명령과 remote-storage
함께 옵션을 사용하여 원격 스토리지를 setup
구성할 수 있습니다. 이 remote-storage
옵션은 다음 구문을 사용합니다.
--remote-storage-<parameter-name>="<parameter-value>"
parameter-name
특정 원격 저장소 매개 변수 이름을 나타냅니다. 다음 표에는 원격 저장소를 구성하는 데 사용할 수 있는 매개 변수가 나열되어 있습니다.
remote-storage-driver
가능한 값:
파일: 원격 스토리지를 사용하지 않도록 설정하고 로컬 파일 시스템을 사용
aws-s3: Amazon Simple Storage Service(Amazon S3) 사용
remote-storage-bucket
remote-storage-prefix
remote-storage-region
remote-storage-key
remote-storage-secret
스토리지 어댑터
기본 저장소 위치는 로컬 파일 시스템에 있습니다. 저장소 어댑터 을(를) 사용하면 저장소 서비스에 연결하여 어디에나 파일을 저장할 수 있습니다. Commerce에서 다음 저장소 서비스 구성을 지원합니다.
원격 저장소 활성화
Adobe Commerce 설치 중에 원격 저장소를 설치하거나 기존 Commerce 인스턴스에 원격 저장소를 추가할 수 있습니다. 다음 예에서는 Commerce setup
CLI 명령과 함께 매개 변수 집합을 remote-storage
사용하는 각 방법을 보여줍니다. 최소한 스토리지 driver
, bucket
, 및 region
를 제공해야 합니다.
-
예: 원격 스토리지로 Commerce 설치
code language-bash bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
-
예: 기존 Commerce에서 원격 스토리지 활성화
code language-bash bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
콘텐츠 마이그레이션
특정 어댑터에 대해 원격 스토리지를 사용으로 설정한 후 CLI를 사용하여 기존 미디어 파일을 원격 스토리지로 마이그레이션할 수 있습니다.
./magento2ce/bin/magento remote-storage:sync
pub/media
있는 파일만 마이그레이션하고 디렉토리에 있는 var
가져오기/내보내기 파일은 마이그레이션하지 않습니다. Commerce 2.4 사용 안내서에서 예약된 가져오기/내보내기🔗를 참조하십시오.