存取 Go 適用的舊版套裝組合服務

本頁說明如何安裝及使用 App Engine 標準環境的Go 執行階段隨附的服務。應用程式可透過 Go 適用的 App Engine 服務 SDK 存取套裝組合服務。

事前準備

安裝 App Engine 服務 SDK

如要使用 Go 呼叫舊版套裝服務 API，請務必使用最新版 SDK。步驟如下：

  1. 更新 app.yaml 檔案，指定一或多個舊版套裝服務。例如：

    app_engine_bundled_services:
- datastore_v3
- memcache
- user

    如果您在 app.yaml 檔案的 handlers 區段中使用 login: admin 等功能，請在 app_engine_bundled_services 清單中設定 user，啟用 Users API。

  2. 在終端機中執行 go get，在 go.mod 檔案中新增最新 SDK 的參照，如下所示：

    go get google.golang.org/appengine/v2

    升級至 Go 時的主要差異是使用第 2 版的 App Engine 服務 SDK。

  3. 在應用程式中，將舊套件名稱中的 /v2/ 插入匯入陳述式，舉例來說，如果您使用 Memcache，請執行下列操作：

    import (
  "google.golang.org/appengine/v2"
  "google.golang.org/appengine/v2/memcache"
)

    如需可用套件名稱的完整清單，請參閱舊版服務套裝組合 API 參考說明文件。

  4. 執行 go mod tidy，清理 go.mod 檔案中的參照。

    go mod tidy

遷移注意事項

如果您要遷移至 Go 執行階段，且應用程式使用舊版套裝組合服務，請注意下列事項：