Python ランタイム

Cloud Run 関数は、オペレーティング システムのバージョンに加えて、アドオン パッケージ、言語サポート、お使いの関数をサポートして呼び出す Python Functions Framework ライブラリで構成される環境で実行されます。この環境は言語バージョンで識別され、ランタイム ID として知られています。

関数の準備

関数は、Google Cloud コンソールから直接準備することも、ローカルマシンで作成してアップロードすることもできます。Python 開発用にローカルマシンを準備するには、Python 開発環境を設定するをご覧ください。

サポートされている Python ランタイムとベースイメージ

ランタイム ランタイム ID スタック ランタイム ベースイメージ
Python 3.12 python312
  • google-22（デフォルト）
  • google-22-full
    		•
  • google-22/python312
  • google-22-full/python312
    		•
    Python 3.11 python311
  • google-22（デフォルト）
  • google-22-full
    		•
  • google-22/python311
  • google-22-full/python311
    		•
    Python 3.10 python310
  • google-22（デフォルト）
  • google-22-full
    		•
  • google-22/python310
  • google-22-full/python310
    		•
    Python 3.9 python39 google-18-full google-18-full/python39
    Python 3.8 python38 google-18-full google-18-full/python38
    Python 3.7 python37 google-18-full google-18-full/python37

    ランタイムの選択

    デプロイ時に、関数にサポートされている Python ランタイムのいずれかを選択できます。

    ランタイム バージョンを選択するには、Google Cloud コンソールまたは gcloud CLI を使用します。使用するツールのタブをクリックして、手順を確認してください。

    gcloud

    関数をデプロイするときに、--base-image フラグを使用して関数の Python ベースイメージを指定します。次に例を示します。

    gcloud run deploy FUNCTION \
    --source . \
    --function FUNCTION_ENTRYPOINT \
    --base-image python312

    次のように置き換えます。

    • FUNCTION: デプロイする関数の名前。このパラメータは省略できますが、省略すると名前の入力を求められます。

    • FUNCTION_ENTRYPOINT: ソースコード内の関数のエントリ ポイント。これは、関数の実行時に Cloud Run が実行するコードです。このフラグには、ソースコード内に存在する関数名または完全修飾クラス名を指定する必要があります。

    gcloud CLI を使用して関数をデプロイする手順については、Cloud Run で関数をデプロイするをご覧ください。

    コンソール

    ランタイム バージョンは、Google Cloud コンソールで Cloud Run 関数を作成または更新するときに選択できます。関数のデプロイ手順については、Cloud Run で関数をデプロイするをご覧ください。

    関数を作成するときに Google Cloud コンソールでランタイムを選択する手順は次のとおりです。

    1. Google Cloud コンソールで [Cloud Run] ページに移動します。

      Cloud Run に移動

    2. [関数を作成] をクリックします。

    3. [ランタイム] リストで、Python ランタイム バージョンを選択します。

    4. [作成] をクリックし、Cloud Run がプレースホルダ リビジョンを使用してサービスを作成するのを待ちます。

    5. コンソールの [ソース] タブにリダイレクトされ、関数のソースコードが表示されます。[保存して再デプロイ] をクリックします。

    関数のデプロイ後にランタイム バージョンを更新する手順については、新しいソースコードを再デプロイするをご覧ください。

    ソースコードの構造

    Cloud Run functions が関数の定義を見つけるには、ソースコードが特定の構造に従っている必要があります。詳細については、Cloud Run 関数を作成するをご覧ください。

    依存関係の指定

    Python で記述された Cloud Run functions の依存関係を指定するには、2 つの方法があります。1 つは pip パッケージ マネージャーの requirements.txt ファイルを使用する方法、もう 1 つは関数と一緒にローカル依存関係をパッケージ化する方法です。詳細については、Python で依存関係を指定するをご覧ください。

    Cloud Run functions では、Pipfile/Pipfile.lock で依存関係を指定できないため、プロジェクトにこれらのファイルが含まれないようにする必要があります。

    環境変数

    Python ランタイムは、必要に応じて関数で使用する特定の環境変数を自動的に設定します。詳細については、環境変数を構成するをご覧ください。