설명서Commerce클라우드 인프라의 Commerce 안내서

Fastly 캐시를 무시하는 사용자 지정 VCL

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

작성 대상:

  • 관리자
  • 개발자

원본 서버에 대한 요청 트래픽 문제를 해결할 수 있도록 Fastly 캐시를 무시하는 사용자 지정 VCL 코드 조각을 만들 수 있습니다. 예를 들어 사이트 문제가 캐싱으로 인해 발생하는지 또는 헤더 문제를 해결하기 위해 코드 조각을 만들 수 있습니다.

특정 IP 주소 또는 URL의 요청에 대해 Fastly 캐싱을 무시하도록 코드 조각을 구성할 수 있습니다.

NOTE
사용자 지정 VCL 구성을 프로덕션 환경에 병합하기 전에 스테이징 환경에서 코드를 테스트해야 합니다.

필수 구성 요소:

  • Fastly CDN을 사용하도록 환경을 구성해야 합니다. Fastly 서비스 구성을 참조하세요.

  • Magento 2에 대한 Fastly CDN 모듈의 최신 버전을 실행 중인지 확인하십시오. Fastly 모듈 업그레이드를 참조하십시오.

  • Fastly 서비스에 대한 환경 구성을 확인합니다. Fastly 캐싱 확인을 참조하세요.

  • 스테이징 및 프로덕션 환경에 액세스하려면 관리자 자격 증명이 있어야 합니다.

IP 주소 또는 URL을 기반으로 Fastly 캐시를 무시하려면:

  1. 책임자에 로그인.

  2. 스토어 > 설정 > 구성 > 고급 > 시스템 ​을 클릭합니다.

  3. 전체 페이지 캐시 > 빠른 구성 > 사용자 지정 VCL 조각 ​을 확장합니다.

  4. 사용자 지정 코드 조각 만들기 ​를 클릭합니다.

  5. VCL 코드 조각 값을 추가합니다.

    • 이름 — bypass_fastly

    • 유형 — recv

    • 우선 순위 — 5

    • VCL 코드 조각 콘텐츠 —

      다음 예제에서는 특정 IP 주소에 대해 Fastly 를 우회합니다.

      code language-conf 
      if (client.ip == "<Your IPv4 IP address>" || client.ip == "<Your IPv6 IP address>") {
  return(pass);
}

      다음 예제는 특정 URL 패턴에 대해 Fastly를 우회합니다.

      code language-conf 
      if (req.url ~ "/media/feeds/GoogleShoppingHiVisNew.xml") {  return (pass);}

      정확한 URL을 일치시키려면 ~ 연산자 대신 == 연산자를 사용하십시오. 자세한 내용은 Fastly VCL 참조를 참조하십시오.

  6. 만들기 ​를 클릭합니다.

    VCL 코드 조각을 빠르게 우회

  7. 페이지가 다시 로드되면 Fastly 구성 섹션에서 Fastly에 VCL 업로드 ​를 클릭합니다.

  8. 업로드가 완료되면 페이지 상단의 알림에 따라 캐시를 새로 고칩니다.

    업로드 프로세스 중에 업데이트된 VCL 버전을 빠르게 확인합니다. 유효성 검사가 실패하면 사용자 지정 VCL 코드 조각을 편집하여 문제를 해결하십시오. 그런 다음 VCL을 다시 업로드합니다.

VCL 코드 조각을 추가한 후 다음 예와 같이 cURL 명령을 사용하여 지정된 IP 주소 또는 URL에서 원천 서버로 요청을 제출할 수 있습니다.

curl -svo /dev/null www.example.com/index.html

그런 다음 응답을 검사하여 캐시되지 않은 콘텐츠 문제를 해결합니다.

NOTE
사용자 지정 VCL 코드 조각을 수동으로 업로드하는 대신 사용자 환경의 $MAGENTO_CLOUD_APP_DIR/var/vcl_snippets_custom 디렉터리에 코드 조각을 추가할 수 있습니다. Commerce 관리자에서 VCL을 Fastly로 업로드 ​를 클릭하면 이 디렉터리의 스니펫이 자동으로 업로드됩니다. Magento 2 설명서는 Fastly CDN 모듈의 자동화된 사용자 지정 VCL 코드 조각 배포를 참조하십시오.

사용자 지정 VCL 코드 조각 수정

  1. 책임자에 로그인.

  2. 스토어 > 설정 > 구성 > 고급 > 시스템 ​을 클릭합니다.

  3. 전체 페이지 캐시 > 빠른 구성 > 사용자 지정 VCL 조각 ​을 확장합니다.

    사용자 지정 VCL 코드 조각 관리

  4. Action 열에서 편집할 코드 조각 옆에 있는 설정 아이콘을 클릭합니다.

  5. 페이지가 다시 로드되면 Fastly 구성 섹션에서 Fastly에 VCL 업로드 ​를 클릭합니다.

  6. 업로드가 완료되면 페이지 상단의 알림에 따라 캐시를 새로 고칩니다.

WARNING
사용자 지정 VCL 코드 조각 UI 옵션은 Adobe Commerce 관리자를 통해 추가된 코드 조각만 표시합니다. Fastly API를 사용하여 코드 조각을 추가하는 경우 API를 사용하여 관리하세요.

사용자 지정 VCL 코드 조각 삭제

  1. 책임자에 로그인.

  2. 스토어 > 설정 > 구성 > 고급 > 시스템 ​을 클릭합니다.

  3. 전체 페이지 캐시 > 빠른 구성 > 사용자 지정 VCL 조각 ​을 확장합니다.

    사용자 지정 VCL 코드 조각 관리

  4. Action 열에서 삭제할 코드 조각 옆에 있는 휴지통 아이콘을 클릭합니다.

  5. 다음 모달 창에서 DELETE ​를 클릭하고 새 버전을 활성화합니다.

WARNING
사용자 지정 VCL 코드 조각 UI 옵션은 Adobe Commerce 관리자를 통해 추가된 코드 조각만 표시합니다. Fastly API를 사용하여 코드 조각을 추가하는 경우 API를 사용하여 관리하세요.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26