gcsfuse CLI

이 페이지에서는 Cloud Storage FUSE와 상호 작용하는 데 사용되는 gcsfuse 명령줄 옵션에 대해 설명합니다.

개요

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

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

GLOBAL_OPTIONS는 마운트 설정 방법과 Cloud Storage FUSE의 작동 방법을 제어하는 옵션입니다.
BUCKET_NAME은 마운트할 버킷의 이름입니다. 예를 들면 my-mount-bucket입니다. 선택사항입니다. 동적 마운트를 수행하려면 이 명령어에서 버킷 이름을 제외합니다.
MOUNT_POINT는 버킷이 마운트되는 로컬 디렉터리입니다. 예를 들면 /path/to/mount/point입니다.

설명

gcsfuse CLI는 로컬 머신에서 Cloud Storage 버킷을 파일 시스템으로 마운트하기 위해 사용됩니다.

전체 옵션

전체 옵션	설명
`--anonymous-access BOOLEAN`	요청에 대한 인증을 사용 중지합니다. 인증을 지원하지 않는 커스텀 엔드포인트를 사용하는 경우 이 플래그를 설정해야 합니다. 공개 버킷에서 Cloud Storage FUSE를 사용하는 경우에도 이 플래그를 설정해야 합니다. 기본값은 `false`입니다.
`--app-name VALUE`	마운트의 애플리케이션 이름입니다.
`--billing-project VALUE`	마운트된 버킷에 액세스할 때 청구에 사용할 프로젝트를 지정합니다. 이 플래그는 요청자 지불을 사용 설정해서 버킷을 마운트할 때 종종 필수입니다. 기본 프로젝트는 없음입니다.
`--cache-dir VALUE`	파일 캐시 데이터를 저장할 디렉터리를 지정합니다. 참고: 파일 캐싱을 사용 설정하려면 `--cache-dir`을 사용하여 디렉터리를 지정하고 `--file-cache-max-size-mb` 플래그를 사용하여 메비바이트(MiB) 단위로 특정 최대 파일 캐시 크기 한도를 나타내는 양의 정수를 지정하거나 `-1` 값을 사용하여 한도가 없음을 지정해야 합니다.
`--client-protocol VALUE`	Cloud Storage 백엔드와 통신하는 데 사용되는 프로토콜을 지정합니다. 값은 HTTP/1.1의 경우 `http1` 또는 HTTP/2의 경우 `http2`여야 합니다. 기본값은 `http1`입니다.
`--config-file VALUE`	Cloud Storage FUSE 동작을 구성하기 위해 사용하려는 구성 파일의 경로를 지정합니다. 예를 들면 `--config-file /etc/gcsfuse.yaml`입니다.
`--custom-endpoint VALUE`	데이터 가져오기를 위한 대체 커스텀 엔드포인트를 지정합니다. 커스텀 엔드포인트는 Cloud Storage JSON 엔드포인트 `https://storage.googleapis.com/storage/v1`과 같이 상응하는 리소스 및 작업을 지원해야 합니다. 지정한 커스텀 엔드포인트에서 인증이 지원되지 않는 경우 `--anonymous-access` 플래그를 `true`로 설정하여 인증을 우회합니다.
`--debug_fuse BOOLEAN`	지원 중단됨. FUSE 관련 디버깅 출력을 사용 설정합니다. 이 옵션은 `--log-severity` 옵션으로 대체되었습니다. 디버깅 출력을 사용 설정하려면 `--log-severity` 옵션을 `trace`로 설정합니다. 여기에는 trace, 디버그, 정보, 경고, 오류 로그가 포함됩니다.
`--debug_gcs BOOLEAN`	지원 중단됨. Cloud Storage 요청 및 타이밍 정보를 출력합니다. 이 옵션은 `--log-severity` 옵션으로 대체되었습니다. 디버깅 출력을 사용 설정하려면 `--log-severity` 옵션을 `trace`로 설정합니다. 여기에는 trace, 디버그, 정보, 경고, 오류 로그가 포함됩니다.
`--debug_invariants BOOLEAN`	내부 불변 위반이 감지되면 프로그램을 종료합니다. 기본값은 `false`입니다.
`--debug_mutex BOOLEAN`	뮤텍스가 너무 오랫동안 유지되면 디버그 메시지를 출력합니다. 이 옵션을 지정하면 로그의 심각도 수준이 `trace`로 자동 설정됩니다. 여기에는 trace, 디버그, 정보, 경고, 오류 로그가 포함됩니다. 기본값은 `false`입니다.
`--dir-mode VALUE`	디렉터리의 권한 비트(8진수)입니다. 최솟값은 `000`이고 최댓값은 `777`입니다. 기본값은 `755`입니다.
`--enable-nonexistent-type-cache BOOLEAN`	파일을 Cloud Storage에서 찾을 수 없으면 `NonexistentType` 유형으로 유형 캐시 항목을 만듭니다. Cloud Storage에 파일이 생성되지만 파일의 `NonexistentType` 항목이 캐시되면 `NonexistentType` 항목이 유형 캐시에서 삭제될 때까지 Cloud Storage FUSE가 파일을 요청할 수 없습니다. 기본값은 `false`입니다.
`--file-cache-cache-file-for-range-read BOOLEAN`	0이 아닌 오프셋에서 첫 번째 읽기가 완료될 때 전체 객체를 비동기식으로 다운로드하여 Cloud Storage FUSE 캐시 디렉터리에 저장해야 하는지 여부를 결정합니다. 임의 읽기나 부분 읽기를 여러 번 수행하려면 이 플래그를 `true`로 설정해야 합니다. 이 필드를 지정하지 않으면 기본값은 `false`입니다. 참고: 오프셋 `0`에서 시작하는 부분 읽기를 수행하는 경우 Cloud Storage FUSE는 전체 객체를 비동기식으로 다운로드하고 캐시합니다.
`--file-cache-download-chunk-size-mb VALUE`	객체를 파일 캐시로 다운로드할 때 각 goroutine이 Cloud Storage에 전송하는 각 읽기 요청의 크기를 MiB 단위로 지정합니다. 기본값은 `50`입니다.
`--file-cache-enable-parallel-downloads BOOLEAN`	파일 캐시 디렉터리를 프리페치 버퍼로 사용하여 여러 작업자가 대용량 파일을 동시에 다운로드하게 함으로써 대용량 파일의 읽기를 가속화합니다. 기본값은 `false`입니다. 동시 다운로드를 사용하려면 파일 캐싱을 사용 설정해야 합니다. 동시 다운로드에 관해 자세히 알아보고 지원 속성을 구성하려면 동시 다운로드를 사용하여 읽기 성능 개선을 참고하세요.
`--file-cache-max-parallel-downloads VALUE`	파일의 모든 다운로드 작업에서 특정 시점에 생성할 수 있는 최대 goroutine 수입니다. 기본값은 머신 CPU 코어 수의 두 배 또는 `16` 중 더 큰 값입니다. 한도가 없다고 지정하려면 값을 `-1`로 입력합니다.
`--file-mode VALUE`	파일의 권한 비트(8진수)를 지정합니다. 최솟값은 `000`이고 최댓값은 `777`입니다. 기본값은 `644`입니다.
`--foreground BOOLEAN`	포그라운드에서 `gcsfuse` 명령어를 실행합니다. 기본값은 `false`입니다.
`--gid VALUE`	모든 노드의 그룹 식별자(GID) 소유자를 지정합니다. 값은 정수여야 합니다. 기본값은 `-1`입니다.
`--help` 또는 `-h`	Cloud Storage FUSE에 대한 도움말을 표시합니다.
`version` 또는 `-v`	설치한 Cloud Storage FUSE 버전을 표시합니다.
`--http-client-timeout VALUE`	시간 초과되기 전 서버에서 응답을 받기 위해 Cloud Storage FUSE HTTP 클라이언트가 대기할 수 있는 기간을 지정합니다. 값은 시간이어야 합니다. 예를 들면 `1h10m10s`입니다. 기본값은 `0s`이고, 시간 제한이 없음을 나타냅니다.
`--ignore-interrupts VALUE`	`Control+C`에 의해 트리거된 SIGINT와 같은 시스템 중단 신호를 무시하도록 Cloud Storage FUSE에 지시합니다. 그러면 신호로 인해 진행 중인 작업이 종료되지 않습니다. 값은 `true` 또는 `false`입니다. 기본값은 `true`입니다.
`--implicit-dirs BOOLEAN`	폴더 및 관리 폴더를 암시적으로 포함합니다. 자세한 내용은 GitHub의 파일 및 디렉터리 문서를 참조하세요. 기본값은 `false`입니다.
`--kernel-list-cache-ttl-secs VALUE`	목록 캐시를 사용 설정하고 캐시된 목록 항목의 TTL(수명)을 초 단위로 정의합니다. 목록 캐시는 사용 가능한 메모리를 기반으로 커널에 의해 제어되는 페이지 캐시의 메모리에 보관됩니다. 기본값은 목록 캐싱을 사용 중지하는 `0`입니다. `--kernel-list-cache-ttl-secs` 플래그를 설정하려면 커널의 페이지 캐시에 디렉터리 목록 응답을 보관하기 위한 양의 정수 값을 초 단위로 지정합니다. 항목 만료를 우회하고 사용 가능한 경우 항상 캐시에서 목록 응답을 반환하려면 `-1` 값을 지정합니다.
`--key-file VALUE`	Cloud Storage에 대해 요청을 인증하기 위해 JSON 키 파일에 대한 절대 경로를 지정합니다. 기본적으로 Cloud Storage FUSE는 인증 요청을 위해 애플리케이션 기본 사용자 인증 정보를 사용합니다.
`--limit-bytes-per-sec VALUE`	Cloud Storage FUSE가 Clous Storage에서 데이터를 읽을 수 있도록 30초 동안 측정된 대역폭 한도를 지정합니다. 값은 부동 소수점 수여야 합니다. 기본 값은 한도 없음을 지정하는 `-1`입니다.
`--limit-ops-per-sec VALUE`	30초 동안 측정된, 초당 수행되는 작업 한도를 지정합니다. 값은 부동 소수점 수여야 합니다. 기본값은 한도 없음을 지정하는 `-1`입니다.
`--log-file VALUE`	Fluentd로 파싱될 수 있는 로그를 저장하기 위한 파일을 지정합니다. 제공되지 않는 경우 일반 텍스트 로그는 Cloud Storage FUSE가 포그라운드에서 실행될 때 `stdout`으로 또는 Cloud Storage FUSE가 백그라운드에서 실행될 때 `syslog`에 출력됩니다.
`--log-format VALUE`	로그 파일의 형식을 지정합니다. 값은 `text` 또는 `json`이어야 합니다. 기본값은 `json`입니다.
`--log-rotate-backup-file-count VALUE`	로그를 쓸 활성 파일을 제외하고 보관할 최대 순환 로그 파일 수입니다. 값이 `0`으로 설정되면 순환된 모든 로그 파일이 보관됩니다. 이 필드를 지정하지 않으면 기본값은 `10`입니다.
`--log-rotate-compress BOOLEAN`	순환된 로그 파일이 `gzip`을 사용하여 압축되는지 여부를 지정하는 불리언 값입니다. 이 플래그를 지정하지 않으면 기본값은 `true`입니다.
`--log-rotate-max-file-size-mb VALUE`	로그 파일이 순환되기 전에 도달할 수 있는 최대 크기(MB)입니다. 최솟값은 `1`입니다. 이 필드를 지정하지 않으면 기본값은 `512`입니다.
`--log-severity ENUM`	Cloud Storage FUSE에서 생성하려는 로그의 심각도이며 enum으로 표시됩니다. 심각도 수준은 심각도가 가장 낮은 순에서 높은 순으로 정렬됩니다. `trace` `debug` `info` `warning` `error` 심각도 수준을 지정하면 Cloud Storage FUSE는 심각도가 같거나 더 높은 로그를 생성합니다. 예를 들어 `warning`을 지정하면 Cloud Storage FUSE가 경고 및 오류에 대한 로그를 생성합니다. `off`를 지정하여 모든 로깅을 중지할 수도 있습니다. 명령어의 일부로 `--debug_mutex`를 지정하면 심각도 수준이 자동으로 `trace`로 설정되고 `log-severity`가 재정의됩니다. 이 필드를 지정하지 않으면 기본값은 `info`입니다.
`--max-conns-per-host VALUE`	서버당 허용되는 TCP 연결의 최대 개수를 지정합니다. `--client-protocol`이 `http1`로 설정된 경우에 적용됩니다. 값은 `0`에서 `2147483647` 사이여야 합니다. 기본값은 `0`이며 이는 머신 사양에서 설정한 제한사항을 제외하고 TCP 연결에 한도가 없음을 지정합니다.
`--max-idle-conns-per-host VALUE`	서버당 허용되는 유휴 연결의 최대 개수를 지정합니다. 값은 `0`에서 `2147483647` 사이여야 합니다. 기본값은 `100`입니다.
`--max-retry-sleep VALUE`	Cloud Storage FUSE가 지수 백오프를 사용하여 재시도 루프에서 절전 모드로 전환될 수 있는 최대 기간을 지정합니다. 값은 시간 값이어야 합니다. 예를 들어 `1h5m50s`(1시간 5분 50초) 또는 `60s`(60초)입니다. 백오프 기간이 지정된 최대 기간을 초과하면 지정된 최대 기간 동안 재시도가 계속됩니다. 기본값은 `30s`입니다.
`--metadata-cache-ttl-secs VALUE`	캐시된 메타데이터 항목의 TTL(수명)을 초 단위로 정의합니다. TTL 만료를 우회하고 사용 가능할 때마다 캐시에서 파일을 제공하려면 `-1` 값을 지정합니다. 최신 파일을 사용하려면 `0` 값을 지정합니다. 이 값을 사용하면 `Get` 메타데이터 호출을 실행하여 캐시에 있는 파일의 객체 생성이 Cloud Storage에 저장된 객체 생성과 일치하는지 확인합니다. 자세한 내용은 캐시 무효화 구성을 참고하세요. 이 필드를 지정하지 않으면 기본값은 `60`(60초)입니다.
`-o VALUE`	시스템별 추가 마운트 옵션을 지정합니다. `FUSE`에서 가장 일반적인 마운트 옵션(예: `rw`, `suid`, `ro`)은 Cloud Storage FUSE에서 지원되며 `-o` 플래그와 함께 전달할 수 있습니다. 자세한 내용은 Linux FUSE 문서를 참조하세요.
`--only-dir VALUE`	버킷 내에서 특정 디렉터리만 마운트합니다.
`--rename-dir-limit VALUE`	지정된 한도보다 하위 요소가 더 적게 포함된 디렉터리의 이름 바꾸기를 허용합니다. 값은 `0`에서 `2147483647` 사이여야 합니다. 기본 한도 값은 `0`입니다.
`--retry-multiplier VALUE`	연속 재시도 간의 지수 백오프 배수를 지정합니다. 값은 부동 소수점 수여야 합니다. 기본값은 `2`입니다.
`--reuse-token-from-url`	`--token-url`에서 가져온 토큰을 재사용할지 지정합니다. 기본값은 `true`입니다.
`--sequential-read-size-mb VALUE`	Cloud Storage에서 다운로드할 데이터의 청크 크기(MB)를 지정합니다. 값은 `1`에서 `1024` 사이여야 합니다. 기본값은 `200`입니다.
`--stackdriver-export-interval VALUE`	지정된 간격으로 stackdriver에 측정항목을 내보냅니다. 값은 시간이어야 합니다. 예를 들면 `1h10m10s`입니다. 기본값은 내보내기 없음을 지정하는 `0s`입니다.
`--stat-cache-capacity VALUE`	지원 중단됨. 통계 캐시가 보유할 수 있는 항목 수를 지정합니다. 이는 메모리 소비에 영향을 줍니다. 값은 정수여야 합니다. 기본값은 `4096`입니다. 이 플래그는 `--stat-cache-max-size-mb`로 대체되었습니다. 통계 캐시에서 사용할 수 있는 최대 크기를 메비바이트(MiB) 단위로 지정하려면 `--stat-cache-max-size-mb` 플래그를 사용합니다.
`--stat-cache-max-size-mb VALUE`	통계 캐시에서 사용할 수 있는 메비바이트(MiB) 단위의 최대 크기입니다. 통계 캐시는 항상 메모리에 온전히 보관됩니다. 워크로드에 파일이 최대 20,000개까지 포함된 경우 `32` 값을 지정합니다. 워크로드가 파일 20,000개를 초과하면 파일 6,000개가 추가될 때마다 크기가 10씩 증가합니다. 통계 캐시는 파일당 평균 1,500MiB를 사용합니다. 통계 캐시에서 필요한 만큼 메모리를 사용하도록 하려면 즉, 한도를 설정하지 않으려면 `-1` 값을 지정합니다. 통계 캐시를 사용 중지하려면 `0` 값을 지정합니다. 이 필드를 지정하지 않으면 기본값은 `32`입니다.
`--stat-cache-ttl VALUE`	지원 중단됨. `StatObject` 결과와 아이노드 속성을 캐시할 기간을 지정합니다. 기본값은 `60s`(60초)입니다. 이 플래그는 `--metadata-cache-ttl-secs`로 대체되었습니다. 캐시된 메타데이터 항목의 TTL(수명)을 초 단위로 지정하려면 `--metadata-cache-ttl-secs` 플래그를 사용합니다.
`--temp-dir VALUE`	Cloud Storage에 업로드되기 전 쓰기가 스테이징되는 임시 디렉터리의 경로를 지정합니다. 기본값은 시스템 기본값이며 대부분의 경우 `/tmp`일 수 있습니다.
`--token-url VALUE`	`--key-file`이 없으면 액세스 토큰을 가져오기 위한 URL을 지정합니다.
`--type-cache-ttl VALUE`	지원 중단됨. 이름 및 파일 또는 디렉터리 아이노드의 디렉터리 사이에 매핑을 캐시할 기간을 지정합니다. 이 옵션은 `--metadata-cache-ttl-secs` 옵션으로 대체되었습니다. 유형 캐시에 설정할 기간을 지정하려면 통계 및 유형 캐시 모두의 메타데이터 항목 TTL(수명)을 지정하는 `--metadata-cache-ttl-secs` 옵션을 사용합니다. `--metadata-cache-ttl-secs`의 기본값은 `60s`(60초)입니다.
`--type-cache-max-size-mb VALUE`	유형 캐시에서 사용할 수 있는 디렉터리당 최대 크기(MiB)입니다. 유형 캐시는 항상 메모리에 온전히 보관됩니다. 마운트하는 버킷의 단일 디렉터리 내에 있는 최대 파일 수에 파일이 20,000개 이하로 포함된 경우 `4` 값을 지정합니다. 마운트하는 단일 디렉터리 내의 최대 파일 수에 파일이 20,000개 넘게 있으면 파일 5,000개(파일당 평균 약 200 바이트)마다 값을 `1`씩 늘립니다. 유형 캐시에서 필요한 만큼 메모리를 사용하도록 하려면 즉, 한도를 지정하지 않으려면 `-1` 값을 지정합니다. 유형 캐시를 사용 중지하려면 `0` 값을 지정합니다. 이 필드를 지정하지 않으면 기본값은 `4`입니다.
`--uid VALUE`	모든 아이노드의 사용자 식별자(UID) 소유자를 지정합니다. 값은 정수여야 합니다. 기본 UID 값은 `-1`입니다.