정적 콘텐츠 배포 전략

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

관리자
개발자

정적 콘텐츠 배포(SCD)는 이미지, 스크립트, CSS, 비디오, 테마, 로케일 및 웹 페이지와 같은 생성할 콘텐츠의 양과 콘텐츠 생성 시기에 따라 저장소 배포 프로세스에 상당한 영향을 줍니다. 예를 들어 기본 전략은 사이트가 유지 관리 모드에 있는 경우 배포 단계 동안 정적 콘텐츠를 생성합니다. 그러나 이 배포 전략은 탑재된 pub/static 디렉터리에 콘텐츠를 직접 작성하는 데 시간이 소요됩니다. 필요에 따라 배포 시간을 개선하는 데 도움이 되는 몇 가지 옵션 또는 전략이 있습니다.

JavaScript 및 HTML 컨텐츠 최적화

번들 및 축소를 사용하여 정적 콘텐츠 배포 중에 최적화된 JavaScript 및 HTML 콘텐츠를 빌드할 수 있습니다.

콘텐츠 축소

var/view_preprocessed 디렉터리의 정적 보기 파일 복사를 건너뛰고 요청이 있을 때 축소된 HTML을 생성하는 경우 배포 프로세스 중 SCD 로드 시간을 향상시킬 수 있습니다. .magento.env.yaml 파일에서 SKIP_ENVIRONMENT_MINIFICATION 전역 환경 변수를 true(으)로 설정하여 이 HTML을 활성화할 수 있습니다.

NOTE

ece-tools 패키지 버전 2002.0.13부터 SKIP_PACKAGE_MINIFICATION HTML의 기본값이 true(으)로 설정됩니다.

불필요한 테마 파일 수를 줄여 더 배포 시간과 디스크 공간을 절약할 수 있습니다. 예를 들어 magento/backend 테마는 영어로, 사용자 지정 테마는 다른 언어로 배포할 수 있습니다. SCD_MATRIX 환경 변수로 이러한 테마 설정을 구성할 수 있습니다.

배포 전략 선택

배포 전략은 빌드 단계, 배포 단계 또는 주문형 단계 중 정적 콘텐츠를 생성할지 여부에 따라 다릅니다. 다음 차트에서 볼 수 있듯이 배포 단계 동안 정적 콘텐츠를 생성하는 것이 가장 낮은 최적의 선택입니다. 축소된 HTML을 사용하더라도 마운트된 ~/pub/static 디렉터리에 각 콘텐츠 파일을 복사해야 하므로 시간이 오래 걸릴 수 있습니다. 주문형 정적 콘텐츠를 생성하는 것이 최적의 선택인 것 같습니다. 그러나 콘텐츠 파일이 요청 시 캐시에 없으면 콘텐츠 파일이 요청되어 사용자 경험에 로드 시간이 추가됩니다. 따라서 빌드 단계 중에 정적 콘텐츠를 생성하는 것이 가장 최적입니다.

SCD 로드 비교

빌드에서 SCD 설정

HTML이 축소된 빌드 단계 동안 정적 콘텐츠를 생성하는 것은 가동 중지 시간이 전혀 없는 배포에 대한 최적의 구성이며, 이상적인 상태 라고도 합니다. 파일을 탑재된 드라이브에 복사하는 대신 ./init/pub/static 디렉터리에서 symlink를 만듭니다.

정적 콘텐츠를 생성하려면 테마 및 로케일에 액세스해야 합니다. Adobe Commerce은 빌드 단계에서 액세스할 수 있는 파일 시스템에 테마를 저장하지만 Adobe Commerce은 로케일을 데이터베이스에 저장합니다. 빌드 단계에서 데이터베이스를 사용할 수 없습니다. 빌드 단계에서 정적 콘텐츠를 생성하려면 ece-tools 패키지의 config:dump 명령을 사용하여 로케일을 파일 시스템으로 이동해야 합니다. 로케일을 읽고 app/etc/config.php 파일에 저장합니다.

빌드에서 SCD를 생성하도록 프로젝트를 구성하려면:

로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

SSH를 사용하여 원격 환경에 로그인합니다.

code language-bash
`magento-cloud ssh`

로케일을 파일 시스템으로 이동한 다음 config.php 파일을(를) 업데이트합니다.
.magento.env.yaml 구성 파일에는 다음 값이 있어야 합니다.
- HTML SKIP_MINIFICATION_1}은(는) true입니다.
- 빌드 단계의 SKIP_SCD은(는) false입니다.
- SCD_STRATEGY은(는) compact입니다.
.magento.app.yaml 파일에서 Post-deploy hook의 구성을 확인하십시오.

이상적인 상태에 대한 스마트 마법사를 실행하여 설정을 확인하십시오.

code language-bash
`php ./vendor/bin/ece-tools wizard:ideal-state`

SCD on demand 설정

주문형 SCD를 생성하는 것은 통합 환경의 개발 워크플로우에 최적입니다. 배포 시간을 줄여 구현을 빠르게 검토하고 통합 테스트를 실행할 수 있습니다. .magento.env.yaml 파일의 전역 단계에서 SCD_ON_DEMAND 환경 변수를 사용하도록 설정합니다. SCD_ON_DEMAND 변수는 SCD와 관련된 다른 모든 구성을 재정의하고 ~/pub/static 디렉터리에서 기존 콘텐츠를 지웁니다.

SCD 온디맨드 전략을 사용할 때, 이 전략은 홈 페이지와 같이 요청할 것으로 예상되는 페이지로 캐시를 미리 로드하는 데 도움이 됩니다. .magento.env.yaml 파일의 배포 후 단계에서 WARM_UP_PAGES 환경 변수의 예상 페이지 목록을 추가하십시오.

WARNING

프로덕션 환경에서는 SCD 온디맨드 전략을 사용하지 마십시오.

SCD 건너뛰기

경우에 따라 정적 콘텐츠 생성을 완전히 건너뛰도록 선택할 수 있습니다. 전역 단계에서 SCD와 관련된 다른 구성을 무시하도록 SKIP_SCD 환경 변수를 설정할 수 있습니다. ~/pub/static 디렉터리의 기존 콘텐츠에는 영향을 주지 않습니다.

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26