クイック スタート: Visual Studio Code を使用して関数コードの作成と Azure へのデプロイを行う

Visual Studio Code を使って、HTTP 要求に応答する関数をテンプレートから作成します。 GitHub Copilot を使って、生成された関数コードを改善し、コードの更新をローカル環境で検証してから、Azure Functions のサーバーレス Flex 従量課金ホスティング プランにデプロイします。

このクイックスタートを完了すると、ご利用の Azure アカウントでわずかな (数セント未満の) コストが発生します。

記事の先頭で、お使いの開発言語を選んでください。

[前提条件]

• アクティブなサブスクリプションを持つ Azure アカウント。 無料でアカウントを作成できます。

• Visual Studio Code を 対応プラットフォーム のいずれかで使用する。

• Visual Studio Code 用 Azure Functions 拡張機能。

Core Tools のインストールまたは更新

Visual Studio Code の Azure Functions 拡張機能は、Azure Functions Core Tools と統合されているため、Azure Functions ランタイムを使用して Visual Studio Code でローカルで関数を実行およびデバッグできます。 作業を開始する前に、Core Tools をローカルにインストールするか、最新バージョンを使用するように既存のインストールを更新することをお勧めします。

Visual Studio Code で F1 キーを押してコマンド パレットを開き、Azure Functions: Core Tools のインストールまたは更新コマンドを検索して実行します。

このコマンドは、最新バージョンの Core Tools のパッケージ ベースのインストールを開始するか、既存のパッケージ ベースのインストールを更新しようとします。 ローカル コンピューターに npm または Homebrew がインストールされていない場合は、代わりに Core Tools を手動でインストールまたは更新する必要があります。

ローカル プロジェクトを作成する

このセクションでは、Visual Studio Code を使って、好みの言語でローカル Azure Functions プロジェクトを作成します。 この記事ではこの後、関数コードの更新、実行、Azure への発行を行います。

1. Visual Studio Code で F1 キーを押してコマンド パレットを開き、コマンド Azure Functions: Create New Project... を検索して実行します。

2. プロジェクト ワークスペースのディレクトリの場所を選択し、[選択] を選択します。 新しいフォルダーを作成するか、プロジェクト ワークスペースの空のフォルダーを選択する必要があります。 ワークスペースに最初から含まれているプロジェクト フォルダーは選択しないでください。

3. プロンプトで、次の情報を入力します。

   Prompt	[選択]
   Select a language (言語を指定してください)	[C#] を選択します。
   Select a .NET runtime (.NET ランタイムを選択してください)	[.NET 8.0 LTS] を選択します。
   プロジェクトの最初の関数のテンプレートを選択します	[HTTP trigger] を選択します。
   関数に名前を指定します	「HttpExample」と入力します。
   名前空間を指定する	「My.Functions」と入力します。
   承認レベル	Anonymous を選択します。この場合、すべてのユーザーが関数のエンドポイントを呼び出すことができます。 詳細については、「認可レベル」を参照してください。
   プロジェクトを開く方法を選択してください	[Open in current window] を選択します。

   Prompt	[選択]
   Select a language (言語を指定してください)	[Java] を選択します。
   Select a version of Java (Java のバージョンを選択してください)	Azure における関数の実行環境 (Java バージョン) として Java 8、Java 11、Java 17、または Java 21 を選択します。 ローカルで確認済みの Java バージョンを選択してください。
   Provide a group ID (グループ ID を指定してください)	[com.function] を選択します。
   Provide an artifact ID (成果物 ID を指定してください)	[myFunction] を選択します。
   Provide a version (バージョンを指定してください)	[1.0-SNAPSHOT] を選択します。
   Provide a package name (パッケージ名を指定してください)	[com.function] を選択します。
   Provide an app name (アプリ名を指定してください)	[myFunction-12345] を選択します。
   プロジェクトの最初の関数のテンプレートを選択します	[HTTP trigger] を選択します。
   Select the build tool for Java project (Java プロジェクトのビルド ツールを選択してください)	[Maven] を選択します。
   プロジェクトを開く方法を選択してください	[Open in current window] を選択します。

   Prompt	[選択]
   Select a language (言語を指定してください)	[JavaScript] を選択します。
   JavaScript プログラミング モデルを選択する	[Model V4] を選択します。
   プロジェクトの最初の関数のテンプレートを選択します	[HTTP trigger] を選択します。
   関数に名前を指定します	「HttpExample」と入力します。
   承認レベル	Anonymous を選択します。この場合、すべてのユーザーが関数のエンドポイントを呼び出すことができます。 詳細については、「認可レベル」を参照してください。
   プロジェクトを開く方法を選択してください	[Open in current window] を選択します。

   Prompt	[選択]
   Select a language (言語を指定してください)	[TypeScript] を選択します。
   JavaScript プログラミング モデルを選択する	[Model V4] を選択します。
   プロジェクトの最初の関数のテンプレートを選択します	[HTTP trigger] を選択します。
   関数に名前を指定します	「HttpExample」と入力します。
   承認レベル	Anonymous を選択します。この場合、すべてのユーザーが関数のエンドポイントを呼び出すことができます。 詳細については、「認可レベル」を参照してください。
   プロジェクトを開く方法を選択してください	[Open in current window] を選択します。

   Prompt	[選択]
   Select a language (言語を指定してください)	[Python] を選択します。
   仮想環境を作成する Python インタープリターを選択する	任意の Python インタープリターを選択します。 オプションが表示されない場合は、Python バイナリの完全パスを入力してください。
   プロジェクトの最初の関数のテンプレートを選択します	[HTTP trigger] を選択します。
   作成する関数の名前	「HttpExample」と入力します。
   承認レベル	ANONYMOUS を選択します。この場合、すべてのユーザーが関数のエンドポイントを呼び出すことができます。 詳細については、「認可レベル」を参照してください。
   プロジェクトを開く方法を選択してください	[Open in current window] を選択します。

   Prompt	[選択]
   Select a language for your function project (関数プロジェクトの言語を選択してください)	[PowerShell] を選択します。
   プロジェクトの最初の関数のテンプレートを選択します	[HTTP trigger] を選択します。
   関数に名前を指定します	「HttpExample」と入力します。
   承認レベル	Anonymous を選択します。この場合、すべてのユーザーが関数のエンドポイントを呼び出すことができます。 詳細については、「認可レベル」を参照してください。
   プロジェクトを開く方法を選択してください	[Open in current window] を選択します。

   Visual Studio Code は、この情報を使って、Azure Functions 用のコード プロジェクトと HTTP トリガー関数エンドポイントを生成します。 ローカル プロジェクト ファイルは、エクスプローラーで表示できます。 作成されるファイルの詳細については、「生成されるプロジェクト ファイル」を参照してください。

関数をローカルで実行する

Visual Studio Code を Azure Functions Core Tools と統合することで、このプロジェクトをローカルの開発用コンピューター上で実行してから、Azure に発行することができます。

1. 関数をローカルで開始するには、F5 キーまたは、左側のアクティビティ バーの [実行とデバッグ] アイコンを押します。 ターミナル パネルに、Core Tools からの出力が表示されます。 [ ターミナル ] パネルでアプリが起動します。 HTTP によってトリガーされる関数の URL エンドポイントがローカルで実行されていることを確認できます。

   

   Windows での実行に問題がある場合、Visual Studio Code の既定のターミナルが WSL Bash に設定されていないことをご確認ください。

2. Core Tools がターミナルでまだ実行されている状態で、アクティビティ バーの Azure アイコンを選択します。 [ワークスペース] 領域で、[ローカル プロジェクト]>[関数] を展開します。 新しい関数を右クリック (Windows) または Ctrl キーを押しながらクリック (macOS) して、[Execute Function Now] (今すぐ関数を実行) を選択します。

   

3. Enter 要求本文に、{ "name": "Azure" }の要求メッセージ本文の値が表示されます。 Enter キーを押して、この要求メッセージを関数に送信します。

4. ローカルで関数を実行し、応答が返されると、Visual Studio Code で通知が発生します。 関数の実行に関する情報が ターミナル パネルに表示されます。

5. [ターミナル] パネルにフォーカスがある状態で、Ctrl + C キーを押して Core Tools を停止し、デバッガーの接続を解除します。

関数がローカル コンピューターで正しく動作することを確認した後、必要に応じて、Visual Studio Code の GitHub Copilot などの AI ツールを使って、テンプレートで生成された関数コードを更新できます。

AI を使用して入力を正規化および検証する

これは、クエリ文字列または JSON 本文からパラメーターを取得するように既存の関数コードを更新し、書式設定または型変換を適用し、それらを応答で JSON として返す、Copilot Chat に対するプロンプトの例です。

Modify the function to accept name, email, and age from the JSON body of the
request. If any of these parameters are missing from the query string, read
them from the JSON body. Return all three parameters in the JSON response, 
applying these rules:
Title-case the name
Lowercase the email
Convert age to an integer if possible, otherwise return "not provided"
Use sensible defaults if any parameter is missing
Make sure that any added packages are compatible with the version of the packages already in the project

Modify the function to accept name, email, and age from the JSON body of the
request. If any of these parameters are missing from the query string, read
them from the JSON body. Return all three parameters in the JSON response, 
applying these rules:
Title-case the name
Lowercase the email
Convert age to an integer if possible, otherwise return "not provided"
Use sensible defaults if any parameter is missing

Modify the function to accept name, email, and age from the JSON body of the
request. If any of these parameters are missing from the query string, read
them from the JSON body. Return all three parameters in the JSON response, 
applying these rules:
Title-case the name
Lowercase the email
Convert age to an integer if possible, otherwise return "not provided"
Use sensible defaults if any parameter is missing
Update the FunctionTest.java file to test the new logic. 

必要に応じてプロンプトをカスタマイズして詳細を追加してから、アプリをもう一度ローカル環境で実行し、コードの変更後に期待どおりに動作することを確認できます。 今回は、次のようなメッセージ本文を使います。

{ "name": "devon torres", "email": "torres.devon@contoso.com", "age": "34" }

アプリに問題がなければ、Visual Studio Code を使用してプロジェクトを Azure に直接発行できます。

Azure にサインインする

Azure リソースを作成したり、アプリを発行したりする前に、Azure にサインインする必要があります。

1. まだサインインしていない場合は、アクティビティ バーの Azure アイコンを選択します。 その後、[リソース] で [Azure にサインイン] を選択します。

   

   既にサインインしていて、既存のサブスクリプションを確認できる場合は、次のセクションに進みます。 Azure アカウントをお持ちでない場合は、[Azure アカウントの作成] を選択します。 学生は、[Microsoft Azure for Students アカウントの作成] を選択できます。

2. ブラウザーでプロンプトが表示されたら、ご利用の Azure アカウントを選択し、その Azure アカウントの資格情報を使用してサインインします。 新しいアカウントを作成した場合は、アカウントの作成後にサインインできます。

3. 正常にサインインしたら、新しいブラウザー ウィンドウを閉じてかまいません。 ご利用の Azure アカウントに属しているサブスクリプションがサイド バーに表示されます。

Azure に関数アプリを作成する

このセクションでは、Flex Consumption プランで、Azure サブスクリプションの関連リソースと共に関数アプリを作成します。 リソース作成に関する決定の多くは、既定の動作に基づいて自動的に行われます。 作成されたリソースをより細かく制御するには、代わりに高度なオプションを使って関数アプリを作成する必要があります。

1. Visual Studio Code で、F1 キーを選択してコマンド パレットを開きます。 プロンプト (>) で、入力して [Azure Functions: Azure で関数アプリを作成する] を選択します。

2. プロンプトで、次の情報を指定します。

   Prompt	アクション
   サブスクリプションを選択してください	使用する Azure サブスクリプションを選択します。 [リソース] に表示されるサブスクリプションが 1 つだけのときは、このプロンプトは表示されません。
   新しい関数アプリ名を入力する	URL パスで有効なグローバルに一意の名前を入力します。 入力した名前は、Azure Functions 内での一意性を確保するために検証されます。
   Select a ___location for new resources (新しいリソースの場所を選択してください)	Azure のリージョンを選択します。 パフォーマンスを向上させるために、お近くのリージョンを選択してください。 Flex 従量課金プランでサポートされているリージョンのみが表示されます。
   ランタイム スタックを選択してください	現在ローカルで実行している言語バージョンを選択してください。
   リソース認証の種類を選択する	既定のホスト ストレージ アカウントに接続するための最も安全なオプションであるマネージド ID を選択します。

   Azure に作成されている個々のリソースの状態が、Azure の拡張機能によって [Azure: アクティビティ ログ] パネルに表示されます。

   

3. 関数アプリが作成されると、次の関連リソースがご利用の Azure サブスクリプションに作成されます。 リソースの名前は、関数アプリに入力した名前に基づいて決まります。

   • リソース グループ。関連リソースの論理コンテナーです。
   • 関数アプリ。関数コードを実行するための環境となります。 関数アプリを使用すると、同じホスティング プランに含まれるリソースの管理、デプロイ、共有を容易にするための論理ユニットとして関数をグループ化できます。
   • Azure App Service プラン。関数アプリの基になるホストを定義します。
   • 関数アプリに関する状態やその他の情報を維持するために Functions ホストによって使用される標準 の Azure Storage アカウント。
   • 関数アプリに接続された Application Insights インスタンス。アプリ内の関数の使用を追跡します。
   • 新しい既定のホスト ストレージ アカウントの ストレージ BLOB データ共同作成者 ロールに追加されるユーザー割り当てマネージド ID。

   関数アプリが作成され、展開パッケージが適用されると、通知が表示されます。

   ヒント

   既定では、関数アプリに必要な Azure リソースが、入力した関数アプリの名前に基づいて作成されます。 既定では、関数アプリによって、同じ新しいリソース グループにリソースが作成されます。 関連付けられているリソースの名前をカスタマイズする、または既存のリソースを再利用する必要がある場合は、高度な作成オプションを使用してプロジェクトを発行します。

Azure にプロジェクトをデプロイする

1. コマンド パレットで、入力して [Azure Functions: 関数アプリにデプロイする] を選択します。

2. 作成したばかりの関数アプリを選びます。 前のデプロイの上書きを求められたら、[デプロイ] を選択して、関数コードを新しい関数アプリ リソースにデプロイします。

3. デプロイの完了後、[出力の表示] を選択すると、作成済みの Azure リソースなど、作成とデプロイの結果が表示されます。 通知を見逃した場合は、右下隅にあるベル アイコンを選択して、再度確認します。

   

Azure で関数を実行する

1. F1 キーを押してコマンド パレットを表示し、コマンド Azure Functions:Execute Function Now... を検索して実行します。 メッセージが表示されたら、ご使用のサブスクリプションを選択します。

2. 新しい関数アプリ リソースと、関数として HttpExample を選択します。

3. [要求本文を入力してください] に「{ "name": "Contoso", "email": "me@contoso.com", "age": "34" }」と入力し、Enter キーを押して、この要求メッセージを関数に送信します。

4. Azure で関数が実行されると、応答が通知領域に表示されます。 通知を展開して、応答全体を確認します。

トラブルシューティング

次の表を使って、この記事の使用時に発生する最も一般的な問題を解決してください。

リソースをクリーンアップする

この後、次の手順に進んで Azure Storage キュー バインドを関数に追加する場合、既存の作業をベースにするので、リソースはすべてそのままにしておく必要があります。

それ以外の場合は、追加コストの発生を避けるために、次の手順に従って関数アプリとその関連リソースを削除してください。

1. Visual Studio Code で、Azure アイコンを選択して Azure エクスプローラーを開きます。
2. [リソース グループ] セクションで、自分のリソース グループを見つけます。
3. そのリソース グループを右クリックして、[削除] を選択します。

Functions のコストについて詳しくは、「従量課金プランのコストの見積もり」を参照してください。

次のステップ

Visual Studio Code を使用して、HTTP によってトリガーされる単純な関数を含む関数アプリを作成しました。 次の記事では、Azure Cosmos DB または Azure Storage に接続して、その関数を拡張します。 他の Azure サービスへの接続について詳しくは、「Azure Functions の既存の関数にバインドを追加する」を参照してください。 セキュリティの詳細については、「Azure Functions のセキュリティ保護」を参照してください。