本页面介绍如何安装捆绑服务并将其与适用于 App Engine 标准环境的 Go 运行时搭配使用。您的应用可以通过 Go 版 App Engine 服务 SDK 访问捆绑服务。
准备工作
- 请参阅您可以在 Go 运行时中调用的旧版捆绑服务 API 列表。
- 在启动到 Go 的迁移项目之前,请参阅运行时迁移概览以及使用旧版捆绑服务时的迁移注意事项。
安装 App Engine 服务 SDK
为了调用适用于 Go 的旧版捆绑服务 API,您必须使用最新的 SDK。请按照以下步骤操作:
更新您的
app.yaml
文件,在其中添加以下代码行:app_engine_apis: true
通过在终端运行
go get
,在go.mod
文件中添加对最新 SDK 的引用,如下所示:go get google.golang.org/appengine/v2
升级到 Go 之后的主要区别在于系统会使用 App Engine 服务 SDK v2。
在您的应用中,在旧软件包名称中插入
/v2/
,以修改导入语句。例如,如果使用 Memcache,请执行以下操作:import ( "google.golang.org/appengine/v2" "google.golang.org/appengine/v2/memcache" )
如需查看可用软件包名称的完整列表,请参阅旧版捆绑服务 API 参考文档。
运行
go mod tidy
以清理go.mod
文件中的引用。go mod tidy
迁移注意事项
如果您要迁移到 Go 运行时并且您的应用使用旧版捆绑服务,则应注意以下事项:
- 如需在 Go 应用中测试旧版捆绑服务功能,请使用您常用的开发工具(例如
go run
)在本地环境中运行应用。 - 如需部署应用,请使用
gcloud app deploy
命令。