[アップデート] AWS SAM CLI でも customer-managed runtimes を使えるようになったので、awk でカスタムランタイムを作ってみた

[アップデート] AWS SAM CLI でも customer-managed runtimes を使えるようになったので、awk でカスタムランタイムを作ってみた

SAM CLIも対応
2026.11.21

いわさです。

先日のアップデートで AWS Lambda で customer-managed runtimes (CMR)が使えるようになりました。

https://dev.classmethod.jp/articles/lambda-customer-managed-runtimes-bash-runtime/

これを使うと自分で作ったランタイムを用意し、Lambda 関数で使い回すことができます。
ややこしいのですが従来存在していた Lambda カスタムランタイムとはまたちょっと違う機能です。

AWS SAM CLI v1.174.0 で、SAM CLI でも CMR をサポートしました。

https://github.com/aws/aws-sam-cli/releases/tag/v1.174.0

SAM のテンプレートから、このランタイムを指定ですることができるようになってます。
今回こちらを使ってみたので紹介します。

実際に確認してみる

何でも良かったのですが、今回は awk でランタイムを用意しました。
まずは、ランタイムのイメージを作成しましょう。実体は Docker コンテナです。Lambda のベースイメージ(Amazon Linux 2023)に、起動用のシェルスクリプトと、awk のイベント処理を実装します。

FROM public.ecr.aws/lambda/provided:al2023

COPY src/bootstrap.sh /usr/local/bin/awk-bootstrap
COPY src/handler.awk /var/task/handler.awk

RUN chmod 755 /usr/local/bin/awk-bootstrap

ENTRYPOINT ["/usr/local/bin/awk-bootstrap"]

コードでは Lambda Runtime API を使ってイベントを取得し、適当な JSON 文字列を出力します。

BEGIN { RS = "\001" }
{
  name = "world"
  if (match($0, /"name"[ \t]*:[ \t]*"[^"]*"/)) {
    s = substr($0, RSTART, RLENGTH)
    sub(/^"name"[ \t]*:[ \t]*"/, "", s)
    sub(/"$/, "", s)
    name = s
  }
  rev = ""
  n = length(name)
  for (i = n; i >= 1; i--) rev = rev substr(name, i, 1)
  printf "{\"greeting\":\"hello, %s (from awk)\",\"reversed\":\"%s\",\"length\":%d,\"runtime\":\"awk\"}\n", name, rev, n
}

イメージは ECR にプッシュして、Lambda カスタムランタイムを作成しておきます。

17442C51-7547-4331-9C45-935B32324000.png

0F9BDF28-33DA-46EA-A890-33B3B2EDE2CD.png

このあたりの手順は冒頭の亮さんの記事を見てください。

でここからメインの SAM テンプレート側です。
AWS::Serverless::Function にて Runtime: custom を指定し、RuntimeConfig に RuntimeArn と RuntimeAlias を指定する感じです。

AwkFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: handler.awk
    Runtime: custom
    CodeUri: src/
    Timeout: 30
    Architectures:
      - arm64
    RuntimeConfig:
      RuntimeArn: arn:aws:lambda:ap-northeast-1:123456789012:runtime/hoge-awk-runtime-0120
      RuntimeAlias: live

まずはローカルでsam local invokeを試してみます。

sam local invoke AwkFunction -t template.yaml -e event.json
{"greeting": "hello, iwasa (from awk)", "reversed": "asawi", "length": 5, "runtime": "awk"}

動いてますね!いいね。
ちなみに RuntimeAlias は必須みたいで、存在しないエイリアスを指定すると、当然エラーになりました。

Error: Runtime arn:aws:lambda:ap-northeast-1:123456789012:runtime/hoge-awk-runtime-0120 alias hoge was not found: Runtime Alias not found

ちなみにsam build は失敗しました。

Error: Runtime 'custom' requires Metadata.BuildMethod to select a build workflow (e.g. python3.12, nodejs20.x, makefile)

ただsam deploy はいけます。問題なく成功し、コンソールでも関数が確認できました。

1E05897D-78F2-4E45-BB2E-24A69D7D7E9D.png

さいごに

本日は AWS SAM CLI でも customer-managed runtimes を使えるようになったので、awk でカスタムランタイムを作ってみました。
マネージドランタイムにない言語でも、ランタイムを自分で用意できるようになりましたが、早速 SAM CLI でも利用できるようになりましたね。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事