azure-recipe-user はじめに
HTTPリクエストに応答するPython関数を、VSCodeを利用して作成します。
作成した関数をローカル環境でテストした後、Azure Functionsのサーバレス環境にデプロイして、HTTPリクエストができるかどうか試してみます。
概要
Azure Functionsとは、Microsoft Azureのサービスのひとつで、
Web APIをとても簡単に作れるフレームワークです。
こちらの記事がとても詳しく解説されています。
Azure Functionsでサーバーレスアーキテクチャが何かを理解する:
https://qiita.com/yuhattor/items/f7b2aec5211951dd7622
Azure公式ドキュメント:
https://azure.microsoft.com/ja-jp/services/functions/
ゴール
- Azure Functions環境をセットアップ
- Python関数作成
- ローカル環境で関数を実行
- Azureにデプロイ
こちらの4項目についてやっていきたいと思います！
1. Azure Functions環境をセットアップ
まず、以下の環境が必要になります。
- Azureアカウントの作成
こちらから作成できます。
- Azure Functions Core Tools のインストール
こちらを参考にして Azure Functions Core Tools をインストールします。
- Pythonをインストールします。
※Azure Functions Core Tools で Python3.9 がプレビューになっているので今回は Python3.8.9 をインストールしています。
- VSCodeをインストールします。
- VSCodeにPython拡張機能と、Azure Functions拡張機能をインストールしてください。
上記セットアップが完了しましたら、さっそくPython関数を作成していきます！
2. Python関数作成
セットアップがすべて完了したなら、Python関数を作成していきます。
ディレクトリ作成
- コマンドプロンプトを起動し、次のコマンドを実行してプロジェクトとローカルのGitリポジトリを作成します。
- プロジェクト名を入力すると、そのプロジェクト名のフォルダの作成と初期化を実行します。 プロジェクト名がすでにある場合は、フォルダの中身を初期化します。
|
1 2 |
func init MyFunctionProj |
- ランタイムを選択します。
|
1 2 3 4 5 6 7 8 9 10 |
func init MyFunctionProj Use the up/down arrow keys to select a worker runtime: dotnet dotnet (isolated process) node python java powershell custom |
- 今回はPythonを選択します。 上/下方向キーを使用してPythonを選択し、Enter キーを押します。 終わったらVSCodeに移ります。
VSCodeで関数作成
- アクティビティバーのAzureアイコンをクリックし、FUNCTION から [Create New Project] を選択します。
- 今回作成する Python関数をどのディレクトリに格納する / 新規ディレクトリを作成するか選択します。今回はコマンドプロンプトから作成した MyFunctionProj のディレクトリを選択しました。
- 今回利用する言語、Pythonを選択します。Python以外にもC#、Java、TypeScriptなどにも対応しているようです。
- プロジェクトのテンプレートを選択します。今回はHTTPリクエストの応答をやりたいので HTTP Trigger を選択します。
その他にも、 Azure Blob Storage Trigger、Azure Queue Storage Trigger などが選択できます。
- 関数の名前を決めます。
- この関数の権限を決めます。
今回は Anonymous を選択します。
すべてのユーザーが関数のエンドポイントを呼び出すことができるようになります。
- 関数作成が終わると、左のメニューバーのAzureアイコンから
作成した関数のフォルダが見られるようになります。
（赤枠で囲った部分）
3. ローカル環境で関数を実行
Azure へのサインイン
作成したPython関数を発行するにはAzureにサインインが必要になります。
Azureのアカウントにサインインすると、サイドバーにアカウントとサブスクリプションが表示されます。
Azureに作成したコードをデプロイ
Azure上に作成したPython関数をデプロイします。
下記画像の赤枠部分をクリックします。
- アカウントにサインインしていると、サブスクリプションが表示されます。
今回使用するサブスクリプションを選択します。
- デプロイ名を決めます。
- 使用するランタイムを決めます。
今回はPython3.8を使用します。
- 作成したPython関数をデプロイするリージョンを決めます。
基本的に一番近いリージョンを選択するので今回は東日本を選択します。
- デプロイが完了するとサイドバーに表示されるようになります。
関数の実行
作成した関数を F5 キーで呼び出し / 実行→デバック をクリックすると、
ターミナル画面に関数の実行が表示されます。
|
1 2 |
HttpTrigger3: [GET,POST] http://localhost:7071/api/HttpTrigger3 |
URLがターミナルに表示されます。
URLを開いて以下の画面が表示されたら成功です！
Azure上で作成したPython関数が登録されているかチェック
Azure portal上でコードが登録されているかチェックします。
Azure portalにログインし、関数アプリをクリック
登録されていると以下の画面が表示されます。
さいごに
今回VSCodeのAzure Functions拡張機能を使ってみて、簡単に関数が実行できました。
サーバの構築や保守管理なしでコードのビルド・デバッグ・デプロイができるのは楽ですね。
自動スケーリングや決まった時間にコードを処理するバッチ処理の機能なども備わっているので効率よく開発できるのが、プログラマー的に便利だなと思いました。
参考HP
Azure公式ドキュメント
https://docs.microsoft.com/ja-jp/azure/azure-functions/create-first-function-vs-code-python
