본문으로 건너뛰기

EnvoyFilter로 HTTP 압축 관리하기

Compressor​

References
spec:
  configPatches:
    - applyTo: HTTP_FILTER
      match:
        context: SIDECAR_INBOUND
        listener:
          filterChain:
            filter:
              name: envoy.filters.network.http_connection_manager
              subFilter:
                name: envoy.filters.http.router
      patch:
        operation: INSERT_BEFORE
        value:
          name: envoy.filters.http.compressor
          typed_config:
            "@type": type.googleapis.com/envoy.extensions.filters.http.compressor.v3.Compressor
            response_direction_config:
              common_config:
                min_content_length: 1024
            compressor_library:
              name: text_optimized
              typed_config:
                "@type": type.googleapis.com/envoy.extensions.compression.brotli.compressor.v3.Brotli
  • content_length
    • 최소 response 길이입니다.
    • 기본값은 30입니다.
  • content_type
    • 압축이 적용될 mime-types 입니다.
    • 기본값은 ["application/javascript", "application/json", "application/xhtml+xml", "image/svg+xml", "text/css", "text/html", "text/plain", "text/xml"] 입니다.
  • disable_on_etag_header
  • remove_accept_encoding_header
  • runtime_enabled

  • request_direction_config
    • 설정하지 않으면 기본적으로 비활성화 됩니다.
    • common_config
      • enabled
        • default_value
        • runtime_key
      • min_content_length
      • content_type
  • response_direction_config
    • 설정하지 않으면 기본적으로 활성화 됩니다.
    • common_config
      • enabled
        • default_value
        • runtime_key
      • min_content_length
      • content_type
    • disable_on_etag_header
    • remove_accept_encoding_header
  • choose_first
  • compressor_library

compressor_library​

Gzip​

References
spec:
  configPatches:
    - patch:
        value:
          typed_config:
            compressor_library:
              name: text_optimized
              typed_config:
                "@type": type.googleapis.com/envoy.extensions.compression.gzip.compressor.v3.Gzip
  • memory_level
    • 1 ~ 9 까지 값을 가질 수 있으며, 클 수록 메모리를 많이 사용하지만 빨라지고 압축 결과가 좋아집니다.
    • 기본값은 5 입니다.
  • compression_level
    • COMPRESSION_LEVEL_N으로 설정할 수 있으며 N은 1 ~ 9 까지의 값을 가집니다.
    • BEST_SPEED == COMPRESSION_LEVEL_1
    • DEFAULT_COMPRESSION == COMPRESSION_LEVEL_6
    • BEST_COMPRESSION == COMPRESSION_LEVEL_9
  • compression_strategy
    • DEFAULT_STRATEGY
    • FILTERED
    • HUFFMAN_ONLY
    • RLE
    • FIXED
  • window_bits
    • 압축기 window 크기는 2 ^ window_bits 로 설정됩니다. 9 ~ 15 사이 값을 가지며, 클 수록 더 많은 메모리를 사용하는 대신 압축 결과가 좋아집니다.
    • 기본값은 12 입니다.
  • chunk_size
    • 출력 버퍼 크기입니다.
    • 기본값은 4096 입니다.

Brotli​

References
spec:
  configPatches:
    - patch:
        value:
          typed_config:
            compressor_library:
              name: text_optimized
              typed_config:
                "@type": type.googleapis.com/envoy.extensions.compression.brotli.compressor.v3.Brotli
  • quality
    • 0 ~ 11 까지 값을 가질 수 있으며, 클 수록 느려지는 대신 압축 결과가 좋아집니다.
    • 기본값은 3 입니다.
  • encoder_mode
    • DEFAULT == GENERIC
    • TEXT
    • FONT
  • window_bits
    • 압축기 window 크기는 2 ^ window_bits 로 설정됩니다. 10 ~ 24 사이 값을 가지며, 클 수록 더 많은 메모리를 사용하는 대신 압축 결과가 좋아집니다.
    • 기본값은 18 입니다.
  • input_block_bits
    • 16 ~ 24 까지 값을 가질 수 있으며, 클 수록 더 많은 메모리를 사용하는 대신 압축 결과가 좋아집니다.
    • 기본값은 24 입니다.
  • chunk_size
    • 출력 버퍼 크기입니다.
    • 기본값은 4096 입니다.
  • disable_literal_context_modeling
    • literal context modeling을 비활성화할 지 여부입니다. 디코딩 속도와 압축률 사이의 트레이드 오프입니다.

Zstd​

References
spec:
  configPatches:
    - patch:
        value:
          typed_config:
            compressor_library:
              name: text_optimized
              typed_config:
                "@type": type.googleapis.com/envoy.extensions.compression.zstd.compressor.v3.Zstd
  • compression_level
    • 컨텐츠 크기와 미리 정의된 압축 레벨에 따라 동적으로 압축 파라미터가 결정됩니다.
  • enable_checksum
    • 32 bits 체크섬을 사용할 지 여부입니다.
  • strategy
    • 압축 전략으로 클 수록 느려지는 대신 압축 결과가 좋아집니다.
    • DEFAULT = 0
    • FAST
    • DFAST
    • GREEDY
    • LAZY
    • LAZY2
    • BTLAZY2
    • BTOPT
    • BTULTRA
    • BTULTRA2
  • dictionary
    • 압축을 위한 dictionary 입니다.
  • chunk_size
    • 출력 버퍼 크기입니다.
    • 기본값은 4096 입니다.