시작하기

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

기본 요건

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

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

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

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

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

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

이미지 최적화 구성

이미지 최적화를 사용하려면 활성 캐싱이 사용 설정되어 있어야 합니다. 다음 중 하나 이상을 구성해야 합니다.

  • 백엔드 기반 캐싱: 백엔드에 Cloud CDN 사용 설정 이 선택되어 있는지 확인합니다.

  • URL 맵 수준 캐싱: 이미지 최적화를 사용 설정하려는 특정 경로에 대해 URL 맵 수준 에서 캐시 정책이 구성되어 있는지 확인합니다.

gcloud

경로 작업 객체 내에 이미지 최적화 정책이 정의되어 있으므로 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 섹션에 imageOptimizationPolicy 필드를 추가합니다.

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

콘솔

  1. Google Cloud 콘솔에서 부하 분산 페이지로 이동합니다.

    부하 분산 페이지로 이동

  2. 전역 외부 애플리케이션 부하 분산기 이름을 클릭합니다.
  3. 수정 을 클릭합니다.
  4. 백엔드 구성 탭으로 이동합니다.
  5. 캐싱 구성: 이미지 최적화를 사용하려면 활성 캐싱이 사용 설정되어 있어야 합니다. 이미지 최적화가 작동하도록 다음 중 하나를 선택하고 구성합니다.
    • 백엔드 기반: 백엔드 서비스 구성에서 Cloud CDN 사용 설정 이 선택되어 있는지 확인합니다.
    • URL 맵 수준:
      1. 라우팅 규칙 으로 이동하여 고급 호스트 및 경로 규칙 을 선택합니다.
      2. 이미지 최적화를 사용 설정하는 경로에서 URL 맵 수준으로 캐시 정책을 정의합니다.

라우팅 아키텍처에 따라 라우팅 규칙 중 하나를 선택합니다.

기본 라우팅 규칙을 사용하려면 다음 단계를 따르세요.

  1. 호스트 및 경로 규칙 섹션의 작업에서 단일 백엔드 모드로 트래픽 라우팅을 선택한 후 목록에서 백엔드를 선택합니다.
  2. 이미지 최적화 섹션 (기본적으로 축소됨)을 펼칩니다.
  3. 이미지 최적화 사용 설정 체크박스를 선택합니다.

커스텀 라우팅 규칙을 사용하려면 다음 단계를 따르세요.

  1. 호스트 및 경로 규칙 섹션에서 호스트 및 경로 규칙 추가 를 선택합니다.
  2. 호스트 필드에 * 를 입력하여 모든 호스트 이름과 일치시킵니다.
  3. 경로 일치자 섹션에서 YAML 편집기를 사용하여 구성을 정의합니다.
  4. 코드에 관한 안내를 보려면 YAML 편집기 아래의 코드 안내 를 클릭합니다.
  5. 스니펫을 복사하여 YAML 편집기에 붙여넣습니다.
  6. 자리표시자 값을 업데이트합니다.

구성 검토

  1. 구성을 검토합니다.
  2. 완료 를 클릭하여 하위 편집기를 닫습니다.
  3. 업데이트 를 클릭하여 구성을 저장합니다.

지원되는 이미지 형식

Cloud CDN 이미지 최적화는 원본 서버의 다양한 입력 형식을 지원합니다. 대부분의 형식은 처리 및 출력에 사용할 수 있지만 일부 형식은 입력 전용이며 대상 출력 형식으로 사용할 수 없습니다.

원본 서버에서 지원되는 이미지 형식은 다음과 같습니다.

형식 Content-Type 헤더 입력/출력 사용 사례 시나리오
gif image/gif 입력 및 출력 표준 애니메이션/정지 형식입니다. 애니메이션 프레임은 추출할 수 있습니다 Freeze 작업을 사용하여.
png image/png 입력 및 출력 투명도, 로고, 디지털 아트에 적합한 무손실 형식입니다.
webp image/webp 입력 및 출력 손실 및 무손실 압축이 모두 포함된 최신 웹 최적화 형식입니다.
jpeg image/jpeg 입력 및 출력 표준 사진 형식입니다.
brunsli image/x-j 입력 및 출력 고효율 무손실 JPEG 재패킹 형식입니다.
tiff image/tiff 입력 및 출력 고품질 태그 기반 래스터 형식입니다.
avif image/avif 입력 및 출력 고효율 차세대 이미지 형식입니다.
bmp image/bmp 입력 전용 출력 형식으로 지정할 수 없습니다. ?imop=Convert,format=webp를 사용하여 WebP 또는 JPEG로 변환합니다.
ico text/ico, image/ico, image/icon, application/ico, image/x-icon, image/vnd.microsoft.icon 입력 전용 아이콘 컨테이너 형식입니다. 내보낼 수 없습니다. 전송을 위해 지원되는 출력 형식으로 변환합니다.
jp2k image/jp2 입력 전용 JPEG 2000 형식입니다. Convert 작업을 사용하여 명시적으로 변환해야 합니다.
heif image/heif 입력 전용 고효율 이미지 형식입니다. 에지 전송 전에 변환해야 합니다.

이미지 변환 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 색상 프로필은 메타데이터가 삭제되기 전에 이미지 픽셀에 직접 적용되므로 후속 구조적 작업에서 좌표 무결성이 정확하게 유지됩니다.

다음 단계