이 페이지에서는 Google Distributed Cloud (GDC) 에어 갭 어플라이언스 스토리지 버킷에 객체를 업로드하고 다운로드하는 방법을 보여줍니다.
시작하기 전에
프로젝트 네임스페이스는 관리 API 서버에서 버킷 리소스를 관리합니다. 버킷 및 객체로 작업하려면 프로젝트가 있어야 합니다.
또한 다음 작업을 수행하려면 적절한 버킷 권한이 있어야 합니다. 버킷 액세스 권한 부여를 참조하세요.
관리 API 서버에 대해 명령어를 실행하려면 로그인하고 생성합니다(아직 없는 경우) 관리 API 서버의 kubeconfig 파일을.
객체 이름 지정 가이드라인
객체 이름을 지정할 때는 다음 가이드라인을 사용하세요.
- 객체 이름을 지정할 때는 UTF-8 문자를 사용합니다.
- 개인 식별 정보 (PII)를 포함하지 마세요.
스토리지 버킷에 객체 업로드
객체를 업로드하려면 다음 명령어를 실행합니다.
gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
다음 명령어는 로컬 디렉터리의 모든 텍스트 파일을 버킷에 업로드합니다.
gdcloud storage cp *.txt s3://BUCKET
다음 명령어는 로컬 디렉터리의 여러 파일을 버킷에 업로드합니다.
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
버킷에 폴더를 업로드하려면 --recursive 옵션을 사용하여 전체 디렉터리 트리를 복사합니다. 다음 명령어는 디렉터리 트리 dir을 업로드합니다.
gdcloud storage cp dir s3://BUCKET --recursive
대용량 객체의 경우 멀티파트 업로드를 수행하거나 업로드할 파일이 15MB보다 큰 경우 멀티파트 업로드를 자동으로 사용합니다. 이 경우 파일은 여러 부분으로 분할되며 각 부분의 크기는 15MB입니다. 마지막 부분은 더 작습니다. 각 부분은 개별적으로 업로드되고 전송이 완료되면 대상에서 재구성됩니다.
한 부분의 업로드가 실패하면 이미 업로드된 다른 부분에 영향을 주지 않고 업로드를 다시 시작할 수 있습니다.
멀티파트 업로드와 관련된 두 가지 옵션이 있습니다.
--disable-multipart: 모든 파일의 멀티파트 업로드를 사용 중지합니다.--multipart-chunk-size-mb=SIZE: 멀티파트 업로드의 각 청크 크기를 설정합니다.
SIZE보다 큰 파일은 자동으로 다중 스레드 멀티파트로 업로드됩니다. 더 작은 파일은 기존 방식을 사용하여 업로드됩니다. SIZE는 메가바이트 단위입니다. 기본 청크 크기는 15MB입니다. 허용되는 최소 청크 크기는 5MB이고 최대 크기는 5GB입니다.
스토리지 버킷에서 객체 다운로드
버킷에서 객체를 가져오려면 다음을 수행합니다.
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
버킷의 모든 텍스트 파일을 현재 디렉터리로 다운로드하려면 다음을 수행합니다.
gdcloud storage cp s3://BUCKET/*.txt .
버킷의 텍스트 파일 abc.txt를 현재 디렉터리로 다운로드하려면 다음을 수행합니다.
gdcloud storage cp s3://BUCKET/abc.txt .
이전 버전의 파일을 다운로드하려면 먼저 파일의 모든 버전을 나열합니다.
gdcloud storage ls s3://BUCKET/abc.txt --all-versions
출력 예시:
s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3
그런 다음 버킷의 텍스트 파일 abc.txt의 특정 버전을 현재 디렉터리로 다운로드합니다.
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .