設定 Google Cloud Storage

您可以使用 Cloud Storage 值區儲存及提供檔案,例如電影、圖片,或其他靜態內容。本文件說明如何設定環境以使用 Cloud Storage 適用的 App Engine 用戶端程式庫。

設定專案

按照建立留言板應用程式一文中的操作說明設定您的環境、建立 GCP 專案,並瞭解 Python 2 應用程式在 App Engine 中建立結構的方式。記下並儲存專案 ID,以便用於應用程式。

啟用 Cloud Storage 值區

您至少需啟用一個值區才能使用 Cloud Storage。您可以使用預設值區,其免費提供 5GB 儲存空間。如有必要,可以再啟用其他 Cloud Storage 值區以便運用,不過,只有預設值區包含 5GB 的免費空間。預設值區也包含免費的 Cloud Storage I/O 運算配額。如需詳細資料,請參閱定價、配額與限制

如要啟用應用程式的預設 Cloud Storage 值區:

  1. 前往專案的「App Engine settings」(App Engine 設定) 頁面,在「Default Cloud Storage Bucket」(預設 Cloud Storage 值區) 下方按一下 [Create] (建立)。注意此值區的名稱格式為 <project-id>.appspot.com

  2. 若您所需的儲存空間超過 5GB 上限,可以針對您的專案啟用計費功能,將此值區設為付費值區。超過 5GB 限制的部分將須付費。

如要啟用一或多個付費值區,請按照建立值區一節的操作說明進行啟用。

設定值區與物件權限

預設情況下,當您建立專案所需的值區時,應用程式即已具備讀取和寫入該值區的一切必要權限。

如要設定允許其他使用者存取值區和其中內容的權限,請參閱設定值區權限設定物件權限等節的說明。

下載用戶端程式庫

您可以使用 pipGit 等常見工具下載 Cloud Storage 適用的 App Engine 用戶端程式庫。或者,您也可以從 GitHub 手動下載程式庫。請選擇您所偏好的方式:

Git

如過您已安裝 Git,可以按照下列指令複製 App Engine 的 Cloud Storage 用戶端程式庫所屬的 GitHub 存放區:

git clone https://github.com/GoogleCloudPlatform/appengine-gcs-client.git

pip

如果您已安裝 setuptools,可以按照下列指令,使用 pip 下載並安裝 Cloud Storage 適用的 App Engine 用戶端程式庫:

pip install GoogleAppEngineCloudStorageClient -t <your_app_directory/lib>

手動下載

您可以從 GitHub 下載包含 Cloud Storage 適用的 App Engine 用戶端程式庫的 ZIP 檔案:

位於 GitHub 的 Cloud Storage 適用的 App Engine 用戶端程式庫

然後將程式庫安裝至您的第三方程式庫專用目錄,例如 lib。如需詳細資訊,請參閱使用第三方程式庫

合併運用用戶端程式庫與開發應用程式伺服器

您可以在開發伺服器中使用用戶端程式庫。不過,由於 Cloud Storage 不會進行本機模擬,因此須透過網際網路,將讀取和寫入檔案的要求全數傳送到實際的 Cloud Storage 值區。

如要合併使用用戶端程式庫及開發應用程式伺服器:

  1. 啟用 Cloud Storage 值區

  2. 透過 --default_gcs_bucket_name [BUCKET_NAME] 標記來執行 dev_appserver.py,並將 [BUCKET_NAME] 替換為需使用的 Cloud Storage 值區名稱。

    這個標記會控制應用程式呼叫 file.DefaultBucketName(ctx) 時傳回的值區。

定價、配額與限制

透過 App Engine 用戶端程式庫呼叫 Cloud Storage 沒有相關的頻寬費用,但會產生作業費用。此外,呼叫次數須列入您的網址擷取配額計算,因為程式庫會使用網址擷取服務與 Cloud Storage 互動。

請注意,Google Cloud Storage 屬付費使用服務;您需按 Cloud Storage 價目表付費。

其他用於存取 Cloud Storage 的方式

除了用戶端程式庫之外,還可以使用下列方式:

  • Google Cloud Platform 主控台中的 Cloud Storage 瀏覽器,這個方式適用於快速上傳物件。
  • gsutil,這是一種指令列工具,適用於處理 Cloud Storage 中的檔案。

相關資源

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Python 2 適用的 App Engine 標準環境