設定 Google Cloud Storage

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

正在設定專案

建立 Google Cloud 專案，並瞭解 Python 2 應用程式在 App Engine 中的結構。記下並儲存專案 ID，以便用於應用程式。

啟用 Cloud Storage 值區

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

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

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

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

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

設定值區與物件權限

如要進一步瞭解如何允許應用程式的服務帳戶或其他使用者存取儲存體值區及其內容，請參閱「設定值區權限」和「設定物件權限」相關說明。

下載用戶端程式庫

您可以使用 pip 或 Git 等熱門工具，下載 Cloud Storage 適用的 App Engine 用戶端程式庫。或者，您也可以從 GitHub 手動下載程式庫。請選擇您所偏好的方式：

Git

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

git clone https://github.com/googleapis/python-storage.git

pip

您可以使用 pip 安裝 Cloud Storage 用戶端程式庫，如下所示：

pip install google-cloud-storage

手動下載

您可以從 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 互動。

請注意，Cloud Storage 屬付費使用服務；系統會根據 Cloud Storage 價目表向您收費。

其他用於存取 Cloud Storage 的方式

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

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

後續步驟