Digitalocean
NAME:
singularity storage create s3 digitalocean - DigitalOcean Spaces
USAGE:
singularity storage create s3 digitalocean [command options] [arguments...]
DESCRIPTION:
--env-auth
런타임(환경 변수 또는 env vars이 없으면 EC2/ECS 메타 데이터에서)에서 AWS 자격 증명 가져오기.
access_key_id와 secret_access_key가 비어있을 때만 적용됩니다.
예:
| false | 다음 단계에서 AWS 자격 증명을 입력하세요.
| true | 환경(환경 변수 또는 IAM)에서 AWS 자격 증명 가져 오기.
--access-key-id
AWS Access Key ID.
익명 액세스 또는 런타임 자격 증명을 위해 비워 두세요.
--secret-access-key
AWS Secret Access Key (비밀번호).
익명 액세스 또는 런타임 자격 증명을 위해 비워 두세요.
--region
연결할 지역.
S3 클론을 사용하고 지역이 없을 경우 비워둡니다.
예:
| <unset> | 확실하지 않으면 사용하세요.
| | v4 서명과 빈 지역을 사용합니다.
| other-v2-signature | v4 서명이 작동하지 않는 경우에만 사용하십시오.
| | 예: pre Jewel/v10 CEPH.
--endpoint
S3 API의 엔드포인트.
S3 클론을 사용하는 경우 필요합니다.
예:
| syd1.digitaloceanspaces.com | DigitalOcean Spaces 시드니 1
| sfo3.digitaloceanspaces.com | DigitalOcean Spaces 샌프란시스코 3
| fra1.digitaloceanspaces.com | DigitalOcean Spaces 프랑크푸르트 1
| nyc3.digitaloceanspaces.com | DigitalOcean Spaces 뉴욕 3
| ams3.digitaloceanspaces.com | DigitalOcean Spaces 암스테르담 3
| sgp1.digitaloceanspaces.com | DigitalOcean Spaces 싱가포르 1
--location-constraint
위치 구속 조건 - 지역과 일치해야 함.
확실하지 않으면 비워두세요. 버킷을 만들 때만 사용됩니다.
--acl
버킷을 만들거나 객체를 저장하거나 복사할 때 사용되는 캐닝 ACL.
이 ACL은 객체를 생성하는 데 사용되며, bucket_acl이 설정되지 않으면 버킷을 생성하는 데도 사용됩니다.
자세한 내용은 [AmazonS3 사용자 지정 ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) 문서를 확인하세요.
확실하지 않으면 ACL이 빈 문자열인 경우 X-Amz-Acl: 헤더가 추가되지 않으며 기본값(비공개)이 사용됩니다.
--bucket-acl
버킷을 만들 때 사용되는 캐닝 ACL.
자세한 내용은 [AmazonS3 사용자 지정 ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) 문서를 확인하세요.
이 ACL은 버킷을 생성할 때만 적용됩니다. 설정되지 않은 경우 "acl"을 대신 사용합니다.
"acl" 및 "bucket_acl"이 빈 문자열인 경우 X-Amz-Acl: 헤더가 추가되지 않으며 기본값(비공개)이 사용됩니다.
예:
| private | 소유자에게 FULL_CONTROL이 부여됩니다.
| | 다른 사람에게 액세스 권한이 없습니다(기본값).
| public-read | 소유자에게 FULL_CONTROL이 부여됩니다.
| | AllUsers 그룹에게 읽기 액세스가 부여됩니다.
| public-read-write | 소유자에게 FULL_CONTROL이 부여됩니다.
| | AllUsers 그룹에게 읽기 및 쓰기 액세스가 부여됩니다.
| | 버킷에 대해 이를 허용하는 것은 권장되지 않습니다.
| authenticated-read | 소유자에게 FULL_CONTROL이 부여됩니다.
| | AuthenticatedUsers 그룹에게 읽기 액세스가 부여됩니다.
--upload-cutoff
청크 업로드로 전환하는 임계 값.
이보다 큰 파일은 chunk_size의 청크로 업로드됩니다.
최소값은 0이고 최대값은 5 GiB입니다.
--chunk-size
업로드에 사용할 청크 크기.
upload_cutoff보다 큰 파일 또는 크기를 알 수없는 파일(예: "rclone rcat"으로 업로드되는 파일이나 "rclone mount"로 업로드되는 파일 또는 Google Photos 또는 Google 문서)을 업로드 할 때
이 청크 크기를 사용하여 멀티파트 업로드됩니다.
참고로 "--s3-upload-concurrency"는 이 크기의 청크를 전송마다 메모리에 버퍼링합니다.
고속 링크에서 큰 파일을 전송하고 충분한 메모리가 있다면 이를 더 크게하면 전송 속도가 향상됩니다.
rclone은 10,000개 이하의 청크 제한을 유지하기 위해 알려진 크기의 대형 파일을 업로드 할 때 자동으로 청크 크기를 증가시킵니다.
크기를 알 수없는 파일은 구성된 chunk_size로 업로드됩니다. 기본 청크 크기가 5 MiB이고 최대 10,000 개의 청크가있을 수 있으므로 기본적으로 스트리밍 업로드 할 수있는 파일의 최대 크기는 48 GiB입니다.
더 큰 파일을 스트리밍 업로드하려면 chunk_size를 늘려야합니다.
청크 크기를 늘리면 "-P" 플래그로 표시되는 진행 상태의 정확도가 낮아집니다. rclone은 AWS SDK에 의해 버퍼링 될 때 청크가 전송된 것으로 처리하고 있지만 아직 업로드 중일 수 있습니다.
더 큰 청크 크기는 더 큰 AWS SDK 버퍼와 진행률 보고서를 진실과 멀리 벗어나게합니다.
--max-upload-parts
멀티파트 업로드에서 사용할 최대 부분 수.
이 옵션은 멀티파트 업로드를 수행 할 때 사용할 멀티파트 청크의 최대 수를 정의합니다.
만약 서비스가 10,000개 이하의 청크를 지원하지 않는 경우 유용 할 수 있습니다.
rclone은 10,000 개 이하의 청크 수를 제한하기 위해 알려진 크기의 대형 파일을 업로드 할 때 자동으로 청크 크기를 증가시킵니다.
--copy-cutoff
멀티파트로 복사하는 임계 값.
서버간에 복사해야하는 이 크기보다 큰 파일은 이 크기의 청크로 복사됩니다.
최소값은 0이고 최대값은 5 GiB입니다.
--disable-checksum
객체 메타데이터에 MD5 체크섬을 저장하지 않습니다.
일반적으로 rclone은 업로드하기 전에 입력의 MD5 체크섬을 계산하여 객체 메타데이터에 추가하기 때문에 대형 파일을 업로드하기 시작할 때 장기간 대기 될 수 있습니다.
--shared-credentials-file
공유 자격 증명 파일의 경로.
env_auth = true 경우 rclone은 공유 자격 증명 파일을 사용할 수 있습니다.
이 변수가 비어 있으면 rclone은 "AWS_SHARED_CREDENTIALS_FILE" 환경 변수를 찾습니다. 환경 값이 비어 있으면 기본값으로 현재 사용자의 홈 디렉토리를 사용합니다.
Linux/OSX: "$HOME/.aws/credentials"
Windows: "%USERPROFILE%\.aws\credentials"
--profile
공유 자격 증명 파일에서 사용 할 프로파일.
env_auth = true일 때 rclone은 공유 자격 증명 파일을 사용할 수 있습니다. 이 변수는 파일에서 사용 할 프로필을 제어합니다.
비어 있으면 "AWS_PROFILE" 또는 환경 변수 "default"를 기본값으로 사용합니다.
--session-token
AWS 세션 토큰.
--upload-concurrency
멀티파트 업로드의 동시성.
동일한 파일의 청크 몇 개를 동시에 업로드합니다.
고속링크에서 고속 링크를 통해 전혀 대역폭을 활용하지 못하는 소량의 대형 파일을 업로드하는 경우 이를 늘리는 것이 전송 속도를 높이는 데 도움이 될 수 있습니다.
--force-path-style
경우에 따라 경로 스타일 액세스(true) 또는 가상 호스팅 스타일 액세스(false)를 사용합니다.
이 값이 true(기본값)인 경우 rclone은 경로 스타일 액세스를 사용하고 false인 경우 rclone은 가상 경로 스타일을 사용합니다. 사용 방법에 대한 자세한 내용은 [AWS S3 문서](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro)를 참조하세요.
일부 공급 업체(AWS, Aliyun OSS, Netease COS 또는 Tencent COS 등)는이 값을 false로 설정해야합니다. rclone은 제공자 설정에 따라이 작업을 자동으로 수행합니다.
--v2-auth
v2 인증을 사용함(true) 또는 v4 인증을 사용함(false).
이 값이 false(기본값)인 경우 rclone은 v4 인증을 사용합니다. 설정된 경우 rclone은 v2 인증을 사용합니다.
v4 서명이 작동하지 않으면 (예: v10 Jewel 이전의 CEPH)만 사용하세요.
--list-chunk
목록 청크의 크기 (각 ListObject S3 요청에 대한 응답 목록).
이 옵션은 AWS S3 사양의 "MaxKeys", "max-items" 또는 "page-size"로 알려진 것과 같습니다.
대부분의 서비스는 요청보다 많이 요청하더라도 응답 목록을 1000개로 자릅니다.
AWS S3에서는 이것이 전체 최대값이며 변경할 수 없습니다. [AWS S3](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) 참조.
Ceph에서는 "rgw list buckets max chunk" 옵션으로 증가 할 수 있습니다.
--list-version
사용할 ListObjects 버전: 1, 2 또는 자동(0).
S3가 처음 출시 될 때 버킷의 개체를 열거하기위한 ListObjects 호출 만 제공했습니다.
그러나 2016 년 5 월에는 ListObjectsV2 호출이 도입되었습니다. 이것은 매우 높은 성능을 제공하며 가능한 경우 사용해야합니다.
기본값 0으로 설정되어 있으면 rclone은 제공자 설정에 따라 호출할 목록 개체 방법을 추측합니다. 있을 경우 수동으로 설정할 수 있습니다.
--list-url-encode
목록을 URL 인코딩 할지 여부 : true/false/unset
일부 프로바이더는 목록을 URL 인코딩하도록 지원하며,이를 사용할 수있는 경우 파일 이름에 제어 문자를 사용할 때 더 안정적입니다.
unset (기본값)으로 설정되어있는 경우 rclone은 프로바이더 설정에 따라 적용할 내용을 선택하지만 여기에서 rclone의 선택 사항을 재정의 할 수 있습니다.
--no-check-bucket
버킷의 존재를 확인하거나 생성하지 않으려면 설정하세요.
버킷이 이미 존재하는 것을 알고있는 경우 rclone이 수행하는 트랜잭션 수를 최소화하려고 할 때 유용 할 수 있습니다.
또한 사용자가 버킷 생성 권한이없는 경우 필요할 수 있습니다. v1.52.0 이전에는 버그 때문에 이렇게 설정된 경우 정상적으로 전달되지 않았습니다.
--no-head
업로드 된 객체의 무결성을 확인하기 위해 HEAD하지 않습니다.
rclone이 PUT 호출 후 200 OK 메시지를 받으면 올바르게 업로드되었다고 가정합니다.
특히 다음을 가정합니다.
- 메타 데이터(수정 시간, 저장 클래스 및 컨텐츠 유형 포함)은 업로드 된 것과 동일합니다.
- 크기는 업로드 된 것과 동일합니다.
단일 부분 PUT의 응답에서 다음 항목을 읽습니다.
- MD5SUM
- 업로드된 날짜
멀티파트 업로드의 경우 이러한 항목이 읽히지 않습니다.
길이를 알 수없는 소스 개체를 업로드하는 경우 rclone은 HEAD 요청을 수행합니다.
이 플래그를 설정하면 잘못된 크기와 같은 감지되지 않은 업로드 실패의 가능성이 높아지므로 정상적인 동작에 권장되지 않습니다. 실제로 감지되지 않은 업로드 실패 가능성은 매우 작습니다.
--no-head-object
객체를 가져오기 전에 HEAD를 사용하지 않습니다.
--encoding
백엔드에 대한 인코딩.
자세한 내용은 [개요의 인코딩 섹션](/overview/#encoding)을 참조하세요.
--memory-pool-flush-time
내부 메모리 버퍼 풀이 플러시될 때까지의 시간 간격.
추가 버퍼를 필요로하는 업로드 (예 : 멀티파트)에서는 메모리 풀을 사용하여 할당 될 수 있습니다.
이 옵션은 사용되지 않은 버퍼가 풀에서 제거 될 때마다 제어합니다.
--memory-pool-use-mmap
내부 메모리 풀에서 mmap 버퍼를 사용할지 여부.
--disable-http2
S3 백엔드에서 http2 사용을 비활성화합니다.
현재 s3 (특히 minio) 백엔드와 HTTP/2에 관련하여 해결되지 않은 문제가 있습니다. S3 백엔드의 기본값은 HTTP/2입니다만 여기에서 비활성화할 수 있습니다. 문제가 해결되면이 플래그가 제거됩니다.
참조 : https://github.com/rclone/rclone/issues/4673, https://github.com/rclone/rclone/issues/3631
--download-url
다운로드를위한 사용자 지정 엔드포인트.
대개 AWS S3는 CloudFront CDN URL로 설정되며 CloudFront 네트워크를 통해 데이터를 다운로드하는 경우 더 저렴한 이중 출구를 제공합니다.
--use-multipart-etag
확인을 위해 멀티파트 업로드에 ETag를 사용할지 여부
이 값을 true, false 또는 설정되지 않은대로 설정하면 기본값이 제공자에 의해 사용됩니다.
--use-presigned-request
단일 부분 업로드에 서명 된 요청 또는 PutObject를 사용할지 여부
이 값이 false이면 rclone은 객체를 업로드하기 위해 AWS SDK에서 PutObject를 사용합니다.
rclone의 버전 <1.59은 단일 부분 객체를 업로드하기 위해 서명 된 요청을 사용하며이 플래그를 true로 설정하면 해당 기능이 다시 활성화됩니다. 이는 특수한 경우 또는 테스트에만 필요합니다.
--versions
디렉토리 목록에 이전 버전 포함.
--version-at
지정된 시간에 파일 버전 표시.
매개 변수는 날짜, "2006-01-02", 시간 "2006-01-02 15:04:05" 또는 그 때의 기간, 예를 들어 "100d" 또는 "1h" 일 수있습니다.
이를 사용하면 파일 쓰기 작업이 허용되지 않으므로 파일을 업로드하거나 삭제 할 수 없습니다.
유효한 형식은 [시간 옵션 문서](/docs/#time-option)를 참조하세요.
--decompress
gzip으로 인코딩된 객체를 해제합니다.
S3로 "Content-Encoding: gzip" 업로드 한 객체도 압축된 개체로 다운로드됩니다.
이 플래그가 설정되면 rclone은 이러한 파일을 도착시 "Content-Encoding: gzip"로 해제합니다. 이는 rclone이 크기와 해시를 확인하지 않지만 파일 내용은 해제됩니다.
--might-gzip
백엔드가 개체를 gzip으로 압축 할 수 있는 경우 설정하세요.
일반적으로 제공 업체는 개체가 다운로드 될 때 변경하지 않습니다. "Content-Encoding: gzip"로 업로드 된 개체가 아니면 다운로드시 설정되지 않습니다.
그러나 일부 공급 업체는 (Cloudflare)와 같이 "Content-Encoding: gzip로 업로드되지 않았더라도 개체를 gzip으로 압축 할 수 있습니다.
이경우에는
ERROR corrupted on transfer: sizes differ NNN vs MMM
와 같은 오류를 수신합니다
이 플래그를 설정하고 rclone이 Content-Encoding을 설정하고 청크 전송 인코딩을 gzip으로 수신하는 개체를 다운로드하면 rclone은 개체를 동적으로 해제합니다.
unset (기본값)로 설정되어 있다면 rclone은 프로바이더 설정에 따라 적용할 내용을 선택하지만 여기에서 rclone의 선택을 재정의 할 수 있습니다.
--no-system-metadata
시스템 메타 데이터의 설정 및 읽기를 억제합니다.
OPTIONS:
--access-key-id value AWS Access Key ID. [$ACCESS_KEY_ID]
--acl value 버킷을 만들거나 객체를 저장하거나 복사할 때 사용되는 캐닝 ACL. [$ACL]
--endpoint value S3 API의 엔드포인트. [$ENDPOINT]
--env-auth 런타임(환경 변수 또는 env vars이 없으면 EC2/ECS 메타 데이터에서)에서 AWS 자격 증명 가져오기. (default: false) [$ENV_AUTH]
--help, -h 도움말 표시
--location-constraint value 위치 구속 조건 - 지역과 일치해야 함. [$LOCATION_CONSTRAINT]
--region value 연결할 지역. [$REGION]
--secret-access-key value AWS Secret Access Key (비밀번호). [$SECRET_ACCESS_KEY]
Advanced
--bucket-acl value 버킷을 만들 때 사용되는 캐닝 ACL. [$BUCKET_ACL]
--chunk-size value 업로드에 사용할 청크 크기. (default: "5Mi") [$CHUNK_SIZE]
--copy-cutoff value 멀티파트로 복사하는 임계 값. (default: "4.656Gi") [$COPY_CUTOFF]
--decompress gzip으로 인코딩된 객체를 해제합니다. (default: false) [$DECOMPRESS]
--disable-checksum 객체 메타데이터에 MD5 체크섬을 저장하지 않습니다. (default: false) [$DISABLE_CHECKSUM]
--disable-http2 S3 백엔드에서 http2 사용을 비활성화합니다. (default: false) [$DISABLE_HTTP2]
--download-url value 다운로드를위한 사용자 지정 엔드포인트. [$DOWNLOAD_URL]
--encoding value 백엔드에 대한 인코딩. (default: "Slash,InvalidUtf8,Dot") [$ENCODING]
--force-path-style 경우에 따라 경로 스타일 액세스(true) 또는 가상 호스팅 스타일 액세스(false)를 사용합니다. (default: true) [$FORCE_PATH_STYLE]
--list-chunk value 목록 청크의 크기 (각 ListObject S3 요청에 대한 응답 목록). (default: 1000) [$LIST_CHUNK]
--list-url-encode value 목록을 URL 인코딩 할지 여부 : true/false/unset (default: "unset") [$LIST_URL_ENCODE]
--list-version value 사용할 ListObjects 버전: 1, 2 또는 자동(0). (default: 0) [$LIST_VERSION]
--max-upload-parts value 멀티파트 업로드에서 사용할 최대 부분 수. (default: 10000) [$MAX_UPLOAD_PARTS]
--memory-pool-flush-time value 내부 메모리 버퍼 풀이 플러시될 때까지의 시간 간격. (default: "1m0s") [$MEMORY_POOL_FLUSH_TIME]
--memory-pool-use-mmap 내부 메모리 풀에서 mmap 버퍼를 사용할지 여부. (default: false) [$MEMORY_POOL_USE_MMAP]
--might-gzip value 백엔드가 개체를 gzip으로 압축 할 수 있는 경우 설정하세요. (default: "unset") [$MIGHT_GZIP]
--no-check-bucket 버킷의 존재를 확인하거나 생성하지 않으려면 설정하세요. (default: false) [$NO_CHECK_BUCKET]
--no-head 업로드 된 객체의 무결성을 확인하기 위해 HEAD하지 않습니다. (default: false) [$NO_HEAD]
--no-head-object 객체를 가져오기 전에 HEAD를 사용하지 않습니다. (default: false) [$NO_HEAD_OBJECT]
--no-system-metadata 시스템 메타 데이터의 설정 및 읽기를 억제합니다. (default: false) [$NO_SYSTEM_METADATA]
--profile value 공유 자격 증명 파일에서 사용 할 프로파일. [$PROFILE]
--session-token value AWS 세션 토큰. [$SESSION_TOKEN]
--shared-credentials-file value 공유 자격 증명 파일의 경로. [$SHARED_CREDENTIALS_FILE]
--upload-concurrency value 멀티파트 업로드의 동시성. (default: 4) [$UPLOAD_CONCURRENCY]
--upload-cutoff value 청크 업로드로 전환하는 임계 값. (default: "200Mi") [$UPLOAD_CUTOFF]
--use-multipart-etag value 확인을 위해 멀티파트 업로드에 ETag를 사용할지 여부 (default: "unset") [$USE_MULTIPART_ETAG]
--use-presigned-request 단일 부분 업로드에 서명 된 요청 또는 PutObject를 사용할지 여부 (default: false) [$USE_PRESIGNED_REQUEST]
--v2-auth v2 인증을 사용함(true). (default: false) [$V2_AUTH]
--version-at value 지정된 시간에 파일 버전 표시. (default: "off") [$VERSION_AT]
--versions 디렉토리 목록에 이전 버전 포함. (default: false) [$VERSIONS]
General
--name value 스토리지의 이름 (기본값: 자동 생성)
--path value 스토리지의 경로
Last updated