설명서

클라우드 인프라의 Adobe Commerce에서 정적 콘텐츠를 생성하지 못함

Last update: Mon Jul 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

종종 잘못 구성된 환경 변수로 인해 Adobe Commerce on Cloud 인프라에서 배포하는 동안 정적 콘텐츠를 생성하지 못합니다. 빌드 프로세스 중에 발생하는 "/app/…/.htaccess"에 대해 symlink를 만들 수 없음 오류 ​이나 누락된 deployed_version.txt 파일이 발생합니다. 문제를 해결하려면 CLEAN_STATIC_FILES이(가) 사용하도록 설정되어 있는지 확인하고 환경을 다시 배포합니다.

설명 description

환경

클라우드 인프라의 Adobe Commerce

문제/증상

  • 배포 중에 정적 콘텐츠가 생성되지 않습니다.
  • 표시되는 오류: "/app/…/.htaccess" ​에 대해 symlink를 만들 수 없습니다.
  • deployed_version.txt 파일이 없거나 오래되었습니다.
  • 여러 환경에서 CLEAN_STATIC_FILES 변수가 일관되지 않습니다.

해결 방법 resolution

문제를 해결하려면 다음 단계를 수행합니다.

  1. CLEAN_STATIC_FILES 변수를 확인하여 사용(또는 기본적으로 사용)으로 설정되었는지(설정되지 않았는지) 확인하십시오. 다음 방법 중 하나로 이를 확인할 수 있습니다.

    • SSH(예: 노드 01)를 통해 서버에 액세스하고 다음 명령을 실행합니다.

      code language-none 
      php -r 'echo json_decode(base64_decode($_ENV[ "MAGENTO_CLOUD_VARIABLES"] ))->CLEAN_STATIC_FILES . "\n";'

    • 저장소의 .magento.env.yaml 파일에서 변수를 확인합니다.

    • 다음 CLI 명령을 로컬로 실행합니다.

      code language-none 
      magento-cloud variables:list -p <clusterID>

    • https://console.adobecommerce.com/username/<cluster ID>/<environment>/settings/variables의 클라우드 콘솔을 방문하여 변수를 검사하십시오.

  2. 여러 환경에서 CLEAN_STATIC_FILES 변수를 비교하여 불일치(예: 스테이징에서 활성화되지만 프로덕션에서 비활성화됨)를 식별하고 일관성을 유지하기 위해 활성화되도록 조정합니다.

  3. 변경 사항을 환경에 푸시하여 재빌드를 트리거하고 정적 콘텐츠를 재생성합니다.

관련 읽기

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f