regex이(가) 아닌 리디렉션을 Nginx (경로) 대신 Fastly (으)로 오프로드

이 항목에서는 클라우드 인프라의 Adobe Commerce에서 regex이 아닌 리디렉션을 Nginx 대신 Fastly (으)로 오프로드할 때 발생할 수 있는 일반적인 리디렉션 성능 문제에 대한 해결 방법을 제안합니다.

영향을 받는 제품 및 버전

  • 클라우드 인프라(모든 버전) Master/Production/Staging 환경에서 Fastly을(를) 활용하는 Adobe Commerce

문제

클라우드 인프라의 Adobe Commerce에서는 Nginx 계층에서 regex이(가) 아닌 많은 리디렉션/다시 쓰기를 수행할 수 없으므로 성능 문제가 발생할 수 있습니다.

원인

.magento/routes.yaml 디렉터리의 routes.yaml 파일은 클라우드 인프라의 Adobe Commerce 경로를 정의합니다.

routes.yaml 파일의 크기가 32KB 이상인 경우 regex이 아닌 사용자가 Fastly에 리디렉션/다시 쓰는 작업을 오프로드해야 합니다.

이 Nginx 레이어는 많은 수의 regex이(가) 아닌 리디렉션/다시 쓰기를 처리할 수 없습니다. 그렇지 않으면 성능 문제가 발생합니다.

솔루션

해결 방법은 regex이 아닌 리디렉션을 대신 Fastly (으)로 오프로드하는 것입니다. Fastly (으)로 리디렉션할 일반 오류 경로를 만듭니다.

다음 단계에서는 Nginx 대신 Fastly에 리디렉션을 배치하는 방법을 자세히 설명합니다.

  1. Edge 사전 만들기

    먼저 VCL Adobe Commerce의 코드 조각을 사용하여 Edge 사전을 정의할 수 있습니다. 여기에는 리디렉션이 포함됩니다.

    이에 대한 몇 가지 주의 사항:

    • Fastly은(는) 사전 항목에서 regex을(를) 수행할 수 없습니다. 정확히 일치할 뿐입니다. 이러한 제한 사항에 대한 자세한 내용은 Fastly의 Edge 사전 제한 사항을 참조하십시오.

    • Fastly은(는) 단일 사전에 1000개의 항목으로 제한됩니다. Fastly이(가) 이 제한을 확장할 수 있지만 세 번째 경고가 표시됩니다.

    • 항목을 업데이트하고 업데이트된 VCL을(를) 모든 노드에 배포할 때마다 사전을 확장하여 기하학적인 로드 시간이 늘어납니다. 즉, 2000개 항목 사전이 실제로 1000개 항목 사전보다 3x-4x 느리게 로드됩니다. 그러나 이는 VCL을(를) 배포(사전을 업데이트하거나 VCL 함수 코드를 변경)할 때만 문제가 됩니다.

      요청을 처리하는 데 Fastly이(가) 걸리는 시간에는 영향을 주지 않습니다. 새 구성을 푸시하는 데 Fastly이(가) 걸리는 시간에만 영향을 줍니다.

      일반적으로 구성 변경은 평균적으로 몇 초 정도 걸리며 일반적으로 5~10초 이내로 이루어집니다. 따라서 사전 항목이 2배 증가하면 구성이 롤아웃되는 데 30초 이상 걸립니다. 4배 증가하면 2분에 가까워집니다. 이것은 네 번째 주의로 이어진다.

    • 가장자리 사전에는 10,000개의 항목이라는 상당히 엄격한 제한이 있다.

    리디렉션 목록을 통합하는 것이 좋습니다. 여러 사전을 사용할 수 있지만 VCL에 대한 모든 업데이트는 실제로 Fastly에서 채우는 데 몇 분이 소요됩니다.

  2. URL을(를) 사전에 비교합니다.

    URL 조회가 발생할 때 일치하는 항목이 있는 경우 사용자 지정 오류 코드를 적용하기 위해 비교합니다.

    다른 VCL 코드 조각을 사용하여 vcl_recv에 다음과 같은 항목을 추가하십시오.

    code language-none
         declare local var.redir-path STRING;
         set var.redir-path = table.lookup(redirects, std.tolower(req.url), "");
    
         if (var.redir-path != "") {
           error 912 var.redir-path;
         }
    

    테이블 항목에 URL이(가) 있는지 확인하는 중입니다. 그럴 경우 내부 Fastly 오류를 호출하고 테이블에서 리디렉션 URL을(를) 해당 오류로 전달합니다.

  3. 리디렉션을 관리합니다.

    일치 항목이 발견되면 해당 obj.status에 대해 정의된 작업이 수행됩니다(이 경우 301 영구 이동 리디렉션).

    vcl_error에서 최종 코드 조각을 사용하여 301 오류 코드를 클라이언트로 다시 보냅니다.

    code language-none
      if (obj.status == 912) {
         set obj.http.location = obj.response;
         set obj.status = 301;
         set obj.response = "Moved Permanently";
         return(deliver);
           }
    

    이 블록을 사용하여 vcl_recv에서 전달된 오류 코드와 일치하는지 확인하고 있으며 일치하는 경우 전달된 오류 메시지로 위치를 설정한 다음 상태 코드를 301로 변경하고 메시지를 "영구적으로 이동됨"으로 변경합니다. 이 시점에서 응답은 클라이언트로 돌아갈 준비가 되어 있어야 합니다.

스테이지 서비스

WARNING
이 모든 단계를 수행하려는 경우 Adobe Commerce 스테이징 환경을 설정하는 것이 좋습니다. 이렇게 하면 Fastly 서비스에 대해 테스트를 실행하여 모든 것이 예상대로 작동하는지 확인할 수 있습니다.

Adobe Commerce 스테이징 환경을 실행하지 않고 이러한 리디렉션의 모양을 보려면 Fastly에서 직접 스테이징 계정을 설정할 수 있습니다.

관련 읽기

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a