クイックスタート: Visual Studio Code を使用して Azure に Go または Rust の関数を作成する

[アーティクル]
08/03/2023

この記事では、HTTP 要求に応答するカスタムハンドラー関数を、Visual Studio Code を使用して作成します。コードをローカルでテストした後、Azure Functions のサーバーレス環境にデプロイします。

カスタムハンドラーを使用すると、HTTP サーバープロセスを実行することによって任意の言語またはランタイムで関数を作成できます。この記事は、Go と Rust の両方に対応しています。

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

環境を構成する

作業を開始する前に、次の要件が満たされていることを確認します。

Go
Rust

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
サポートされているプラットフォームのいずれかにインストールされた Visual Studio Code。
Visual Studio Code 用 Azure Functions 拡張機能。
Go。最新バージョンをお勧めします。 go version コマンドを使用して、現在のバージョンを確認してください。

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
サポートされているプラットフォームのいずれかにインストールされた Visual Studio Code。
Visual Studio Code 用 Azure Functions 拡張機能。
Rust ツールチェーン (rustup を使用)。 rustc --version コマンドを使用して、現在のバージョンを確認してください。

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 のパッケージベースのインストールが開始されます。

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

このセクションでは、Visual Studio Code を使用して、ローカルの Azure Functions カスタムハンドラープロジェクトを作成します。後からこの記事の中で、関数コードを Azure に発行します。

アクティビティバーの Azure アイコンを選択します。 [ワークスペース (ローカル)] 領域の + ボタンを選択して、ドロップダウンから [関数の作成] を選択します。確認を求められたら [新しいプロジェクトの作成] を選択します。
プロジェクトワークスペースのディレクトリの場所を選択し、選択を選択します。新しいフォルダーを作成するか、プロジェクトワークスペースの空のフォルダーを選択する必要があります。ワークスペースに最初から含まれているプロジェクトフォルダーは選択しないでください。

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

Prompt	[選択]
Select a language for your function project (関数プロジェクトの言語を選択してください)	`Custom Handler` を選択します。
Select a template for your project's first function (プロジェクトの最初の関数のテンプレートを選択してください)	`HTTP trigger` を選択します。
Provide a function name (関数名を指定してください)	「`HttpExample`.
承認レベル	`Anonymous` を選択します。この場合、すべてのユーザーが関数のエンドポイントを呼び出すことができます。承認レベルについては、「承認キー」を参照してください。
Select how you would like to open your project (プロジェクトを開く方法を選択してください)	`Open in current window` を選択します。

Visual Studio Code は、この情報を使用して、HTTP トリガーによる Azure Functions プロジェクトを生成します。ローカルプロジェクトファイルは、エクスプローラーで表示できます。

関数を作成してビルドする

HTTP トリガー関数は、HttpExample フォルダー内の function.json ファイルで宣言されています。この関数を完成させるには、ハンドラーを追加し、実行可能ファイルにコンパイルします。

Go
Rust

Ctrl + N (macOS の場合は Cmd + N) キーを押して新しいファイルを作成します。それを関数アプリのルート (host.json と同じフォルダー) に handler.go として保存します。

handler.go に次のコードを追加して、ファイルを保存します。これが Go のカスタムハンドラーです。

package main

import (
    "fmt"
    "log"
    "net/http"
    "os"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
    message := "This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.\n"
    name := r.URL.Query().Get("name")
    if name != "" {
        message = fmt.Sprintf("Hello, %s. This HTTP triggered function executed successfully.\n", name)
    }
    fmt.Fprint(w, message)
}

func main() {
    listenAddr := ":8080"
    if val, ok := os.LookupEnv("FUNCTIONS_CUSTOMHANDLER_PORT"); ok {
        listenAddr = ":" + val
    }
    http.HandleFunc("/api/HttpExample", helloHandler)
    log.Printf("About to listen on %s. Go to https://127.0.0.1%s/", listenAddr, listenAddr)
    log.Fatal(http.ListenAndServe(listenAddr, nil))
}

Ctrl + Shift + ` キーを押すか、 [ターミナル] メニューの [新しいターミナル] を選択して、新しい統合ターミナルを VS Code で開きます。
次のコマンドを使用してカスタムハンドラーをコンパイルします。関数アプリのルートフォルダーに、handler (Windows の場合は handler.exe) という名前の実行可能ファイルが出力されます。
```
go build handler.go
```

Ctrl + Shift + ` キーを押すか、 [ターミナル] メニューの [新しいターミナル] を選択して、新しい統合ターミナルを VS Code で開きます。
関数アプリのルート (host.json と同じフォルダー) で、handler という名前の Rust プロジェクトを初期化します。
```
cargo init --name handler
```
Cargo.toml に、このクイックスタートを完了するために必要な次の依存関係を追加します。この例では、warp Web サーバーフレームワークを使用します。
```
[dependencies]
warp = "0.3"
tokio = { version = "1", features = ["rt", "macros", "rt-multi-thread"] }
```

src/main.rs に次のコードを追加して、ファイルを保存します。これが Rust のカスタムハンドラーです。

use std::collections::HashMap;
use std::env;
use std::net::Ipv4Addr;
use warp::{http::Response, Filter};

#[tokio::main]
async fn main() {
    let example1 = warp::get()
        .and(warp::path("api"))
        .and(warp::path("HttpExample"))
        .and(warp::query::<HashMap<String, String>>())
        .map(|p: HashMap<String, String>| match p.get("name") {
            Some(name) => Response::builder().body(format!("Hello, {}. This HTTP triggered function executed successfully.", name)),
            None => Response::builder().body(String::from("This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.")),
        });

    let port_key = "FUNCTIONS_CUSTOMHANDLER_PORT";
    let port: u16 = match env::var(port_key) {
        Ok(val) => val.parse().expect("Custom Handler port is not a number!"),
        Err(_) => 3000,
    };

    warp::serve(example1).run((Ipv4Addr::LOCALHOST, port)).await
}

カスタムハンドラーのバイナリをコンパイルします。関数アプリのルートフォルダーに、handler (Windows の場合は handler.exe) という名前の実行可能ファイルが出力されます。
```
cargo build --release
cp target/release/handler .
```

関数アプリを構成する

関数のホストは、起動時にカスタムハンドラーのバイナリを実行するよう構成する必要があります。

host.json を開きます。
customHandler.description セクションで、defaultExecutablePath の値を handler に設定します (Windows の場合は handler.exe に設定します)。
customHandler セクションで、enableForwardingHttpRequest という名前のプロパティを追加し、その値を true に設定します。 HTTP トリガーのみで構成される関数の場合、この設定により、カスタムハンドラーの要求ペイロードではなく、標準的な HTTP 要求を使用できるようになるため、プログラミングが容易になります。

customHandler セクションが次の例のようになっていることを確認します。ファイルを保存します。

"customHandler": {
  "description": {
    "defaultExecutablePath": "handler",
    "workingDirectory": "",
    "arguments": []
  },
  "enableForwardingHttpRequest": true
}

この関数アプリは、カスタムハンドラーの実行可能ファイルを起動するように構成されました。

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

このプロジェクトは、Azure に発行する前に、ローカルの開発用コンピューターで実行することができます。

統合ターミナルで、Azure Functions Core Tools を使用して関数アプリを起動します。
```
func start
```
Core Tools が実行されている状態で、次の URL に移動して、?name=Functions クエリ文字列を含む GET 要求を実行します。

http://localhost:7071/api/HttpExample?name=Functions
応答が返され、ブラウザーに次のように表示されます。
要求に関する情報が [ターミナル] パネルに表示されます。
Ctrl + C キーを押して Core Tools を停止します。

関数がローカルコンピューター上で正常に動作することを確認したら、Visual Studio Code を使用してプロジェクトを直接 Azure に発行します。

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

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

既にサインインしていて、既存のサブスクリプションを確認できる場合は、次のセクションに進みます。まだ Azure アカウントがない場合は、[Azure アカウントの作成] を選択します。学生の方は [Microsoft Azure for Students アカウントの作成] を選択してください。
ブラウザーでプロンプトが表示されたら、ご利用の Azure アカウントを選択し、その Azure アカウントの資格情報を使用してサインインします。新しいアカウントを作成した場合は、アカウントの作成後にサインインできます。
正常にサインインしたら、新しいブラウザーウィンドウを閉じてかまいません。ご利用の Azure アカウントに属しているサブスクリプションがサイドバーに表示されます。

Azure 用にカスタムハンドラーをコンパイルする

このセクションでは、Linux を実行する関数アプリで Azure にプロジェクトを発行します。ほとんどの場合、バイナリは、事前にターゲットプラットフォームに合わせて再コンパイルして構成を調整してから Azure に発行する必要があります。

Go
Rust

統合ターミナルで、ハンドラーを Linux/x64 にコンパイルします。関数アプリのルートに、handler という名前のバイナリが作成されます。
- macOS
- Linux
- Windows
```
GOOS=linux GOARCH=amd64 go build handler.go
```
```
GOOS=linux GOARCH=amd64 go build handler.go
```
```
set GOOS=linux
set GOARCH=amd64
go build handler.go
```
host.json の defaultExecutablePath を handler.exe から handler に変更します。この指示により、関数アプリは Linux バイナリを実行するようになります。

.cargo/config にファイルを作成します。次の内容を追加し、ファイルを保存します。
```
[target.x86_64-unknown-linux-musl]
linker = "rust-lld"
```
統合ターミナルで、ハンドラーを Linux/x64 にコンパイルします。 handler という名前のバイナリが作成されます。それを関数アプリのルートにコピーします。
```
rustup target add x86_64-unknown-linux-musl
cargo build --release --target=x86_64-unknown-linux-musl
cp target/x86_64-unknown-linux-musl/release/handler .
```
Windows を使用している場合は、host.json の defaultExecutablePath を handler.exe から handler に変更します。この指示により、関数アプリは Linux バイナリを実行するようになります。
.funcignore ファイルに次の行を追加します。
```
target
```
これにより、target フォルダーの内容が発行されなくなります。

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

このセクションでは、Azure サブスクリプションに関数アプリと関連リソースを作成します。

アクティビティバーの Azure アイコンを選択します。次に、[リソース] 領域の + アイコンを選択し、[Azure に関数アプリを作成] オプションを選択します。

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

Prompt	[選択]
サブスクリプションを選択してください	使用するサブスクリプションを選択します。 [リソース] に表示されるサブスクリプションが 1 つだけのときは、これは表示されません。
Enter a globally unique name for the function app (関数アプリのグローバルに一意の名前を入力します)	URL パスに有効な名前を入力します。入力した名前は、Azure Functions 内での一意性を確保するために検証されます。
Select a runtime stack (ランタイムスタックを選択してください)	[Custom Handler] (カスタムハンドラー) を選択します。
Select a location for new resources (新しいリソースの場所を選択してください)	パフォーマンスを向上させるために、お近くのリージョンを選択してください。

この拡張機能は、Azure に作成されている個々のリソースの状態を [Azure: Activity Log] (Azure: アクティビティログ) パネルに表示します。

Azure リソース作成のログ

作成が完了すると、次の Azure リソースがサブスクリプションに作成されます。リソースは、関数アプリの名前に基づいて命名されます。
- リソースグループ。関連リソースの論理コンテナーです。
- Standard Azure ストレージアカウント。プロジェクトについての状態とその他の情報を保持します。
- 関数アプリ。関数コードを実行するための環境となります。関数アプリを使用すると、同じホスティングプランに含まれるリソースの管理、デプロイ、共有を容易にするための論理ユニットとして関数をグループ化できます。
- App Service プラン。関数アプリの基になるホストを定義します。
- 関数アプリに接続された Application Insights インスタンス。アプリ内の関数の使用を追跡します。
関数アプリが作成され、展開パッケージが適用されると、通知が表示されます。

ヒント

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

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

重要

既存の関数アプリにデプロイすると、Azure にあるそのアプリの内容が常に上書きされます。

Azure アクティビティの [リソース] 領域で、先ほど作成した関数アプリリソースを見つけて、リソースを右クリックし、[関数アプリにデプロイ] を選択します。
前のデプロイの上書きを求められたら、[デプロイ] を選択して、関数コードを新しい関数アプリリソースにデプロイします。
デプロイの完了後、[View Output] (出力の表示) を選択すると、作成済みの Azure リソースなど、作成とデプロイの結果が表示されます。通知を見逃した場合は、右下隅にあるベルアイコンを選択して、再度確認します。

Azure で関数を実行する

[リソース] 領域 (サイドバー内) に戻り、サブスクリプション、新しい関数アプリ、[関数] の順に展開します。 HttpExample 関数を右クリック (Windows) または Ctrl キーを押しながらクリック (macOS) して、[Execute Function Now]\(今すぐ関数を実行\) を選択します。
[Enter request body]\(要求本文を入力してください\) に、要求メッセージ本文の値として { "name": "Azure" } が表示されます。 Enter キーを押して、この要求メッセージを関数に送信します。
Azure で関数を実行し、応答が返されると、Visual Studio Code で通知が発生します。

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

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

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

Visual Studio Code で、F1 キーを押してコマンドパレットを開きます。コマンドパレットで、Azure: Open in portal を検索して選択します。
関数アプリを選択し、Enter キーを押します。その関数アプリのページが Azure portal で開きます。
[概要] タブで、 [リソースグループ] の横にある名前付きリンクを選択します。
[リソースグループ] ページで、含まれているリソースの一覧を確認し、削除するものであることを確認します。
[リソースグループの削除] を選択し、指示に従います。

削除には数分かかることがあります。実行されると、通知が数秒間表示されます。ページの上部にあるベルのアイコンを選択して、通知を表示することもできます。

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

次のステップ

Azure Functions のカスタムハンドラーについて