舊版隨附服務提供的大部分功能,現在都由 Cloud 用戶端程式庫提供。如要瞭解詳情,請參閱下方列出的建議替代方案。
如果專案無法遷移至未隨附解決方案,您或許可以繼續在Python 3應用程式中使用舊版隨附服務,做為備用方案。這種做法可讓您在遷移週期的後期,彈性改用未綁定的服務。
從舊版隨附服務遷移後,您可以繼續使用 App Engine,或遷移至 Cloud Run。Cloud Run 結合了標準環境和彈性環境的多項優質功能,可以改良 App Engine 服務。如要比較功能並瞭解如何遷移,請參閱 App Engine 和 Cloud Run 比較指南。
Google Cloud 獨立產品提供的功能,與 Python 執行階段中某些舊版隨附服務類似。對於 Google Cloud中未提供獨立產品的舊版隨附服務 (例如郵件和訊息),本指南建議使用第三方供應商或其他解決方法。
本頁面介紹舊版隨附服務的遷移路徑。
瞭解 Google Cloud 權限
遷移後的應用程式和使用的 Google Cloud 服務並非在同一個沙箱環境中執行,因此應用程式需要授權才能存取各項服務。舉例來說,如要與 Datastore 模式中的 Firestore (Datastore) 或 Cloud Tasks 互動,應用程式必須提供有權存取這些服務的帳戶憑證。
根據預設,在 App Engine 標準環境中執行的應用程式會提供預設 App Engine 服務帳戶的憑證,該帳戶有權存取與應用程式位於相同專案中的資料庫。
如果符合下列任一條件,請使用明確提供憑證的其他驗證方式:
應用程式和 Memorystore 資料庫位於不同的Google Cloud 專案。
您已變更指派給預設 App Engine 服務帳戶的角色。
如要瞭解其他驗證方式,請參閱「為伺服器對伺服器正式版應用程式設定驗證」。
本機開發作業的驗證
如要在本機開發或測試應用程式,請建立並使用服務帳戶。請勿使用預設 App Engine 服務帳戶,因為該帳戶具備專案的廣泛權限。建議您建立並使用具備特定開發和測試工作所需最低權限的服務帳戶。
如要設定服務帳戶並連結至應用程式,請參閱「手動取得及提供服務帳戶憑證」。
安裝用戶端程式庫
如要透過 Python 應用程式使用 Google Cloud 服務,請安裝該服務的 Python 用戶端 程式庫。 Google Cloud 服務也提供 REST API 和其他介面。
如要安裝 Python 3 執行階段的用戶端程式庫,請按照下列步驟操作:
將程式庫名稱新增至應用程式的
requirements.txt檔案。例如:google-cloud-ndb
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」。
圖片
如要遷移 App Engine Images 服務,請將容器映像檔轉換服務部署至 Cloud Run,並將 App Engine Images 服務呼叫轉送至該服務。如要託管及提供圖片,請將圖片儲存在 Cloud Storage bucket,或使用 Cloud CDN 發布。詳情請參閱「遷移 Images 服務」。記錄
建議您更新應用程式,改用 Cloud Logging。Cloud Logging 支援多項功能,例如在 Logs Explorer 中查看記錄檔、下載記錄檔、依嚴重性篩選訊息,以及將應用程式訊息與特定要求建立關聯。或者,如果您偏好簡單,而非資料準確度,可以將結構化記錄寫入 stdout 或 stderr。詳情請參閱「寫入及查看記錄」 和「遷移至 Cloud Logging」。
郵件
為提升電子郵件安全性,並確保大量電子郵件能可靠傳送,建議您從舊版郵件服務遷移至採用 SMTP 的電子郵件服務,例如 SendGrid、Mailgun 或 Mailjet。Memcache
如要快取應用程式資料,請使用 Memorystore for Redis。
詳情請參閱「將 Memcache 遷移至 Memorystore」。如要模擬這項遷移作業,請在範例應用程式中新增 Memcache 用量,然後遷移至 Memorystore for Redis。
如果應用程式使用 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 產品。
推送任務
如要執行非同步程式碼,請改用 Cloud Tasks,而非 App Engine 工作佇列推送工作服務。您可以升級 App Engine 服務 SDK (不需重構應用程式程式碼),或使用 Cloud Tasks 用戶端程式庫,並以 Python 3 標準環境端點做為目標。如要比較這兩個選項,請參閱「將發送佇列遷移至 Cloud Tasks 總覽」。
如要使用範例應用程式模擬這項遷移作業,請參閱「如何在 Flask 應用程式中使用 App Engine 發送佇列」和「遷移至 Cloud Tasks」。
提取工作
如果您使用工作佇列提取工作服務,例如將工作或訊息排入佇列,由個別 worker 處理,Cloud Pub/Sub 是不錯的替代方案。提供類似的功能和傳遞保證。與其他 Cloud 服務一樣,Pub/Sub 提供便利的用戶端程式庫,方便您存取服務。詳情請參閱「寫入及回應 Pub/Sub 訊息」和「將工作佇列提取工作遷移至 Pub/Sub」遷移指南。
如要使用範例應用程式模擬這項遷移作業,請參閱「如何使用 App Engine 提取工作」和「遷移至 Pub/Sub」。
網址擷取
根據預設,Python 2.7 執行階段會使用網址擷取服務處理傳出 HTTP(S) 要求,即使您使用標準 Python 程式庫發出這些要求也一樣。
如果應用程式直接使用網址擷取 API (例如發出非同步要求),建議您遷移至標準 Python 程式庫,例如 Requests 程式庫。
詳情請參閱「遷移傳出要求」。
使用者驗證
如要尋找 Users API 的替代方案,請使用「使用者驗證」頁面所述的任何 HTTP 驗證機制。