Cloud Storage FUSE 구성 파일

이 페이지에서는 Cloud Storage FUSE 구성 파일을 사용하여 Cloud Storage FUSE의 동작을 영구적으로 구성하는 방법을 설명합니다.

구성 파일은 다음 형식과 필드를 사용하는 YAML 파일입니다. 명령줄 옵션을 사용하여 일부 필드를 지정할 수도 있습니다.

write:
  create-empty-file: CREATE_EMPTY_FILE
logging:
  file-path: "FILE_PATH"
  format: FORMAT
  severity: SEVERITY
  log-rotate:
    max-file-size-mb: MAX_FILE_SIZE
    backup-file-count: BACKUP_FILE_COUNT
    compress: COMPRESSION
file-cache:
  max-size-mb: MAX_FILE_CACHE_SIZE
  cache-file-for-range-read: CACHE_FULL_FILE
metadata-cache:
  stat-cache-max-size-mb: MAX_STAT_CACHE_SIZE
  ttl-secs:TTL_SECONDS
  type-cache-max-size-mb: MAX_TYPE_CACHE_SIZE
cache-dir: PATH_TO_DIRECTORY

각 항목의 의미는 다음과 같습니다.

  • CREATE_EMPTY_FILE은 마운트된 버킷의 새 파일에 쓰기 시작할 때 Cloud Storage에서 0바이트 파일을 만들지 여부를 지정하는 불리언 값입니다. 기본값은 false입니다.

  • FILE_PATH는 로그가 기록되는 로그 파일의 경로이며 문자열로 지정됩니다. 예를 들면 /var/log입니다.

  • FORMAT은 로그가 생성되는 형식이며 enum으로 표시됩니다. 값은 text 또는 json입니다. 기본값은 json입니다.

  • SEVERITY는 Cloud Storage FUSE에서 생성하려는 로그의 심각도이며 열거형으로 표시됩니다. 심각도 수준은 심각도가 가장 낮은 순에서 높은 순으로 정렬됩니다.

    1. trace
    2. debug
    3. info(기본값)
    4. warning
    5. error

    심각도 수준을 지정하면 Cloud Storage FUSE는 심각도가 같거나 더 높은 로그를 생성합니다. 예를 들어 warning을 지정하면 Cloud Storage FUSE가 주의 및 오류에 대한 로그를 생성합니다. off를 지정하여 모든 로깅을 중지할 수도 있습니다.

    다음 세 가지 옵션 중 하나라도 명령어의 일부로 지정되면 심각도 수준이 trace로 자동 설정됩니다.

    • --debug_fuse
    • --debug_gcs
    • --debug_mutex
  • MAX_FILE_SIZE는 로그 파일이 순환되기 전에 도달할 수 있는 최대 크기(MB)입니다. 기본값은 512입니다. 최솟값은 1입니다.

  • BACKUP_FILE_COUNT 로그를 쓸 활성 파일을 제외하고 보관할 최대 순환 로그 파일 수입니다. 기본값은 10입니다. 값이 0으로 설정되면 순환된 모든 로그 파일이 보관됩니다.

  • COMPRESSION는 순환된 로그 파일이 gzip을 통해 압축되는지 여부를 지정하는 불리언 값입니다. 기본값은 true입니다.

  • MAX_FILE_CACHE_SIZE는 파일 캐시에서 사용할 수 있는 최대 크기(MiB)입니다. 있으면 max-size-mb는 Cloud Storage FUSE에서 파일 캐싱을 사용 설정하며 Cloud Storage FUSE 캐시가 마운트된 디렉터리 내에서 사용할 수 있는 총 용량을 제한하려는 경우에 유용합니다.

    • cache-dir에 지정한 디렉터리에서 캐시의 사용 가능한 전체 용량을 사용하려면 기본값 -1을 사용합니다.

    • 파일 캐시를 사용 중지하려면 0 값을 사용하세요.

  • CACHE_FULL_FILE은 0이 아닌 오프셋에서 첫 번째 읽기를 수행할 때 전체 객체를 비동기식으로 다운로드하여 Cloud Storage FUSE 캐시 디렉터리에 저장해야 하는지 여부를 결정하는 불리언입니다. 임의 읽기나 부분 읽기를 여러 번 수행하려면 true로 설정해야 합니다. 기본값은 false입니다.

  • MAX_STAT_CACHE_SIZE는 통계 캐시에서 사용할 수 있는 최대 크기(MiB)입니다. 통계 캐시는 항상 메모리에 온전히 보관됩니다. 다음 사항을 고려하세요.

    • 워크로드에 파일이 최대 20,000개까지 포함된 경우 기본값 32를 사용하세요. 워크로드가 파일 20,000개를 초과하면 파일 6,000개가 추가될 때마다 크기가 10씩 증가합니다(파일당 평균은 약 1,500바이트).

    • 통계 캐시에서 필요한 만큼 메모리를 사용하게 하려면 -1 값을 사용합니다.

    • 통계 캐시를 중지하려면 0 값을 사용합니다.

  • TTL_SECONDS는 캐시된 메타데이터 항목의 TTL(수명)을 초 단위로 정의합니다. 기본값은60초입니다.

    • TTL 만료를 우회하고 사용 가능할 때마다 캐시에서 파일을 제공하려면 -1 값을 사용합니다.

    • 최신 파일을 읽었는지 확인하려면 0 값을 사용합니다. 0 값을 사용하면 메타데이터 가져오기 호출을 실행하여 캐시에 있는 파일의 객체 생성이 Cloud Storage에 저장된 객체 생성과 일치하는지 확인합니다. 자세한 내용은 ttl-secs 플래그 정보를 참조하세요.

  • MAX_TYPE_CACHE_SIZE는 유형 캐시에서 사용할 수 있는 디렉터리당 최대 크기(MiB)입니다. 유형 캐시는 항상 메모리에 온전히 보관됩니다. 다음 사항을 고려하세요.

    • 마운트하는 버킷의 단일 디렉터리 내에 있는 최대 파일 수에 파일이 20,000개 이하로 포함된 경우 기본값 4를 사용합니다. 마운트하는 단일 디렉터리 내의 최대 파일 수에 파일이 20,000개 넘게 있으면 파일 5,000개마다 type-cache-max-size-mb1씩 늘립니다(파일당 평균 약 200 바이트).

    • 유형 캐시에서 필요한 만큼 메모리를 사용하게 하려면 -1 값을 사용합니다.

    • 유형 캐시를 중지하려면 0 값을 사용합니다.

  • PATH_TO_DIRECTORY는 파일 캐시 데이터를 저장할 디렉터리를 지정합니다.