집 >웹 프론트엔드 >JS 튜토리얼 >JavaScript 컴퓨팅을 위한 모듈식 Edge Side Contains 구성 요소

JavaScript 컴퓨팅을 위한 모듈식 Edge Side Contains 구성 요소

Mary-Kate Olsen원래의: 2024-12-20 03:13:09466검색

A modular Edge Side Includes component for JavaScript Compute

2022년 여름, 팀 동료 Kailan은 Fastly Compute용 Rust 크레이트 작업을 진행하고 ESI(Edge Side Contains) 템플릿 언어의 하위 집합을 구현했으며 다음 내용에 대한 블로그 게시물을 게시했습니다. 그것. 이 기사는 우리가 유용한 라이브러리를 출시했을 뿐만 아니라 Compute가 우리에게 가져올 수 있는 것, 즉 모듈식 기능을 갖춘 프로그래밍 가능한 에지를 훌륭하게 보여줬기 때문에 중요했습니다. 이제 JavaScript가 Compute에서 1년 넘게 일반적으로 사용 가능해졌으므로 이제 JavaScript 사용자를 위한 유사한 솔루션이 필요할 때입니다. 이제 npm에서 사용할 수 있는 Fastly의 JavaScript용 ESI 라이브러리를 사용하면 애플리케이션에 강력한 ESI 처리 기능을 추가할 수 있습니다.

프로그래밍 가능성 및 모듈성

거의 10년 동안 Fastly의 CDN은 HTML 소스의 특수 태그를 해석하여 작동하는 템플릿 언어인 ESI(Edge Side Contains)를 지원해 왔습니다. 이는 태그를 중심으로 회전하며 에지 서버에 다른 문서를 가져와서 스트림에 인라인하도록 지시합니다.

index.html

<body>
<esi:include src="./header.html" />
<main>
Content
</main>
</body>

헤더.html

<header>Welcome to the web site</header>

출력


<header>Welcome to the web site</header>

Content

컴퓨트가 등장하면서 엣지 환경은 프로그래밍 가능성과 모듈성이라는 두 가지 주요 방식으로 바뀌었습니다.

Rust에 대한 플랫폼 지원이 안정화된 직후 우리는 ESI를 구현하고 프로그래밍 기능을 추가한 Rust용 크레이트를 게시했습니다. 이제 코드를 사용하여 추가 백엔드 요청을 작성하는 방법 및 응답 조각을 처리하는 방법을 구성할 수 있습니다. 백엔드 서버에서 생성되지 않은 문서에 대해 ESI 처리를 수행할 수도 있습니다. 이러한 프로그래밍 가능성은 우리가 제공하는 고정된 기능 세트로 제한되었던 VCL의 ESI 지원과 차별화되었습니다.

동시에 이 접근 방식은 고도로 모듈식이어서 프로그래머에게 요청별로 ESI 처리를 수행할 수 있는 선택권을 제공하고 호환되는 데이터 유형과 작동하는 다른 모듈과 처리를 결합하여 적용할 수 있는 옵션을 제공합니다. 순서 및/또는 지정된 논리적 조건에 관계없이 적용됩니다.

다음 목표: 자바스크립트

Rust 릴리스와 마찬가지로 우리는 이 JavaScript 라이브러리를 프로그래밍할 수 있기를 원했습니다. Fastly의 JavaScript 지원에는 항상 Fetch API와 그에 따른 Streams API가 포함되어 있습니다. Streams API의 유용한 기능 중 하나는 TransformStream 인터페이스로, 변환을 적용하기 위해 객체를 통해 데이터를 "파이프"할 수 있어 ESI에 적합합니다. ESI 프로세서를 TransformStream 구현으로 구현함으로써 이를 JavaScript로 작성된 Fastly Compute 애플리케이션에 바로 적용할 수 있었습니다.

스트리밍 방법은 다음과 같습니다.

<body>
<esi:include src="./header.html" />
<main>
Content
</main>
</body>

EsiTransformStream이라고 하는 변환은 스트림에 직접 적용되어 메모리 및 성능 문제를 완화합니다. 이는 다음을 의미합니다.

변환을 적용하기 전에 전체 업스트림 응답을 버퍼링할 필요가 없습니다.
변환기는 업스트림 응답을 최대한 빨리 소비하고 ESI 태그가 스트림에 표시되는 대로 처리합니다. 변환기가 각 ESI 태그 처리를 마치면 결과가 즉시 다운스트림으로 공개되므로 가능한 최소한의 버퍼를 보유할 수 있습니다. 이를 통해 클라이언트는 스트리밍 결과가 완전히 처리될 때까지 기다리지 않고도 준비가 되면 스트리밍 결과의 첫 번째 바이트를 받을 수 있습니다.

또한 이 디자인은 모듈식이므로 EsiTransformStream은 다른 도구와 함께 사용할 수 있는 또 다른 도구입니다. 예를 들어 압축과 같이 응답에 적용하려는 다른 변환이 있을 수 있으며 완전히 표준 인터페이스이기 때문에 응답은 이러한 변환 스트림을 통해 원하는 수만큼 파이프될 수 있습니다. 원하는 경우 요청 헤더, 경로 또는 응답 콘텐츠 유형 등 특정 요청이나 응답에 대해서만 ESI를 조건부로 활성화할 수도 있습니다.

EsiTransformStream을 인스턴스화하는 방법은 다음과 같습니다.

<header>Welcome to the web site</header>

생성자는 URL과 Headers 개체를 사용하고 선택적으로 일부 옵션을 세 번째 매개변수로 사용합니다. 앞서 설명했듯이 ESI의 주요 기능은 결과 스트림에 포함할 추가 템플릿을 다운로드하는 것입니다. 태그는 가져오기를 기본 메커니즘으로 사용하여 템플릿을 검색하며 이러한 매개변수의 주요 목적은 가져오기 호출을 구성하는 것입니다.

URL은 의 src에서 상대 경로를 확인하는 데 사용됩니다. 태그.
헤더는 템플릿을 가져오기 위해 추가 요청을 할 때 사용됩니다.
선택적 구성 객체를 사용하면 가져오기 동작을 재정의하고 가져온 템플릿 처리 방법, 사용자 정의 오류 처리 등 기타 사용자 정의 동작을 적용할 수 있습니다.

가장 간단한 경우에는 구성 개체의 가져오기 값만 사용합니다. 제공하지 않으면 대신 전역 가져오기 기능을 사용하지만 Compute에서는 템플릿을 포함할 때 사용할 가져오기에 대한 백엔드를 지정해야 합니다(동적 백엔드 기능을 사용하지 않는 한). 위의 예시 스니펫은 전역 가져오기를 호출하기 전에 Origin_0이라는 백엔드를 할당합니다.

그렇습니다! 이 간단한 설정을 통해 ESI 태그를 제공하는 백엔드와 이를 처리하는 Compute 애플리케이션을 가질 수 있습니다. 실행할 수 있는 전체 예는 다음과 같습니다.

fiddle.fastly.dev

ESI 기능 지원

이 구현은 과거에 제공했던 다른 기능보다 더 많은 ESI 기능을 제공합니다.

오류 처리

가끔 태그가 존재하지 않거나 서버 오류로 인해 가져오지 못할 수 있습니다. 이러한 경우 onerror="continue" 속성을 추가하면 오류를 무시할 수 있습니다.

<body>
<esi:include src="./header.html" />
<main>
Content
</main>
</body>

/templates/header.html에서 오류가 발생하면 ESI 프로세서는 오류를 자동으로 무시하고 전체 빈 문자열로 태그를 지정하세요.

를 사용하여 보다 구조화된 오류 처리를 사용할 수도 있습니다. 블록은 다음과 같습니다.

<header>Welcome to the web site</header>

ESI 프로세서는 먼저 의 내용을 실행합니다. esi:include 태그로 인해 오류가 발생하면 ESI 프로세서는 의 내용을 실행합니다.

전체 블록은 성공하면 차단되거나 오류가 있는 경우. 위의 예에서 /templates/header.html로 인해 오류가 발생하면 "Main header" 텍스트도 출력에 표시되지 않습니다. "대체 헤더" 텍스트만 포함됩니다. 자세한 내용은 ESI 언어 사양을 참조하세요.

조건부

ESI는 변수에 대한 런타임 검사를 수행하여 조건부 실행도 허용합니다. 다음은 그러한 검사의 예입니다.


<header>Welcome to the web site</header>

Content

프로세서가 블록에서는 블록, 테스트 속성에 설정된 표현식을 확인합니다. 프로세서는 식이 true로 평가되는 첫 번째 esi:when 블록을 실행합니다. 어떤 표현식도 true로 평가되지 않으면 esi:otherwise 블록이 제공되면 선택적으로 실행됩니다. 전체 블록은 또는 실행되는 블록입니다.

프로세서는 주로 요청 쿠키를 기반으로 하는 제한된 변수 세트를 제공합니다. 위의 예에서는 이름이 "group"인 HTTP 쿠키의 값을 확인합니다. 우리의 구현은 ESI 언어 사양을 기반으로 합니다. 자세한 내용은 참고하세요.

지원되는 태그 및 기능 목록

이 구현은 ESI 언어 사양의 다음 태그를 지원합니다.

esi:포함
esi:댓글
esi:제거
esi:시도 / esi:시도 / esi:제외
esi:선택 / esi:언제 / esi:그렇지 않으면
esi:vars

태그는 사양에 선택사항으로 정의되어 있으며 이 구현에는 포함되지 않습니다.

ESI 변수는 ESI 태그의 속성에서 지원되며, ESI 표현식은 의 테스트 속성에서 지원됩니다. 또한 댓글이 지원됩니다.

맞춤형 동작은 무한한 가능성을 의미합니다

기능 세트도 기대하기에 충분하지만, 프로그래밍 가능의 가장 흥미로운 부분은 훨씬 더 많은 일이 가능하다는 것입니다. 템플릿을 가져오는 것이 ESI의 주요 용도이지만 이것이 ESI의 전부는 아닙니다. 예시는 다음과 같습니다.

'2일 전'과 같이 문서가 표시될 때 상대 날짜로 표시하려는 타임스탬프가 문서에 마크업되어 있다고 생각해 보세요. 이를 수행하는 방법은 여러 가지가 있지만 최상의 성능과 메모리 영향을 얻으려면 스트림에서 찾기/바꾸기를 수행하는 것이 좋습니다. 이 ESI 라이브러리를 프로그래밍하는 것은 실제로 이 작업을 수행하는 데 좋은 옵션으로 사용될 수 있습니다.

다음과 같은 형식으로 특별히 제작된 ESI 태그를 사용하여 백엔드 문서에 인코딩할 타임스탬프를 정의할 수 있습니다.

<body>
<esi:include src="./header.html" />
<main>
Content
</main>
</body>

예를 들어, 이 스니펫은 2024년 1월 1일 자정(태평양 표준시)을 나타낼 수 있습니다.

<header>Welcome to the web site</header>

이제 해당 URL 패턴이 발견될 때마다 합성 대체 문서를 제공하도록 EsiTransformStream을 설정합니다.


<header>Welcome to the web site</header>

Content

이제 프로세서가 위의 예제 스니펫을 발견하면 다음과 유사한 결과를 내보냅니다(앞으로 실행하는 일 수에 따라 다름).

const transformedBody = resp.body.pipeThrough(esiTransformStream);

return new Response(
  transformedBody,
  {
    status: resp.status,
    headers: resp.headers,
  },
);

Fastly에서 백엔드 문서를 캐시할 수 있으므로 향후 요청은 캐시 HIT의 이점을 누릴 수 있으며 처리 과정에서는 업데이트된 상대 시간이 계속 표시됩니다.

실시간 예를 보려면 다음 바이올린을 확인하세요.

fiddle.fastly.dev

한번 시도해 보세요!

@fastly/esi는 이제 npm에서 사용할 수 있으며 모든 JavaScript 프로그램에 추가할 수 있습니다. 물론 Fastly Compute 프로그램의 엣지에서 사용하지만 실제로 환경이 fetch API를 지원하는 한 Compute 외부에서도 작동합니다. 전체 소스 코드는 GitHub에서 확인할 수 있습니다.

Fastly 계정을 만들기 전에 먼저 위의 Fiddle 중 하나를 복제하고 자신의 원본으로 테스트해 보세요. 당사 글로벌 네트워크에 서비스를 게시할 준비가 되면 Compute 무료 평가판에 등록한 후 npm에서 ESI 라이브러리를 바로 시작할 수 있습니다.

Compute를 사용하면 엣지를 프로그래밍하고 모듈식으로 구성할 수 있습니다. 자신에게 가장 적합한 솔루션을 선택하고 결합하거나 직접 구축할 수도 있습니다. Compute에 이와 같은 모듈을 제공할 수 있는 회사는 우리 뿐만이 아닙니다. 누구나 생태계에 기여하고 그로부터 얻을 수 있습니다. 그리고 언제나처럼 Fastly 커뮤니티 포럼에서 우리를 만나 여러분이 무엇을 구축했는지 알려주세요!

위 내용은 JavaScript 컴퓨팅을 위한 모듈식 Edge Side Contains 구성 요소의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명：

이전 기사：React Router 기본 사항 이해: React에서 탐색 관리다음 기사：React Router 기본 사항 이해: React에서 탐색 관리