빠른 시작: gsutil 도구 사용

이 페이지는 gsutil 명령줄 도구를 사용하여 Cloud Storage에서 기본적인 작업을 수행하는 방법을 보여줍니다.

Cloud Storage에서 발생하는 비용은 사용한 리소스에 따라 결정됩니다. 이 빠른 시작은 일반적으로 $0.01 USD 미만의 Cloud Storage 리소스를 사용합니다.

시작하기 전에

  1. Google 계정에 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. GCP Console에서 리소스 관리 페이지로 이동하고 프로젝트를 만듭니다.

    리소스 관리 페이지로 이동

  3. Google Cloud Platform 프로젝트에 결제가 사용 설정되어 있는지 확인하세요.

    결제 사용 설정 방법 알아보기

  4. Cloud SDK를 설치합니다.

    메시지가 나타나면 위에서 만든 프로젝트를 선택합니다.

  5. Python 2.7을 설치합니다.

    Windows를 사용 중이고 Cloud SDK 설치 시 관련 확인란을 선택한 경우, 이 작업은 자동으로 수행됩니다.

버킷 만들기

버킷은 Cloud Storage에서 데이터를 보관하는 기본 컨테이너입니다.

버킷을 만드는 방법은 다음과 같습니다.

  1. 터미널 창을 엽니다.
  2. gsutil mb 명령어와 고유한 이름을 사용하여 버킷을 만듭니다.
    gsutil mb -l us-east1 gs://my-awesome-bucket/
    

    여기서는 'my-awesome-bucket'이라는 이름의 버킷을 사용합니다. 전역적으로 고유한 버킷 이름을 직접 선택해야 합니다.

    성공하면 다음과 같은 결과가 반환됩니다.

    Creating gs://my-awesome-bucket/...
    
  3. 이제 원하는 항목을 저장할 수 있는 버킷이 생성되었습니다.

버킷에 객체 업로드

고양이 이미지

  1. 위의 이미지를 마우스 오른쪽 버튼으로 클릭하고 바탕화면과 같은 컴퓨터의 특정 위치에 저장합니다.

  2. gsutil cp 명령어를 사용하여 파일을 저장한 위치의 이미지를 생성된 버킷으로 복사합니다.

    gsutil cp Desktop/kitten.png gs://my-awesome-bucket

    성공하면 다음과 같은 결과가 반환됩니다.

    Copying file://Desktop/kitten.png [Content-Type=image/png]...
    Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
    Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

    이제 객체가 버킷에 저장되었습니다.

버킷에서 객체 다운로드

  1. gsutil cp 명령어를 사용하여 버킷에 저장한 이미지를 바탕화면과 같은 컴퓨터의 특정 위치로 다운로드합니다.

    gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

    성공하면 다음과 같은 결과가 반환됩니다.

    Copying gs://my-awesome-bucket/kitten.png...
    Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
    Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

    이제 버킷에서 파일을 다운로드했습니다.

버킷의 폴더에 객체 복사

  1. gsutil cp 명령어를 사용하여 폴더를 만들고 여기에 이미지를 복사합니다.

    gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

    성공하면 명령어는 다음을 반환합니다.

    Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
    Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

    이제 버킷의 새 폴더에 객체를 복사했습니다.

버킷 또는 폴더 콘텐츠 나열

  1. gsutil ls 명령어를 사용하여 버킷 최상위 수준에서 콘텐츠를 나열합니다.

    gsutil ls gs://my-awesome-bucket

    성공하면 명령어가 다음과 유사한 메시지를 반환합니다.

    gs://my-awesome-bucket/kitten.png
    gs://my-awesome-bucket/just-a-folder/

    이제 버킷의 최상위 수준에서 콘텐츠를 확인할 수 있습니다.

객체 세부정보 나열

  1. -l 플래그와 함께 gsutil ls 명령어를 사용하여 객체 세부정보를 가져옵니다.

    gsutil ls -l gs://my-awesome-bucket/kitten.png

    성공하면 명령어가 다음과 유사한 메시지를 반환합니다.

    2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
    TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

    이제 객체의 크기와 생성 날짜에 대한 정보를 확인할 수 있습니다.

객체에 공개적으로 액세스하기

  1. gsutil acl ch 명령어를 사용하여 모든 사용자에게 버킷에 저장된 객체 읽기 권한을 부여합니다.

    gsutil acl ch -u AllUsers:R gs://my-awesome-bucket/kitten.png

    성공하면 다음과 같은 결과가 반환됩니다.

    Updated ACL on gs://my-awesome-bucket/kitten.png

    이제 누구나 객체에 접근할 수 있습니다.

  2. 이 권한을 삭제하려면 다음 명령어를 사용합니다.

    gsutil acl ch -d AllUsers gs://my-awesome-bucket/kitten.png

    성공하면 다음과 같은 결과가 반환됩니다.

    Updated ACL on gs://my-awesome-bucket/kitten.png

    이 객체 공개 액세스 권한을 삭제했습니다.

특정 사용자에게 버킷 액세스 권한 부여

  1. gsutil iam ch 명령어를 사용하여 특정 이메일 주소에 버킷의 객체 읽기 및 쓰기 권한을 부여합니다.

    gsutil iam ch user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    오류가 반환되지 않으면 명령어가 성공한 것입니다.

    이제 다른 사람이 버킷 내용을 확인하고 여기에 삽입할 수 있습니다.

  2. 이 권한을 삭제하려면 다음 명령어를 사용합니다.

    gsutil iam ch -d user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    오류가 반환되지 않으면 명령어가 성공한 것입니다.

    이 버킷에 대한 사용자 액세스 권한을 삭제했습니다.

객체 삭제

  1. gsutil rm 명령어를 사용하여 객체를 삭제합니다.

    gsutil rm gs://my-awesome-bucket/kitten.png

    성공하면 다음과 같은 결과가 반환됩니다.

    Removing gs://my-awesome-bucket/kitten.png...

    이 객체 복사본은 더 이상 Cloud Storage에 저장되지 않습니다(just-a-folder/ 폴더에서 만든 복사본은 계속 유지됨).

삭제

이 빠른 시작에서 사용한 리소스 비용이 GCP 계정에 청구되지 않도록 다음을 수행합니다.

  1. 터미널 창을 엽니다(아직 열려 있지 않은 경우).
  2. -r 플래그와 함께 gsutil rm command를 사용하여 버킷과 해당 콘텐츠를 삭제합니다.

    gsutil rm -r gs://my-awesome-bucket

    성공하면 명령어가 다음과 유사한 메시지를 반환합니다.

    Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
    Removing gs://my-awesome-bucket/...

    버킷과 콘텐츠가 삭제되었습니다.

다음 단계

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.