レガシーバンドルサービスからの移行
bookmark_border コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

従来のバンドルサービスで提供される機能の大部分が Cloud クライアントライブラリで提供されるようになりました。詳細については、下記のおすすめの代替方法をご覧ください。

バンドルされていないソリューションへの移行がプロジェクトでできない場合、代替として Python 3アプリで従来のバンドルサービスの使用を継続できる可能性があります。このアプローチでは、移行サイクルの後半でバンドルされていないサービスに移行できます。

以前のバンドルサービスから移行した後は、App Engine を引き続き使用することも、Cloud Run に移行することもできます。Cloud Run は、App Engine のエクスペリエンスを改善するために設計されており、スタンダード環境とフレキシブル環境の両方の多くの最良の機能が組み込まれています。機能の違いと移行方法の詳細については、App Engine と Cloud Run の比較ガイドをご覧ください。

Google Cloud では、Python 2 ランタイムのバンドルサービスの一部と同様の機能を提供するスタンドアロンプロダクトを使用できます。 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 サービスにより、JSON REST とその他のインターフェースも提供されます。App Engine ランタイムにクライアントライブラリをインストールする手順は、Python 2 アプリと Python 3 アプリで異なります。

Python 2 アプリ用ライブラリのインストール

Python 2 ランタイムで動作するアプリが使うライブラリをインストールするには:

サードパーティライブラリの保存先ディレクトリ（例: lib/）を作成します。
app.yaml ファイルと同じフォルダに requirements.txt ファイルを作成し、クライアントライブラリの名前を追加します。

たとえば、Pub/Sub、Cloud Tasks のライブラリをインストールする場合は、次のファイルが使用されます。
```
google-cloud-pubsub
google-cloud-tasks
```
pip install を使用して、作成したフォルダにライブラリをインストールします。例:
```
pip install -t lib -r requirements.txt
```
アプリの 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 エラーが表示されます。
まだ作成されていない場合は、app.yaml ファイルと同じフォルダに appengine_config.py ファイルを作成します。次のコードを 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')
```
アプリをデプロイします。

App Engine は、appengine_config.py ファイルで指定されたディレクトリ内のすべてのライブラリを Python 2 ランタイムにアップロードします。

Python 3 アプリ用ライブラリのインストール

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 への移行をご覧ください。

画像

画像の配信には、Cloud Storage から行う方法、直接配信する方法、サードパーティのコンテンツ配信ネットワーク（CDN）を使用する方法があります。

画像のサイズ変更、変換、操作を行うには、Pillow や ImageMagick の Python インターフェースなどの画像処理ライブラリを使用します。

こうしたサードパーティライブラリを使用するには、ライブラリを依存関係として追加し、ライブラリの API を呼び出すようにコードを更新します。

また、App Engine Images サービスでは、サービス提供 URL を使用して画像のサイズ変更を処理することで、アプリケーションへの動的リクエストを回避する機能も提供されます。同様の機能は、サイズが変更された画像を事前に生成し、Cloud Storage にアップロードして配信することでも実現できます。または、画像のサイズ変更機能が用意されているサードパーティコンテンツ配信ネットワーク（CDN）サービスを利用することもできます。

ロギング

Cloud Logging を使用するように、アプリを更新することをおすすめします。Cloud Logging では、ログエクスプローラのログの表示、ログのダウンロード、重大度によるメッセージのフィルタリング、特定のリクエストとのアプリメッセージの関連付けなどの機能がサポートされています。または、データの精度よりも簡素化を求める場合、構造化ログを stdout または stderr に書き込むこともできます。詳細については、ログの書き込みと表示と Cloud Logging への移行をご覧ください。

メール

メールを送信するには、SendGrid、Mailgun、Mailjet などのサードパーティのメールプロバイダを使用します。これらのサービスはいずれも、アプリケーションからメールを送信するための API を提供しています。現時点では、受信メッセージングにおすすめのサードパーティのプロバイダはございません。

Memcache

アプリケーションデータをキャッシュに保存するには、Memorystore for Redis を使用します。

詳細については、Memcache から Memorystore への移行をご覧ください。この移行をシミュレートするには、サンプルアプリに Memcache 使用状況を追加し、Memorystore for Redis に移行します。

NDB（または Cloud NDB）リクエストのレイテンシを短縮するためにのみ Memcache を使用するアプリの場合、Memcache や Memorystore for Redis の代わりに、Cloud NDB の 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ランタイム環境をご覧ください。

Namespace

Namespaces API では、テナントごとに一意の名前空間文字列を指定するだけで、マルチテナントアプリでテナント間のデータを分割できます。

Datastore は直接マルチテナンシーをサポートしていますが、他の Google Cloudサービスはサポートしていません。マルチテナントのアプリで他の Google Cloudサービスを使用する場合は、手動でマルチテナンシーを処理する必要があります。完全に分離されたサービスインスタンスを設定するには、Cloud Resource Manager API を使用してプログラムで新規プロジェクトを作成し、すべてのプロジェクトのリソースにアクセスできます。

OAuth

App Engine OAuth サービスを使用して OAuth 2.0 トークンを確認する代わりに、OAuth 2.0 API の oauth2.tokeninfo メソッドを使用します。

検索

Compute Engine 上で Elasticsearch のような全文検索データベースをホストし、サービスからアクセスします。

タスクキュー

App Engine タスクキューサービスは、2 つの異なるモードで使用できます。いずれかの移行元から 2 つの異なるスタンドアロンクラウドプロダクトに移行します。

push タスク

非同期コードの実行に App Engine タスクキューの push タスクサービスを使用するのではなく、ターゲットとして Python 3 スタンダード環境エンドポイントを使用する Cloud Tasks クライアントライブラリを使用します。詳細については、push キューの Cloud Tasks への移行をご覧ください。

サンプルアプリでこの移行をシミュレートするには、Flask アプリで App Engine push キューを使用する方法と Cloud Tasks への移行をご覧ください。

pull タスク

タスクキューの pull タスクサービスを使用する場合（たとえば、別のワーカーで処理するタスクやメッセージをキューに登録する場合など）は、Cloud Pub/Sub が適切な代替策となります。Cloud Pub/Sub は同様の機能に加えて配信保証を提供します。他の Cloud サービスと同様に、Pub/Sub には、このサービスにアクセスするための便利なクライアントライブラリが用意されています。詳細については、Pub/Sub メッセージの作成とレスポンスとタスクキューの pull タスクから Pub/Sub への移行ガイドをご覧ください。

サンプルアプリでこの移行をシミュレートするには、サンプルアプリでの App Engine の pull タスクの使用方法と Pub/Sub への移行をご覧ください。

URL 取得

デフォルトでは、Python 2.7 ランタイムは、URL 取得サービスを使用して送信 HTTP(S) リクエストを処理します。標準の Python ライブラリを使用してリクエストを発行する場合も同様です。

非同期リクエストを行うなど、アプリが URL Fetch API を直接使用する場合は、標準の Python ライブラリ（リクエストライブラリなど）に移行することをおすすめします。

詳細については、送信リクエストの移行をご覧ください。

ユーザー認証

Users API の代わりに、ユーザー認証で説明されている HTTP ベースの認証メカニズムのいずれかを使用します。