Python ライブラリの使用

依存関係の宣言と管理

Python アプリケーションの依存関係は標準 requirements.txt ファイルで宣言されています。例:

Flask==0.10.1
google-cloud-storage

任意の Linux 互換 Python パッケージをネイティブ（C）拡張機能を必要とするパッケージを含む App Engine フレキシブル環境で使用できます。

Python ランタイムは、デプロイ中に requirements.txt で宣言されたすべての依存関係を自動的にインストールします。

依存関係をローカルにインストールする

アプリケーションをローカルで開発してテストする場合は、venv を使用してアプリケーションの依存関係をシステム パッケージから分離することをおすすめします。これにより、依存関係がローカルマシンとデプロイしたアプリケーションで確実に同じバージョンが使用されるようにすることもできます。

venv を使用して依存関係をインストールする手順は次のとおりです。

Mac OS / Linux

  1. 分離された Python 環境を作成します。
    python3 -m venv env
source env/bin/activate
  2. 現在のディレクトリにサンプルコードが含まれていない場合は、hello_world サンプルコードが含まれるディレクトリに移動します。その後、依存関係をインストールします。
    cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt

Windows

PowerShell を使用して Python パッケージを実行します。

  1. インストールされた PowerShell を探します。
  2. PowerShell へのショートカットを右クリックし、管理者として PowerShell を起動します。
  3. 分離された Python 環境を作成します。
    python -m venv env
.\env\Scripts\activate
  4. プロジェクト ディレクトリに移動し、依存関係をインストールします。現在のディレクトリにサンプルコードが含まれていない場合は、hello_world サンプルコードが含まれるディレクトリに移動します。その後、依存関係をインストールします。
    cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt

これで、アプリケーションを実行したときに、requirements.txt で宣言されている依存関係のみが使用できるようになります。

ウェブ フレームワークのインストール

アプリでウェブ リクエストに対応できるようにするには、ウェブ フレームワークを使用する必要があります。以下を含む任意の Python ウェブ フレームワークを使用できます。

特定のウェブ フレームワークを使用するには、次の requirements.txt に追加します。

Flask==0.10.1

WSGI サーバーをインストールする

組み込み WSGI サーバーが搭載されたウェブ フレームワークがありますが、本番環境のトラフィックの処理に適しているのは少数です。大部分のウェブ アプリケーションは、Gunicorn、uWSGI、Waitress などのスタンドアロン WSGI サーバーを使用します。WSGI サーバーのインストール、構成、使用方法については、アプリケーションの起動をご覧ください。

Google Cloud クライアント ライブラリをインストールする

Python 用 Google Cloud クライアント ライブラリは、記述しなければならないボイラープレート コードを著しく減らす Google Cloud Platform サービスへのアクセス用クライアント ライブラリです。ライブラリは、高いレベルの API 抽象化を提供するため、理解しやすくなります。Python 固有のスタイルに従っているので、標準ライブラリとうまく連携し、コードベースとの統合も向上します。つまり、重要なコードの作成により多くの時間を割くことができるようになります。

ライブラリをローカルにインストールするには:

pip install google-cloud

クライアント ライブラリも Google Cloud CLI を使用して自動的に認証を処理できます。

gcloud auth login