從舊版套裝組合服務遷移

Go Java PHP Python

Cloud 用戶端程式庫現在提供舊版套裝服務提供的大部分功能。如需更多資訊，請參閱下方建議的替代方案。

如果遷移至非內含的解決方案不是專案的選項，您可以繼續使用Python 3、應用程式中的舊版內含服務做為備用方案。這種做法可讓您在遷移週期後，靈活地轉換至非捆綁服務。

注意：並非所有適用於Python 2、

遷移至非舊版套裝服務後，您可以繼續使用 App Engine，或遷移至 Cloud Run。Cloud Run 旨在改善 App Engine 體驗，並整合標準環境和彈性環境的許多最佳功能。如要比較功能並瞭解如何遷移，請參閱 App Engine 和 Cloud Run 比較指南。

Google Cloud 獨立產品提供的功能與 Python 2 執行階段中的某些服務套裝組合相似。對於在 Google Cloud中無法以獨立產品形式提供的套裝服務 (例如圖像處理、搜尋和訊息傳送)，本指南建議使用第三方供應商或其他解決方法。

本頁面將介紹每項服務套件的遷移路徑。

瞭解 Google Cloud 權限

由於已遷移的應用程式和其使用的 Google Cloud 服務不再在相同的「沙箱」環境中執行，因此應用程式需要授權才能存取每項服務。舉例來說，如果要與 Datastore 模式 (Datastore) 中的 Firestore 或 Cloud Tasks 互動，應用程式就必須提供已獲授權存取這些服務的帳戶憑證。

根據預設，App Engine 標準執行階段中的應用程式會提供 App Engine 預設服務帳戶的憑證，該帳戶已獲授權存取與應用程式位於相同專案中的資料庫。

如果符合下列任一條件，就必須使用其他驗證方法，明確提供憑證：

• 您的應用程式和 Memorystore 資料庫位於不同的Google Cloud 專案中。

• 您已變更指派給預設 App Engine 服務帳戶的角色。

如要瞭解其他驗證技術，請參閱「設定伺服器對伺服器正式版應用程式的驗證作業」。

本機開發的驗證

如要在本機開發或測試應用程式，建議您建立並使用服務帳戶。請勿使用 App Engine 預設服務帳戶，因為該帳戶對專案中的所有內容具有高層級權限。請改為建立並使用服務帳戶，為特定開發和測試工作建立具備最低級所需權限的服務帳戶。

如要瞭解如何設定服務帳戶並將其連結至應用程式，請參閱「手動取得及提供服務帳戶憑證」一文。

安裝用戶端程式庫

透過 Python 應用程式使用 Google Cloud 服務最簡單的方法，就是安裝服務的 Python 用戶端程式庫。 Google Cloud 服務也提供 JSON REST 和其他介面。將用戶端程式庫安裝到 App Engine 執行階段的步驟，在 Python 2 應用程式和 Python 3 應用程式中有所不同。

為 Python 2 應用程式安裝程式庫

如要安裝程式庫，以便應用程式在 Python 2 執行階段執行時使用：

1. 建立目錄以儲存第三方程式庫，例如 lib/。

2. 在 app.yaml 檔案所在的資料夾中建立 requirements.txt 檔案，然後新增用戶端程式庫的名稱。

   舉例來說，您可以使用下列檔案安裝 Pub/Sub 和 Cloud Tasks 的程式庫：

   google-cloud-pubsub
   google-cloud-tasks
   

3. 使用 pip install 將程式庫安裝到您建立的資料夾中。例如：

   pip install -t lib -r requirements.txt

4. 在應用程式的 app.yaml 檔案中，請在 libraries 區段中指定必要的 Google RPC 和 setuptools 程式庫，以及選用的 SSL 程式庫：

   libraries:
   - name: grpcio
     version: 1.0.0
   - name: setuptools
     version: 36.6.0
   - name: ssl
     version: latest
   

   部分用戶端程式庫不需要 SSL 程式庫。如果您未為需要 SSL 的用戶端程式庫加入 SSL 程式庫，應用程式收到要求時，您會在「Logs Explorer」中看到 SSL 錯誤。

5. 如果您尚未建立 appengine_config.py 檔案，請在 app.yaml 檔案所在的資料夾中建立一個。請將以下內容新增到 appengine_config.py 檔案中：

   # appengine_config.py
   import pkg_resources
   from google.appengine.ext import vendor
   
   # Set path to your libraries folder.
   path = 'lib'
   # Add libraries installed in the path folder.
   vendor.add(path)
   # Add libraries to pkg_resources working set to find the distribution.
   pkg_resources.working_set.add_entry(path)

   請務必使用 pkg_resources 模組，確保應用程式使用正確的用戶端程式庫發行套件。

   上述範例中的 appengine_config.py 檔案假設 lib 資料夾位於目前的工作目錄。如果您無法保證 lib 一律會位於目前的工作目錄中，請指定 lib 資料夾的完整路徑。例如：

   import os
   path = os.path.join(os.path.dirname(os.path.realpath(__file__)), 'lib')

6. 部署應用程式。

App Engine 會將您在 appengine_config.py 檔案中指定的目錄中所有程式庫上傳至 Python 2 執行階段。

為 Python 3 應用程式安裝程式庫

如要安裝程式庫，以便應用程式在 Python 3 執行階段執行時使用：

1. 將程式庫名稱新增至應用程式的 requirements.txt 檔案。例如：

   google-cloud-ndb
   

2. 部署應用程式。

App Engine 會自動將 requirements.txt 檔案中列出的所有程式庫上傳至 Python 3 執行階段。

App Engine 套裝組合服務的遷移路徑

Blobstore

如要儲存及擷取資料，請透過 Cloud 用戶端程式庫使用 Cloud Storage。如要開始使用，請參閱「使用 Cloud Storage」 ，以及從 Blobstore 遷移至 Cloud Storage指南。如要模擬這項遷移作業，請將 Blobstore 用法新增至範例應用程式，然後遷移至 Cloud Storage。

Datastore

如果您的 Python 2 應用程式使用 NDB 與 Datastore 互動，請遷移至 Cloud NDB 程式庫。Cloud NDB 主要用於遷移 Python 2 應用程式的轉換工具。建議 Python 3 應用程式使用 Datastore 模式用戶端程式庫。

詳情請參閱「遷移至 Cloud NDB」。如要使用範例應用程式模擬這項遷移作業，請參閱「從 App Engine ndb 遷移至 Cloud NDB」。

圖片

您可以從 Cloud Storage 提供圖片、直接提供圖片，或使用第三方內容傳遞聯播網 (CDN)。

如要調整圖片大小、轉換圖片和操控圖片，請使用圖片處理程式庫，例如 Pillow 或 ImageMagick 的 Python 介面。

如要使用其中一個第三方程式庫，請將程式庫設為依附元件，並更新程式碼以呼叫程式庫的 API。

App Engine 圖片服務也可透過服務網址來處理圖片大小調整作業，藉此避免對應用程式發出動態要求。如需類似功能，您可以提前產生經重新調整大小的圖片，並將其上傳至 Cloud Storage 以提供使用。或者，您也可以使用第三方內容傳遞聯播網 (CDN) 服務來調整圖片大小。

記錄

建議您更新應用程式，以便使用 Cloud Logging。Cloud Logging 支援多項功能，例如在 Logs Explorer 中查看記錄、下載記錄、依嚴重程度篩選訊息，以及將應用程式訊息與特定要求建立關聯。或者，如果您偏好簡單易懂的資料，可以將結構化記錄寫入 stdout 或 stderr。詳情請參閱「寫入及查看記錄」 和「遷移至 Cloud Logging」。

郵件

如要傳送電子郵件，請使用 SendGrid、Mailgun 或 Mailjet 等第三方郵件服務供應商。這些服務均提供 API，以便從應用程式傳送電子郵件。目前沒有建議的第三方替代方案可用於處理入站訊息。

Memcache

如要快取應用程式資料，請使用 Memorystore for Redis。

詳情請參閱「將 Memcache 遷移至 Memorystore」。如要模擬這項遷移作業，請在範例應用程式中新增 Memcache 用途，然後遷移至 Memorystore for Redis。

注意： 與 Memcache 不同，Memorystore for Redis 不提供免費方案。 如要進一步瞭解 Memorystore 定價，請參閱「配額與限制」。

如果應用程式只使用 Memcache 來縮短 NDB (或 Cloud NDB) 要求的延遲時間，請使用 Cloud NDB 內建的 Redis 支援，而非 Memcache 或 Memorystore for Redis。

模組

如要取得資訊並修改應用程式正在執行的服務，請併用環境變數和 App Engine Admin API：

服務資訊	存取方式
目前的應用程式 ID	GAE_APPLICATION 環境變數
目前的專案 ID	GOOGLE_CLOUD_PROJECT 環境變數
目前的服務名稱	GAE_SERVICE 環境變數
目前的服務版本	GAE_VERSION 環境變數
目前的執行個體 ID	GAE_INSTANCE 環境變數
預設主機名稱	Admin API apps.get 方法
服務清單	Admin API apps.services.list 方法
服務的版本清單	Admin API apps.services.versions.list 方法
服務的預設版本，包含所有的流量分割	Admin API apps.services.get 方法
版本的執行中執行個體清單	Admin API apps.services.versions.instances.list 方法

如要進一步瞭解應用程式執行服務的可用資料，請參閱 Python 3 執行階段環境。

命名空間

Namespaces API 可讓多租戶應用程式為每個用戶群指定專屬的命名空間字串，藉此劃分資料。

雖然 Datastore 直接支援多租戶架構，但其他 Google Cloud服務則不支援。如果多租戶應用程式使用其他 Google Cloud服務，您需要手動處理多租戶架構。如要將服務的執行個體完全隔離，您可以透過 Cloud Resource Manager API 以程式輔助的方式建立新專案，並且跨專案存取資源。

OAuth

請改用 OAuth 2.0 API 的 oauth2.tokeninfo 方法，不要使用 App Engine OAuth 服務驗證 OAuth 2.0 權杖。

搜尋

您可以在 Compute Engine 上託管任何全文搜尋資料庫 (例如 Elasticsearch)，並從您的服務存取該資料庫。

工作佇列

App Engine 工作佇列服務提供兩種模式。從兩個點遷移至兩種不同的獨立雲端產品。

推送工作

請使用 Cloud Tasks 用戶端程式庫，並將 Python 3 標準環境端點做為目標，而非使用 App Engine 工作佇列推送工作服務來執行非同步程式碼。詳情請參閱「將推送佇列遷移至 Cloud Tasks」。

如要使用範例應用程式模擬這項遷移作業，請參閱「如何在 Flask 應用程式中使用 App Engine 推送佇列」和「遷移至 Cloud Tasks」相關說明。

提取工作

如果您使用工作佇列提取工作服務 (例如將個別工作或訊息排入佇列，以便由個別 worker 處理)，Cloud Pub/Sub 會是不錯的替代方案。可提供類似的功能和傳遞保證。與其他雲端服務一樣，Pub/Sub 提供方便的用戶端程式庫，可用來存取服務。詳情請參閱「編寫及回應 Pub/Sub 訊息」和「將 Task Queue 拉取工作移至 Pub/Sub」遷移指南。

如要使用範例應用程式模擬這項遷移作業，請參閱「如何使用 App Engine 提取工作」一文，瞭解如何將應用程式用於範例應用程式，並遷移至 Pub/Sub。

網址擷取

根據預設，Python 2.7 執行階段會使用網址擷取服務處理傳出 HTTP(S) 要求，即使您使用標準 Python 程式庫發出這些要求也一樣。

如果您的應用程式直接使用 URL Fetch API (例如發出非同步要求)，建議您遷移至標準 Python 程式庫，例如 Requests 程式庫。

詳情請參閱「遷移外送要求」。

使用者驗證

如需 Users API 的替代方案，請使用「使用者驗證」頁面所述的任何以 HTTP 為基礎的驗證機制。