はじめに

AWSが2025年11月にRustランタイムの公式サポートを発表しました。これにより、高速で安全なサーバーレスアプリケーションの構築が可能になりました。本記事では、AWS SAM CLIとRust Webフレームワーク「Axum」を使って、実用的なRESTful APIをゼロから構築する方法を解説します。

AWSの公式発表との違い

AWS公式ブログでは、lambda_runtimeクレートを使ったシンプルなイベント駆動型の実装が紹介されています。一方、本記事では以下のアプローチを採用しています:

観点	AWS公式ブログ	本記事
フレームワーク	`lambda_runtime` のみ	`Axum` + `lambda_http`
用途	イベント駆動型処理	RESTful API構築
ルーティング	単一ハンドラー	複数エンドポイント対応
アーキテクチャ	Function URL	Function URL (CORS設定付き)

なぜAxumを使うのか？

本格的なREST APIには複雑なルーティングが必要
ミドルウェア、バリデーション、エラーハンドリングを統合的に管理可能
型安全なルーティングで開発効率が向上

なぜRustをLambdaで使うのか？

主なメリット

超高速起動: コールドスタートが他言語より圧倒的に速い
低メモリ消費: メモリ使用量が少なくコスト削減に直結
型安全性: コンパイル時にバグを検出
ゼロコスト抽象化: パフォーマンスを犠牲にしない高度な抽象化

アーキテクチャ概要

┌─────────┐      ┌──────────────────┐      ┌──────────────┐
│ Client  │─────▶│ Lambda Function  │─────▶│   Response   │
│         │      │  URL (CORS)      │      │   JSON       │
└─────────┘      └──────────────────┘      └──────────────┘
                          │
                          ▼
                 ┌─────────────────┐
                 │  Axum Router    │
                 ├─────────────────┤
                 │ GET  /          │
                 │ GET  /health    │
                 │ GET  /users     │
                 │ GET  /users/:id │
                 │ POST /users     │
                 └─────────────────┘

技術スタック

Runtime: provided.al2023 (カスタムランタイム)
Webフレームワーク: Axum 0.7
Lambda統合: lambda_http
ビルドツール: SAM CLI + cargo-lambda
クロスコンパイル: Zig
非同期処理: Tokio

開発環境のセットアップ

前提条件

# 必要なツール
- Rust 1.88以上
- AWS SAM CLI
- Docker Desktop (ローカルテスト用)
- Zig (クロスコンパイル用)

1. Rustのインストールとバージョン確認

# 現在のバージョン確認
rustc --version

# Rust 1.88以上が必要
rustup update stable

重要: cargo-lambdaはRust 1.88+を要求します。古いバージョンでは以下のエラーが発生します:

rustc 1.87.0 is not supported by the following packages:
  aws-sdk-lambda@1.104.0 requires rustc 1.88.0

2. cargo-lambdaのインストール

cargo install cargo-lambda

# インストール確認
cargo lambda --version
# 出力例: cargo-lambda 1.8.6

3. Zigのインストール

cargo-lambdaはx86_64向けのクロスコンパイルにZigを使用します。

# macOS (Homebrew)
brew install zig

# 確認
zig version
# 出力例: 0.15.2

なぜZigが必要か？

Lambda環境はx86_64アーキテクチャで動作
Apple Silicon (ARM64)からクロスコンパイルする際に必須
Zigはシームレスなクロスコンパイルを提供

プロジェクト構造

lambda-rust/
├── template.yaml          # SAMテンプレート（インフラ定義）
├── samconfig.toml         # SAM CLI設定
├── events/
│   └── function-url-event.json  # テストイベント、必須ではない
└── app/
    ├── Cargo.toml         # Rustプロジェクト設定
    └── src/
        └── main.rs        # Axum APIハンドラー実装

実装ガイド

1. SAMテンプレートの設定

template.yaml設定:

Resources:
  AxumApiFunction:
    Type: AWS::Serverless::Function
    Metadata:
      BuildMethod: rust-cargolambda  # cargo-lambdaを使用
    Properties:
      CodeUri: ./app
      Handler: bootstrap              # cargo-lambda生成のバイナリ名
      Runtime: provided.al2023        # カスタムランタイム
      Architectures:
        - x86_64
      FunctionUrlConfig:              # Function URL設定
        AuthType: NONE
        Cors:
          AllowOrigins:
            - "*"
          AllowMethods:
            - GET
            - POST
            - PUT
            - DELETE
          AllowHeaders:
            - "*"
          MaxAge: 300

2. 依存関係の設定

Cargo.toml:

[package]
name = "rust-lambda-axum"
version = "0.1.0"
edition = "2021"

[dependencies]
# Axum Webフレームワーク
axum = "0.7"

# Lambda統合
lambda_http = "0.13"

# 非同期ランタイム
tokio = { version = "1", features = ["macros"] }

# JSONシリアライゼーション
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"

# ログ
tracing = { version = "0.1", features = ["log"] }
tracing-subscriber = { version = "0.3", default-features = false, features = ["fmt"] }

# HTTP utilities
tower = "0.5"

3. 最小構成のRust Lambda実装

src/main.rsのサンプルコード:

use axum::{
    extract::Path,
    routing::get,
    Json, Router,
};
use lambda_http::{run, Error};
use serde::Serialize;

#[derive(Serialize)]
struct Message {
    message: String,
}

#[derive(Serialize)]
struct User {
    id: String,
    name: String,
}

// GET /
async fn hello() -> &'static str {
    "Hello from Rust Lambda!"
}

// GET /health
async fn health() -> Json<Message> {
    Json(Message {
        message: "OK".to_string(),
    })
}

// GET /users/:id
async fn get_user(Path(id): Path<String>) -> Json<User> {
    Json(User {
        id,
        name: "Sample User".to_string(),
    })
}

#[tokio::main]
async fn main() -> Result<(), Error> {
    // ルーター構築
    let app = Router::new()
        .route("/", get(hello))
        .route("/health", get(health))
        .route("/users/:id", get(get_user));

    // Lambda環境で実行（これだけでLambda化！）
    run(app).await
}

ビルドとテスト

ローカルビルド

# 初回は--beta-featuresフラグが必要
sam build --beta-features

# 2回目以降
sam build

ビルドプロセス:

cargo-lambdaがx86_64バイナリをクロスコンパイル
bootstrapという名前の実行ファイルを生成
SAMがデプロイパッケージを作成

ローカルテスト

方法1: イベント駆動テスト

sam local invoke AxumApiFunction --event events/function-url-event.json

出力例:

{
  "statusCode": 200,
  "body": "{\"success\":true,\"message\":\"Rust Lambda with Axum!\",\"data\":null}"
}

方法2: カスタムテストスクリプト

events/function-url-event.jsonの例:

{
  "version": "2.0",
  "routeKey": "$default",
  "rawPath": "/users",
  "rawQueryString": "page=1&limit=10",
  "headers": {
    "accept": "application/json"
  },
  "requestContext": {
    "http": {
      "method": "GET",
      "path": "/users",
      "protocol": "HTTP/1.1"
    }
  },
  "isBase64Encoded": false
}

デプロイ

初回デプロイ

sam deploy --guided

対話的に設定:

Stack Name [rust-lambda]: rust-lambda-api
AWS Region [ap-northeast-1]: ap-northeast-1
Confirm changes before deploy [Y/n]: Y
Allow SAM CLI IAM role creation [Y/n]: Y
Disable rollback [y/N]: N
Save arguments to configuration file [Y/n]: Y

2回目以降

# samconfig.tomlの設定を使用
sam deploy

デプロイ完了後の確認

# スタック出力を確認
aws cloudformation describe-stacks \
  --stack-name rust-lambda-api \
  --query 'Stacks[0].Outputs'

出力例:

[
  {
    "OutputKey": "AxumFunctionUrl",
    "OutputValue": "https://abcd1234.lambda-url.ap-northeast-1.on.aws/"
  }
]

API動作確認

デプロイしたAPIを実際にテストします：

# Function URLを環境変数に設定
FUNCTION_URL="https://abcd1234.lambda-url.ap-northeast-1.on.aws"

# ルートエンドポイント
curl $FUNCTION_URL/
# 出力: Hello from Rust Lambda!

# ヘルスチェック
curl $FUNCTION_URL/health
# 出力: {"message":"OK"}

# 特定ユーザー取得（パスパラメータ）
curl $FUNCTION_URL/users/123
# 出力: {"id":"123","name":"Sample User"}

実際のレスポンス時間:

初回リクエスト（コールドスタート）: 約120ms
2回目以降（ウォームスタート）: 約5-10ms

パフォーマンス実測値

実際の環境での測定結果:

メトリクス	初回実行 (コールドスタート)	2回目以降 (ウォーム)
レイテンシ	150-200ms	5-15ms
メモリ使用量	22MB	20MB
実行時間	111ms	3ms

トラブルシューティング

下記は自分が遭遇した主なエラーとその解決方法です。

エラー1: Rustバージョン不足

rustc 1.87.0 is not supported

解決方法:

rustup update stable
rustc --version  # 1.88以上を確認

エラー2: Zigが見つからない

Error: Zig is not installed in your system

解決方法:

brew install zig

エラー3: cargo-lambdaが見つからない

Cannot find Cargo Lambda

解決方法:

cargo install cargo-lambda
# PATHに追加されているか確認
which cargo-lambda

エラー4: ビルドエラー

error: failed to compile `rust-lambda-axum`

確認事項:

Cargo.tomlの依存関係バージョン
template.yamlのCodeUriパス
Rustツールチェーンの更新

# 依存関係を更新
cd app
cargo update
cargo build --release

エラー5: Function URLにアクセスできない

確認事項:

デプロイが正常に完了したか
Function URLが出力されているか
CORS設定が正しいか

# スタック出力を確認
aws cloudformation describe-stacks \
  --stack-name rust-lambda-api \
  --query 'Stacks[0].Outputs[?OutputKey==`AxumFunctionUrl`].OutputValue' \
  --output text

まとめ

RustでAWS Lambdaを構築することで、以下のメリットが得られます:

高速: コールドスタートと実行速度が優秀
低コスト: メモリ効率が良くLambda料金を削減
型安全: コンパイル時にバグを検出
実用的: Axumで本格的なREST APIを構築可能

参考リンク

Discussion