このページでは、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/
を挿入して import ステートメントを変更します。たとえば、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
コマンドを使用します。