시작하기

이 페이지에서는 Cloud CDN 이미지 최적화를 시작하는 데 도움이 되며, 이미지 최적화를 구성하는 방법과 지원되는 작업 목록을 예와 함께 설명합니다.

기본 요건

Cloud CDN 이미지 최적화가 작동하려면 다음 기본 요건을 충족해야 합니다.

  • Cloud CDN 캐시 정책은 URL 경로 또는 연결된 백엔드 서비스 또는 버킷에서 사용 설정되어야 하며 이미지 최적화 기능은 해당 URL 맵 경로에서 활성 상태여야 합니다.

  • 이미지 최적화는 전역 외부 애플리케이션 부하 분산기에서만 지원됩니다. 기존 애플리케이션 부하 분산기는 지원되지 않습니다.

  • 클라이언트 요청에는 image/webp, image/avif, image/* 또는 */*와 같은 이미지 콘텐츠를 수신할 수 있음을 나타내는 Accept 헤더가 포함되어야 합니다.

  • 원본 서버는 HTTP 200 상태 코드와 지원되는 이미지 Content-Type 헤더로 응답해야 합니다.

  • imop 쿼리 매개변수는 URL에 포함되어야 하며 하나 이상의 유효한 변환 작업을 포함해야 합니다.

이미지 최적화 구성

이미지 최적화를 사용하려면 관련 경로, 백엔드 서비스 또는 백엔드 버킷에서 Cloud CDN을 사용 설정해야 합니다.

gcloud

이미지 최적화 정책은 routeAction 객체 내에 정의되므로 YAML 파일에 구성을 추가하고 URL 맵으로 가져와야 합니다.

기존 URL 맵 구성을 로컬 YAML 파일로 내보냅니다.

gcloud beta compute url-maps export YOUR_URL_MAP_NAME \
    --global \
    --destination my-url-map.yaml

텍스트 편집기에서 my-url-map.yaml 파일을 수정하고 선택한 routeAction 또는 defaultRouteAction 섹션에 cachePolicy 필드를 추가합니다.

name: image-matcher
routeRules:
  --description: ImageOptimizationService
    matchRules:
       --prefixMatch: /images/
    priority: 1
    routeAction:
       imageOptimizationPolicy:
         queryParameterInterpretation: ENABLED

업데이트된 URL 맵 가져오기

gcloud beta compute url-maps import YOUR_URL_MAP_NAME \
    --global \
    --source my-url-map.yaml

지원되는 이미지 형식

Cloud CDN 이미지 최적화는 요청 구성 및 원본 콘텐츠 유형 헤더를 기반으로 특정 입력 및 출력 형식을 지원합니다.

지원되는 입력 형식

다음 형식은 원본 서버의 입력으로 지원됩니다.

  • HEIF
  • ICO
  • BMP
  • JP2K (JPEG 2000)

지원되는 출력 형식

Cloud CDN 에지는 다음 형식으로 최적화된 이미지 파생 상품을 처리, 캐시, 제공할 수 있습니다.

  • JPEG
  • GIF
  • PNG
  • TIFF
  • WEBP
  • AVIF
  • BRUNSLI

지원되는 원본 콘텐츠 유형

원본 서버가 다음 Content-Type 헤더 중 하나로 응답하면 이미지 최적화가 시도됩니다.

  • image/jpeg
  • image/png
  • image/webp
  • image/gif
  • image/bmp
  • image/tiff
  • image/avif
  • image/heif
  • image/jp2
  • image/x-j (brunsli)
  • text/ico, image/ico, image/icon, application/ico, image/x-icon, 또는 image/vnd.microsoft.icon

이미지 변환 URL

동적 이미지 변환을 수행하려면 이미지 URL에 imop 쿼리 매개변수를 추가합니다. 이 매개변수는 순서대로 적용되는 하나 이상의 작업으로 구성된 변환 문자열을 보유합니다.

변환 문자열은 다음 형식 규칙을 사용합니다.

  • 세미콜론 (;)을 사용하여 각 개별 작업을 구분합니다.
  • 쉼표 (,)를 사용하여 각 개별 작업 내의 내부 매개변수를 구분합니다.
  • 단일 쿼리 문자열에는 지정된 유형의 작업 하나만 포함될 수 있습니다.

기준 문법은 다음 구조를 사용합니다.

?imop=[OPERATION_1];[OPERATION_2];...[OPERATION_N]

이미지에 여러 작업을 동시에 수행하려면 연결된 매개변수 문자열을 이미지 URL에 추가합니다. 예를 들어 이미지의 너비를 800픽셀 로 조정하고 압축 품질을 85로 설정하고 형식을 WebP로 변환하려면 매개변수 문자열을 추가합니다.

예를 들면 다음과 같습니다.

https://www.example.com/image.jpg?imop=Resize,width=800;Compress,quality=85;Convert,format=webp;

정책 구조

이미지 최적화 정책은 이미지 최적화 기능의 기능과 관련된 모든 속성을 포함하는 핵심 구성 래퍼 역할을 합니다.

이름

설명

구성

queryParameterInterpretation

이미지 최적화의 쿼리 매개변수가 데이터 영역에서 해석되는지 여부를 결정하는 열거형 값입니다.

필수. DISABLED로 설정하면 변환 쿼리 매개변수가 정책에 의해 무시되어 이 기능이 사용 중지됩니다. ENABLED 로 설정하면 이 기능이 사용 설정됩니다.

정책 종속 항목 및 유효성 검사

이미지 최적화 정책은 Cloud CDN 캐싱에 종속됩니다. 이 기능이 작동하려면 다음 두 위치 중 하나에서 캐시 정책 을 명시적으로 설정해야 합니다.

  • 이미지 최적화 정책이 구성되는 동일한 URL 맵 경로

  • 해당 정확한 경로와 관련된 백엔드 서비스 또는 백엔드 버킷

이미지 최적화 정책은 활성 상태의 기본 캐시 정책과 함께 엄격하게 적용됩니다.

이미지 최적화 순서 지정 규칙

imop 쿼리 매개변수에 나열된 작업은 다음 절대 시스템 재정의를 제외하고 왼쪽에서 오른쪽으로 처리됩니다.

  • metadata 및 scale 작업은 항상 먼저 실행됩니다.
  • canvas 작업은 항상 마지막에 실행됩니다.

모든 입력 애셋은 이러한 변환이 실행되기 전에 자동 정규화를 거칩니다. EXIF 방향 마커와 ICC 색상 프로필은 메타데이터가 삭제되기 전에 이미지 픽셀에 직접 적용되므로 후속 구조적 작업에서 좌표 무결성이 정확하게 유지됩니다.

다음 단계