이 페이지에서는 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 버킷을 파일 시스템으로 마운트하기 위해 사용됩니다.
전체 옵션
전체 옵션 | 설명 |
---|---|
--app-name VALUE |
마운트의 애플리케이션 이름입니다. |
--billing-project VALUE |
마운트된 버킷에 액세스할 때 청구에 사용할 프로젝트를 지정합니다. 이 플래그는 요청자 지불을 사용 설정해서 버킷을 마운트할 때 종종 필수입니다. 기본 프로젝트는 없음입니다. |
--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 과 같이 상응하는 리소스 및 작업을 지원해야 합니다.
커스텀 엔드포인트를 지정하지 않으면 Cloud Storage FUSE가 전역 Cloud Storage JSON API 엔드포인트인 https://storage.googleapis.com/storage/v1 을 사용합니다.
커스텀 엔드포인트가 지정되면 엔드포인트에서 인증이 중지됩니다. |
--debug_fuse_errors |
제외된 경우 False로 평가되고 FUSE 오류가 콘솔(--foreground 가 사용된 경우) 또는 로그 파일(--log-file 이 사용된 경우)에 로깅되지 않도록 방지합니다. |
--debug_fuse |
FUSE 관련 디버깅 출력을 사용 설정합니다. 이 옵션을 지정하면 로그의 심각도 수준이 trace 로 자동 설정되며 trace 로그, 디버그 로그, 정보 로그, 경고 로그, 오류 로그가 포함됩니다. |
--debug_gcs |
Cloud Storage 요청 및 타이밍 정보를 출력합니다. 이 옵션을 지정하면 로그의 심각도 수준이 trace 로 자동 설정되며 trace 로그, 디버그 로그, 정보 로그, 경고 로그, 오류 로그가 포함됩니다. |
--debug-invariants |
내부 불변 조건이 위반될 때 패닉이 발생합니다. |
--debug_mutex |
뮤텍스가 너무 오랫동안 유지되면 디버그 메시지를 출력합니다. 이 옵션을 지정하면 로그의 심각도 수준이 trace 로 자동 설정되며 trace 로그, 디버그 로그, 정보 로그, 경고 로그, 오류 로그가 포함됩니다. |
--dir-mode VALUE |
디렉터리의 권한 비트(8진수)입니다. 기본값은 755 입니다. |
--enable-nonexistent-type-cache |
파일을 Cloud Storage에서 찾을 수 없으면 NonexistentType 유형으로 유형 캐시 항목을 만듭니다. Cloud Storage에 파일이 생성되지만 파일의 NonexistentType 항목이 캐시되면 NonexistentType 항목이 유형 캐시에서 삭제될 때까지 Cloud Storage FUSE가 파일을 요청할 수 없습니다. |
--experimental-enable-json-read |
읽기 작업에 Cloud Storage JSON API를 사용하도록 Cloud Storage FUSE를 지정합니다. 기본적으로 이 작업은 Cloud Storage XML API를 사용하여 수행됩니다. |
--experimental-opentelemetry-collector-address VALUE |
지정된 주소에서 OpenTelemetry Collector로 측정항목을 내보냅니다. 시험용입니다. |
--file-mode VALUE |
파일의 권한 비트(8진수)를 지정합니다. 기본값은 644 입니다. |
--foreground |
포그라운드에서 gcsfuse 명령어를 실행합니다. |
--gid VALUE |
모든 노드의 그룹 식별자(GID) 소유자를 지정합니다. 기본 GID 값은 -1 입니다. |
--help 또는 -h |
Cloud Storage FUSE에 대한 도움말을 표시합니다. |
--http-client-timeout VALUE |
시간 초과되기 전 서버에서 응답을 받기 위해 Cloud Storage FUSE HTTP 클라이언트가 대기할 수 있는 기간을 지정합니다. 기본값은 0s 이고, 시간 제한이 없음을 나타냅니다. |
--implicit-dirs |
자세한 내용은 GitHub의 파일 및 디렉터리 문서를 참조하세요. |
--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 입니다. |
--max-conns-per-host VALUE |
서버당 허용되는 TCP 연결의 최대 개수를 지정합니다. 이것은 --client-protocol 이 http1 로 설정된 경우에 적용됩니다. 기본값은 100 입니다. |
--max-idle-conns-per-host VALUE |
서버당 허용되는 유휴 연결의 최대 개수를 지정합니다. 기본값은 100 입니다. |
--max-retry-sleep VALUE |
Cloud Storage FUSE가 지수 백오프를 사용하여 재시도 루프에서 절전 모드로 전환될 수 있는 최대 기간을 지정합니다. 백오프 기간이 지정된 최대 기간을 초과하면 지정된 최대 기간 동안 재시도가 계속됩니다. 기본값은 30s (30초)입니다. |
-o VALUE |
시스템별 추가 마운트 옵션을 지정합니다. FUSE에서 가장 일반적인 마운트 옵션(예: |
-o ro |
버킷을 읽기 전용으로 마운트합니다. |
--only-dir VALUE |
버킷 내에서 특정 디렉터리만 마운트합니다. |
--rename-dir-limit VALUE |
지정된 한도보다 하위 요소가 더 적게 포함된 디렉터리의 이름 바꾸기를 허용합니다. 기본 한도 값은 0 입니다. |
--retry-multiplier VALUE |
두 번 연속 재시도 사이의 대기 시간을 지정합니다. |
--reuse-token-from-url |
포함된 경우 True로 평가되고 --token-url 에서 가져온 토큰을 사용하도록 지정합니다. 제외된 경우 False로 평가되고 --token-url 에서 가져온 토큰을 재사용하도록 지정합니다. |
--sequential-read-size-mb VALUE |
Cloud Storage에서 다운로드할 데이터의 청크 크기(MB)를 지정합니다. |
--stackdriver-export-interval VALUE |
지정된 간격으로 stackdriver에 측정항목을 내보냅니다. 기본값은 내보내기 없음을 지정하는 0s 입니다. |
--stat-cache-capacity VALUE |
지원 중단됨. 통계 캐시가 보유할 수 있는 항목 수를 지정합니다. 이는 메모리 소비에 영향을 줍니다. 기본값은 4096 입니다. |
--stat-cache-ttl VALUE |
지원 중단됨. StatObject 결과와 아이노드 속성을 캐시할 기간을 지정합니다. 기본값은 1m0s 입니다. |
--type-cache-ttl VALUE |
지원 중단됨. 이름 및 파일 또는 디렉터리 아이노드의 디렉터리 사이에 매핑을 캐시할 기간을 지정합니다. 기본값은 60s 입니다. |
--temp-dir value VALUE |
Cloud Storage에 업로드되기 전 쓰기가 스테이징되는 임시 디렉터리의 경로를 지정합니다. 기본값은 시스템 기본값이며 대부분의 경우 /tmp 일 수 있습니다. |
--token-url VALUE |
--key-file 이 없으면 액세스 토큰을 가져오기 위한 URL을 지정합니다. |
--uid VALUE |
모든 아이노드의 사용자 식별자(UID) 소유자를 지정합니다. 기본 UID 값은 -1 입니다. |
--version 또는 -v |
설치한 Cloud Storage FUSE 버전을 표시합니다. |