RustでAzure Functionsを使う

触ってみたら思ったより簡単に動かすことができました。

RustはAzure Functionsでは言語としてはサポートされていませんが、
カスタムハンドラーを使用することでデプロイすることが可能です。

ほとんど公式そのままですが、手元のWindows環境で試してみました。
チュートリアルではwarpをつかっていますが、
せっかくなので最近でてきたaxumを試します。

準備

• Azure Functions Core Toolsをインストールしておきます。

プロジェクト作成

Azure Functionsのプロジェクト作成

func new HttpExample 

HttpExampleという名前で作ります。
worker runtimeはcustom
テンプレートはHttpTriggerを選択

Rustのプロジェクト作成

host.json と同じフォルダーで

cargo init --name handler

Axum

axumが動作するようにします。

Cargo.toml

[dependencies]
axum = "0.1.3"
tokio = { version = "1.10.0", features = ["full"] }

main.rs

use std::{env, net::SocketAddr};
use axum::prelude::*;

# [tokio::main]
async fn main() {

    // build our application with a single route
    let app = route("/api/HttpExample", get(|| async { "Hello, Axum!!" }));

    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,
    };

    let addr = SocketAddr::from(([127, 0, 0, 1], port));
    
    // run it with hyper on localhost:3000
    axum::Server::bind(&addr)
        .serve(app.into_make_service())
        .await
        .unwrap();
}

当然なのですが、routeがazure funtions側と揃っている必要があります。

設定ファイルの修正

host.json

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

enableForwardingHttpRequest: trueを追加します。　
これのおかげでとても楽になってます。
WindowsなのでdefaultExecutablePathはhandler.exeを指定します。

function.json

{
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",

サンプルなのでauthLevelはanonymousにしておきます。

ビルド

できた実行ファイルをプロジェクトルートにコピーしておきます。

cargo build --release
cp target/release/handler.exe .

Azureにデプロイ

customランタイムでostypeがwindowsなリソースを作っておきます
cliでやる場合はここら辺を参考に

リソースできたら、あとはpublish するだけです。

func azure functionapp publish axumtest

Windowsでも動きました。すばらしー

余談

チュートリアルどおりにすすめたところ--target=x86_64-unknown-linux-muslでビルドしており、これがハマりどころではありました。
rust-musl-builderを使わせていただくと簡単でした。
そもそもこのサンプルであればx86_64-unknown-linux-gnuでも動きました。