AWS CDKのLambda Pythonがuvをサポートしました
2025.07.07こんにちは。サービス開発室の武田です。
AWS CDKでLambda関数をデプロイする際、aws-lambdaモジュールを使うのが基本的な方法です。ですが、それをラップしているaws-lambda-python-alphaモジュールを使うと便利です。
aws-lambda-python-alphaを使用すると、ビルド時にLambda関数を自動的にパッケージングしてくれます。具体的には同じディレクトリにある依存関係のファイルを読み取り、Dockerを使ってパッケージを作成します。
これまで自動的に検出される依存関係ファイルは次の3種類でした。
- requirements.txt
- Pipfile.lock
- poetry.lock
今回のアップデートで、ここにuv.lockが追加されました。
前提
今回の手順を進めるにあたって、Node.js、Python、AWS CLI、uvはインストール済みとします。
$ node --version
v22.16.0
$ python -V
Python 3.13.5
$ aws --version
aws-cli/2.27.33 Python/3.13.3 Darwin/24.4.0 exe/x86_64
$ uv --version
uv 0.7.13 (62ed17b23 2025-06-12)
やってみた
それでは簡単なプロジェクトを作成して動作確認をしてみましょう。
環境構築
まず、新しいCDKプロジェクトを作成します。
mkdir test_cdk_uv && cd $_
npx cdk init app --language typescript
Python Lambdaの依存関係を追加します。2.204.0-alpha.0がuvのサポートが追加されたバージョンです。
npm install @aws-cdk/aws-lambda-python-alpha@^2.204.0-alpha.0
Lambda関数用のディレクトリを作成します。
mkdir -p lambda/hello && cd $_
このLambda関数用のpyproject.tomlを作成します。requestsを使用するために依存関係を追加しています。
[project]
name = "hello-lambda"
version = "0.1.0"
description = "Sample Lambda function with uv"
requires-python = ">=3.13"
dependencies = [
"requests>=2.32.0",
]
[tool.uv]
dev-dependencies = [
"ruff>=0.8.0",
]
依存関係をインストールする場合にはuv syncを使用しますが、今回はuv.lockが欲しいだけなのでuv lockを実行します。
uv lock
あとはLambda関数を実装します。
import json
import requests
def handler(event, context):
try:
response = requests.get("https://api.github.com/zen")
zen_message = response.text
return {
"statusCode": 200,
"body": json.dumps(
{
"message": "Hello from Lambda with uv!",
"zen": zen_message,
"event": event,
}
),
}
except Exception as e:
return {"statusCode": 500, "body": json.dumps({"error": str(e)})}
最後に、作ったLambda関数をデプロイするためにCDKのスタックを更新します。
--- a/lib/test_cdk_uv-stack.ts
+++ b/lib/test_cdk_uv-stack.ts
@@ -1,9 +1,22 @@
+import * as lambda from "@aws-cdk/aws-lambda-python-alpha";
import * as cdk from "aws-cdk-lib";
-import { Construct } from "constructs";
+import * as lambdaCore from "aws-cdk-lib/aws-lambda";
+import type { Construct } from "constructs";
export class TestCdkUvStack extends cdk.Stack {
constructor(scope: Construct, id: string, props?: cdk.StackProps) {
super(scope, id, props);
+
+ new lambda.PythonFunction(this, "HelloFunction", {
+ entry: "lambda/hello",
+ runtime: lambdaCore.Runtime.PYTHON_3_13,
+ index: "index.py",
+ handler: "handler",
+ });
}
}
デプロイして動作確認
それでは作成したCDKスタックをデプロイしましょう。初回の場合はbootstrapも忘れずに。
cd ../..
npx cdk bootstrap aws://$account_id/ap-northeast-1
npx cdk deploy --require-approval never
デプロイ時のログをよく見ていると依存関係をダウンロードしていることが確認できます。
ではデプロイが完了したら、Lambda関数を実行してみましょう。今回はAWS CLIでやってみます。
# 関数名取得
fname=$(aws lambda list-functions --query 'Functions[?contains(FunctionName, `TestCdkUvStack`)].FunctionName' --output text)
# 関数実行
aws lambda invoke \
--function-name "$fname" \
--cli-binary-format raw-in-base64-out \
/tmp/response.json > /dev/null && cat /tmp/response.json | jq
実行結果が表示されれば成功です！なおzenのメッセージは実行ごとに変わる可能性があるため、何回か実行してみてください。
{
"statusCode": 200,
"body": "{\"message\": \"Hello from Lambda with uv!\", \"zen\": \"Requests may be slow, but they are atomic.\", \"event\": {}}"
}
まとめ
これまでuvを使いたくてもCDKでサポートされていないという理由で移行できなかった方には朗報ですね！ぜひ使っていきましょう！
![Security Hub コントロール [SSM.6] Systems Manager Automation のログをCloudWatch Logsに出力する設定をAWS CDKカスタムリソースで実装してみた](https://images.ctfassets.net/ct0aopd36mqt/wp-refcat-img-cea52bc8a6ec5cad9021b38df4a08b9e/24c76ee7c1ae7aa7f9676a59c77f8702/aws-security-hub)
