Python版Azure Functionsで外部モジュールをインポートする方法を徹底解説

Python版Azure Functionsにおけるモジュールインポートの課題

本記事の執筆時点において、Azure FunctionsのPythonサポートはまだ実験的な段階にあります。そのため、pipなどのパッケージマネージャーを使って、実行環境に直接モジュールをインストールする方法は現状提供されていません。

つまり、必要なモジュールは自分のコードと一緒に持ち込む必要があります。Azure Functionsにはデフォルトで利用できるサードパーティ製モジュールが一切用意されていないため、以下のいずれかの方法でモジュールを追加することになります。

• AzureポータルのUIからモジュールをアップロードする
• Kuduコンソールからアップロードする（多数のファイルを扱う場合に便利）

virtualenvを活用した代替アプローチ

virtualenv（仮想環境）の使用を気にしないのであれば、より効率的な代替手段があります。以下の手順に従ってください。

1. Azure Functions上でPythonスクリプトを作成します。
2. Kuduコンソールを開き、スクリプトが配置されているディレクトリへ移動（cd）します。
3. そのフォルダ内に仮想環境を作成します。
   python -m virtualenv myvenv
4. 作成した仮想環境を読み込みます。
   cd myvenv/Scripts に移動し、activate.bat を実行してください。正常に読み込まれると、シェルのプロンプトに (myvenv) というプレフィックスが表示されます。
5. pipを最新版に更新します。
   python -m pip install -U pip
6. pipを使って必要な依存パッケージをインストールします（例：Djangoの場合）。
   python -m pip install django

sys.pathへの仮想環境パスの追加

セットアップが完了したら、スクリプト内でモジュールをインポートしたい箇所すべてに、この仮想環境のパスを sys.path 変数へ追加します。具体的には以下のように記述します。

import sys, os.path
sys.path.append(os.path.abspath(os.path.join(os.path.dirname( __file__ ), 'myvenv/Lib/site-packages')))

このコードにより、スクリプトの配置場所を基準とした仮想環境の site-packages ディレクトリがPythonのモジュール検索パスに追加され、pipでインストールしたライブラリを通常どおり import できるようになります。

まとめ

Python版Azure Functionsは実験段階のため、依存関係の管理には一手間必要です。Kuduやポータルからの手動アップロード、あるいはvirtualenvと sys.path の組み合わせを活用することで、外部モジュールを問題なく利用できます。将来的な正式サポートに期待しつつ、当面はこれらのワークアラウンドを活用しましょう。