사용자 정의 VCL 시작하기

Fastly는 사용자 요구 사항에 맞게 Fastly 서비스 구성을 맞춤화하기 위해 사용자 지정된 버전의 Vcl(Varnish Configuration Language)을 지원합니다.

사용자 지정 VCL 코드 조각은 Adobe Commerce 사이트에 업로드된 활성 VCL 버전에 추가된 VCL 로직의 블록입니다. 사용자 지정 VCL 코드 조각은 Fastly 캐싱 서비스가 요청 트래픽에 응답하는 방식을 수정합니다. 예를 들어 사용자 지정 VCL 코드 조각을 추가하여 지정된 클라이언트 IP 주소의 요청 트래픽만 허용할 수 있습니다. 또는 Adobe Commerce 사이트로 참조 스팸을 보내는 것으로 알려진 웹 사이트의 트래픽을 차단하는 코드 조각을 만듭니다.

사용자 정의 VCL 조각(생성, 컴파일 및 모든 Fastly 캐시에 전송)은 서버 다운타임 없이 로드 및 활성화됩니다.

Fastly는 두 가지 유형의 사용자 지정 VCL 코드 조각을 지원합니다.

Edge 사전 및 ACL(액세스 제어 목록)과 함께 사용자 지정 VCL 코드 조각을 사용하여 사용자 지정 코드에 사용되는 데이터를 저장하는 것이 좋습니다.

딕셔너리 및 ACL 데이터는 네트워크 지역에서 액세스할 수 있는 Fastly Edge 노드에 배포됩니다. 또한 스테이징 또는 프로덕션 환경에 맞게 VCL 코드를 다시 배포하지 않고도 네트워크를 통해 데이터를 동적으로 업데이트할 수 있습니다.

튜토리얼

이 자습서와 예제는 Edge 사전 및 Edge ACL과 함께 일반 사용자 지정 VCL 조각을 사용하여 Adobe Commerce에 대한 Fastly 서비스 구성을 사용자 지정하는 방법을 보여줍니다. 자세한 내용은 Fastly 설명서를 참조하십시오.

Adobe Commerce 관리자 또는 Fastly API를 사용하여 사용자 지정 VCL 코드 조각을 만들고 관리할 수 있습니다.

예제 VCL 코드 조각

다음 예는 클라이언트 IP 주소별로 트래픽을 필터링하는 사용자 지정 VCL 코드 조각(JSON 형식)을 보여 줍니다.

{
  "service_id": "FASTLY_SERVICE_ID",
  "version": "{Editable Version #}",
  "name": "apply_acl",
  "priority": "100",
  "dynamic": "1",
  "type": "hit",
  "content": "if ((client.ip ~ {ACLNAME}) && !req.http.Fastly-FF){ error 403; }"
}

content 필드의 VCL 논리는 다음 작업을 수행합니다.

다음 표는 사용자 지정 VCL 조각의 주요 데이터에 대한 세부 정보를 제공합니다. 자세한 참조는 Fastly 설명서에서 VCL 코드 조각 참조를 참조하십시오.

관리자로부터 사용자 지정 VCL 관리

관리자의 빠른 구성 > 사용자 지정 VCL 조각 섹션에서 사용자 지정 VCL 조각을 추가할 수 있습니다.

사용자 지정 VCL 코드 조각 보기에는 관리자를 통해 추가된 코드 조각만 표시됩니다. Fastly API를 사용하여 코드 조각이 추가된 경우 API를 사용하여 관리하세요.

다음 예에서는 관리자로부터 사용자 지정 VCL 코드 조각을 만들고 관리하고 Fastly Edge 모듈 및 Edge 사전을 사용하는 방법을 보여 줍니다.

API를 사용하여 VCL 관리

다음 연습에서는 일반 VCL 코드 조각 파일을 만들고 Fastly API를 사용하여 Fastly 서비스 구성에 추가하는 방법을 보여줍니다. 터미널 응용 프로그램에서 코드 조각을 만들고 관리할 수 있습니다. 특정 환경에 SSH 연결이 필요하지 않습니다.

필수 구성 요소:

VCL 코드 조각 추가

이 자습서에서는 Fastly API를 사용하여 사용자 지정 스니펫을 추가하는 기본 단계를 제공합니다.

필수 구성 요소

1단계: 활성 VCL 버전 찾기

Fastly API 버전 가져오기 작업을 사용하여 활성 VCL 버전 번호를 가져옵니다.

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/active

JSON 응답에서 number 키에 반환된 활성 VCL 버전 번호(예: "number": 99)를 확인합니다. 편집할 VCL을 복제할 때 버전 번호가 필요합니다.

{
  "testing": false,
  "locked": true,
  "number": 99,
  "active": true,
  "service_id": "872zhjyxhto5SIRb3GAE0",
  "staging": false,
  "created_at": "2019-01-29T22:38:53Z",
  "deleted_at": null,
  "comment": "Magento Module uploaded VCL",
  "updated_at": "2019-01-29T22:39:06Z",
  "deployed": false
}

후속 API 요청에 사용할 기본 환경 변수에 활성 버전 번호를 저장합니다.

export FASTLY_VERSION_ACTIVE=<Version>

2단계: 활성 VCL 버전 및 모든 코드 조각 복제

사용자 지정 VCL 조각을 추가하거나 수정하려면 먼저 편집할 활성 VCL 버전의 복사본을 생성해야 합니다. Fastly API clone 작업 사용:

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/$FASTLY_VERSION_ACTIVE/clone -X PUT

JSON 응답에서 버전 번호가 증가하고 활성 키 값은 false입니다. 새 비활성 VCL 버전을 로컬로 수정할 수 있습니다.

{
  "testing": false,
  "locked": false,
  "number": 100,
  "active": false,
  "service_id": "vW2bLFWhhto5SIRb3GAE0",
  "staging": false,
  "created_at": "2019-01-29T22:38:53Z",
  "deleted_at": null,
  "comment": "Magento Module uploaded VCL",
  "updated_at": "2019-01-29T22:39:06Z",
  "deployed": false
}

후속 명령에 사용할 수 있도록 기본 환경 변수에 새 버전 번호를 저장합니다.

export FASTLY_EDIT_VERSION=<Version>

3단계: 사용자 지정 VCL 코드 조각 만들기

다음 콘텐츠 및 형식을 사용하여 JSON 파일에 사용자 지정 VCL 코드를 만들고 저장합니다.

{
  "name": "<name>",
  "dynamic": "0",
  "type": "<type>",
  "priority": "100",
  "content": "<code all in one line>"
}

값에는 다음이 포함됩니다.

4단계: Fastly 구성에 VCL 코드 조각 추가

Fastly API 코드 조각 만들기 작업을 사용하여 사용자 지정 VCL 코드 조각을 VCL 버전에 추가하십시오.

curl -H "Fastly-Key: $FASTLY_API_TOKEN" https://api.fastly.com/service/$FASTLY_SERVICE_ID/version/$FASTLY_EDIT_VERSION/snippet -H 'Content-Type: application/json' -X POST --data @<filename.json>

<filename.json>은(는) 이전 단계에서 준비한 파일의 이름입니다. 각 VCL 스니펫에 대해 이 명령을 반복합니다.

Fastly 서비스에서 500 Internal Server Error 응답을 받은 경우 JSON 파일 구문을 확인하여 올바른 파일을 업로드하고 있는지 확인하십시오.

5단계: 사용자 지정 VCL 코드 조각의 유효성 검사 및 활성화

사용자 지정 VCL 코드 조각을 추가한 후 는 편집 중인 VCL 버전에 코드 조각을 삽입합니다. 변경 사항을 적용하려면 다음 단계를 완료하여 VCL 코드 조각의 유효성을 검사하고 VCL 버전을 활성화합니다.

VCL 코드 조각에 대한 API 빠른 참조

이러한 API 요청 예는 내보낸 환경 변수를 사용하여 Fastly로 인증할 자격 증명을 제공합니다. 이러한 명령에 대한 자세한 내용은 Fastly API 참조를 참조하십시오.