플러그인을 Media CDN 경로에 연결

이 페이지에서는 Media CDN 경로에서 서비스 확장 프로그램 플러그인을 구성하는 방법을 설명합니다.

서비스 확장 프로그램과 함께 Media CDN을 사용해서 요청-응답 처리 경로에 커스텀 코드를 추가할 수 있습니다. 이러한 맞춤설정은 여러 가지 가벼운 사용 사례를 잠금 해제합니다.

시작하기 전에

플러그인의 Wasm 작업 만들기

Wasm 작업을 만들 때는 Cloud Load Balancing 확장 프로그램에서 이미 사용 중인 플러그인을 사용할 수 없습니다.

gcloud alpha service-extensions wasm-actions create 명령어를 실행하여 서비스 확장 프로그램 플러그인의 Wasm 작업을 만듭니다.

gcloud alpha service-extensions wasm-actions create WASM_ACTION \
    --wasm-plugin=WASM_PLUGIN \
    --supported-events=[EVENT,...]

다음을 바꿉니다.

WASM_ACTION: Wasm 작업의 ID 또는 정규화된 이름
WASM_PLUGIN: 작업을 연결할 플러그인의 이름
EVENT: 플러그인에서 처리할 페이로드 부분입니다. request-headers 또는 response-headers 값 중 하나 또는 둘 다로 표시됩니다. 지정하지 않으면 두 헤더가 모두 처리됩니다.

Wasm 작업을 만드는 데 다소 시간이 걸릴 수 있습니다.

경로에 플러그인 연결

Media CDN 경로에 플러그인을 연결하려면 다음 단계를 따르세요.

현재 서비스 구성을 YAML 파일로 내보내려면 gcloud edge-cache services export 명령어를 실행합니다.
```
  gcloud edge-cache services export SERVICE_NAME \
      --destination=FILENAME.yaml
```
다음을 바꿉니다.
- SERVICE_NAME: Media CDN 서비스의 이름입니다.
- FILENAME: YAML 파일의 이름입니다.
텍스트 편집기를 사용하여 YAML 파일을 수정합니다.

다음 예시에 표시된 것처럼 파일의 경로를 업데이트하여 wasmAction 헤더를 추가합니다.

  name: SERVICE_NAME
  routing:
    hostRules:
    - hosts:
      - DOMAIN_NAME 
      pathMatcher: routes
    pathMatchers:
    - name: routes
      routeRules:
      - priority: '1'
        description: Route 1
        matchRules:
        - prefixMatch: /plugins
        origin: projects/PROJECT_NUMBER/locations/global/edgeCacheOrigins/ORIGIN_NAME
        routeAction:
          wasmAction: projects/PROJECT_NUMBER/locations/global/wasmActions/WASM_ACTION

다음을 바꿉니다.

SERVICE_NAME: Media CDN 서비스의 이름입니다.
DOMAIN_NAME: Media CDN 서비스의 도메인입니다.
PROJECT_NUMBER: 프로젝트 번호입니다.
ORIGIN_NAME: 콘텐츠 원본입니다.
WASM_ACTION: 서비스 확장 프로그램 Wasm 작업입니다.

YAML 파일을 저장합니다.

gcloud edge-cache services import 명령어를 실행합니다.

  gcloud edge-cache services import SERVICE_NAME \
      --source=FILENAME.yaml

새 플러그인이 모든 위치에 배포되는 데 다소 시간이 걸릴 수 있습니다. 플러그인이 모든 위치에 동시에 제공되지 않으므로 위치에 따라 시간이 다를 수 있습니다.