Cloud Storage 사용하기

자바 8 앱에서 런타임 중에 파일을 읽고 써야 하는 경우 또는 동영상, 이미지, 기타 정적 콘텐츠와 같은 파일을 제공해야 하는 경우 Cloud Storage 버킷을 사용하는 것이 좋습니다.

앱을 만들면 App Engine이 기본 버킷을 만듭니다. 이 버킷은 처음 5GB의 스토리지를 무료로 제공하며 Cloud Storage I/O 작업의 무료 할당량을 포함합니다. 다른 Cloud Storage 버킷을 만들 수 있지만 기본 버킷에만 처음 5GB의 무료 스토리지가 포함되어 있습니다.

App Engine에 Cloud Storage 사용

App Engine 앱에서 Cloud Storage 버킷을 사용하려면 다음 안내를 따르세요.

  1. App Engine 프로젝트에서 기존 버킷의 이름을 확인합니다. Cloud Storage에서 데이터를 업로드하거나 다운로드할 때 이 이름을 지정합니다.

    Cloud Storage 버킷의 이름을 앱에 하드 코딩하지 않고 앱의 환경 변수에 저장하는 것이 좋습니다.

  2. 앱에서 라이브러리를 앱의 종속 항목 파일에 추가하여 Cloud Storage를 종속 항목으로 선언합니다.

  3. 버킷에서 데이터를 업로드 또는 다운로드하려면 Google Cloud 클라이언트 라이브러리를 사용합니다.

기본 버킷 사용

앱을 만들 때 App Engine이 처음 5GB의 무료 스토리지를 제공하는 기본 버킷을 만듭니다. 기본 버킷에는 Cloud Storage I/O 작업을 위한 무료 할당량도 포함되어 있습니다. 자세한 내용은 가격 책정, 할당량, 한도를 참조하세요. 5GB 제한을 초과하는 스토리지를 사용하면 요금이 청구됩니다.

기본 버킷 이름의 형식은 다음과 같습니다.

project-id.appspot.com

App Engine은 앱의 새 버전을 배포할 때 임시 스토리지에 사용할 버킷도 만듭니다. 이름이 staging.project-id.appspot.com인 이 버킷은 App Engine에서만 사용됩니다. 앱은 이 버킷과 상호작용할 수 없습니다.

버킷 및 객체 권한 설정

프로젝트에 연결된 기본 서비스 계정에는 프로젝트에서 버킷을 읽고 쓰는 데 필요한 모든 권한이 있습니다.

이러한 권한을 관리하기 위해 각 App Engine 앱은 앱과 동일한 프로젝트에서 Cloud Storage 버킷에 대한 전체 읽기 및 쓰기 액세스 권한을 제공하는 기본 서비스 계정을 사용합니다. 기본 서비스 계정의 권한을 변경할 수 있지만 필요한 권한으로 IAM 역할을 할당하지 않으면 앱에서 액세스 권한을 상실할 수 있습니다.

다른 사용자, 앱, 프로젝트에서 버킷과 해당 콘텐츠에 액세스하도록 허용하는 방법은 버킷 권한 설정객체 권한 설정을 참조하세요.

로컬 개발 서버에서 Cloud Storage 사용

App Engine 로컬 개발 서버는 Cloud Storage를 에뮬레이션하지 않으므로 모든 Cloud Storage 요청은 인터넷을 통해 실제 Cloud Storage 버킷에 전송해야 합니다.

가격 책정, 할당량, 한도

Cloud Storage 클라이언트 라이브러리에서 Cloud Storage를 호출할 때 부과되는 대역폭 요금이 없습니다. 하지만 작업 비용은 청구됩니다. 또한 라이브러리가 Cloud Storage와 상호작용하는 데 URL Fetch 서비스를 사용하므로 호출 수가 URL Fetch 할당량에 반영됩니다.

Cloud Storage는 유료 서비스이며 Cloud Storage 가격표에 따라 비용이 청구됩니다.