CDKでPython Lambda Layerを追加する方法をまとめてみた

 cdk-lambda-python-layer/
  ├── cdk/
  │   ├── lib/cdk-lambda-python-layer-stack.ts 
  │   ├── package.json
  │   └── cdk.json
  │      .
  │      .
  │      .
  └── src/lambda/
      ├── functions/main.py # Lambda mainハンドラー
      └── layers/ 
          ├── requirements.txt # ライブラリ記載
          └── python/
              ├── myutils/__init__.py # 自作Utilsパッケージ
              └── lib/python3.13/site-packages/ #　事前にパッケージ追加
                  ├── _cffi_backend.cpython-312-darwin.so
                  ├── cffi/
                  ├── cffi-1.17.1.dist-info/
                  ├── cryptography/
                  ├── cryptography-45.0.5.dist-info/
                  ├── pycparser/
                  └── pycparser-2.22.dist-info/

/opt/python/
/opt/python/lib/python3.x/site-packages/

# レイヤー用フォルダ構成例
src/lambda/layers/
└── python/  # ← この「python」フォルダが /opt/python として配置される
    ├── myutils/          # 自作パッケージ
    │   └── __init__.py
    └── lib/python3.13/site-packages/  # pip/poetryライブラリ
        ├── _cffi_backend.cpython-312-darwin.so
        ├── cffi/
        ├── cffi-1.17.1.dist-info/
        ├── cryptography/
        ├── cryptography-45.0.5.dist-info/
        ├── pycparser/
        └── pycparser-2.22.dist-info/

// ファイル: cdk/lib/cdk-lambda-python-layer-stack.ts
// AWS公式のPandasレイヤーを参照
const awsOfficialLayers: lambda.ILayerVersion[] = [
  lambda.LayerVersion.fromLayerVersionArn(this, 'PandasLayer', 
    'arn:aws:lambda:ap-northeast-1:************:layer:AWSSDKPandas-Python313:3'
  )
];

// Lambda関数で使用
const lambdaFunction = new lambda.Function(this, 'MainLambdaFunction', {
    functionName: 'cdk-lambda-python-layer-demo',
    runtime: lambda.Runtime.PYTHON_3_13,
    handler: 'main.lambda_handler',
    code: lambda.Code.fromAsset(path.join(__dirname, '../../src/lambda/functions')),
    layers: awsOfficialLayers,
    architecture: lambda.Architecture.X86_64,
});

// ファイル: cdk/lib/cdk-lambda-python-layer-stack.ts
// requirements.txtが配置してあるパスを参照
const requirementsPath = path.join(__dirname, '../../src/lambda/layers/python');

const requirementsLayer = new lambda.LayerVersion(this, 'RequirementsLayer', {
    code: lambda.Code.fromAsset(requirementsPath, {
        bundling: {
            image: lambda.Runtime.PYTHON_3_13.bundlingImage, // Python 3.13のイメージを使用
            command: [
                'bash', '-c',
                'pip install -r requirements.txt -t /asset-output/python/' // CDKが/asset-outputをzip化してアップロードしてくれるため
            ],
        },
    }),
    compatibleRuntimes: [lambda.Runtime.PYTHON_3_13],
    compatibleArchitectures: [lambda.Architecture.X86_64],
});

// ファイル: cdk/lib/cdk-lambda-python-layer-stack.ts
import { PythonLayerVersion } from '@aws-cdk/aws-lambda-python-alpha';

const layersPath = path.join(__dirname, '../../src/lambda/layers');

const pythonAlphaLayer = new PythonLayerVersion(this, 'PythonAlphaLayer', {
    entry: layersPath,
    compatibleRuntimes: [lambda.Runtime.PYTHON_3_13],
    compatibleArchitectures: [lambda.Architecture.X86_64]
});

// ファイル: cdk/lib/cdk-lambda-python-layer-stack.ts
const preBuiltLayerPath = path.join(__dirname, '../../src/lambda/layers');

const preBuiltLayer = new lambda.LayerVersion(this, 'PreBuiltLayer', {
    code: lambda.Code.fromAsset(preBuiltLayerPath),
    compatibleRuntimes: [lambda.Runtime.PYTHON_3_13],
    compatibleArchitectures: [lambda.Architecture.X86_64]
});

# ファイル: src/lambda/layers/python/myutils/__init__.py
def add(a, b):
    return a + b

# src/lambda/layers/python/lib/python3.13/site-packages/ 内の構造
# Mac OS (Darwin)でインストールされたcryptographyの例
.
├── _cffi_backend.cpython-312-darwin.so  # ← darwin.so (Mac OS用)
├── cffi
├── cffi-1.17.1.dist-info
├── cryptography
├── cryptography-45.0.5.dist-info
├── pycparser
└── pycparser-2.22.dist-info

# ファイル: docker/Dockerfile
# Amazon Linux 2023でPython 3.13をインストール
FROM amazonlinux:2023

# Python 3とzipをインストール
RUN dnf update -y && \
    dnf install -y python3 python3-pip zip && \
    dnf clean all

# 作業ディレクトリを設定
WORKDIR /tmp

# pythonディレクトリを作成してパッケージをインストール
RUN mkdir -p python && \
    python3 -m pip install psutil -t python/ --no-cache-dir

# layer.zipを作成して権限設定
RUN zip -r layer.zip python/ && chmod 644 layer.zip

# /outputディレクトリを事前作成して権限設定
RUN mkdir -p /output && chmod 644 /output

# layer.zipをコピー
CMD ["sh", "-c", "cp layer.zip /output/"]

# ローカルでビルド実行(linux x86_64環境に合わせる)
cd docker
docker build --platform linux/amd64 -t lambda-layer-builder .
docker run --rm -v $(pwd)/output:/output lambda-layer-builder

// ファイル: cdk/lib/cdk-lambda-python-layer-stack.ts
const dockerLayerPath = path.join(__dirname, '../../docker/output');

const dockerBuiltLayer = new lambda.LayerVersion(this, 'DockerBuiltLayer', {
    code: lambda.Code.fromAsset(dockerLayerPath),
    compatibleRuntimes: [lambda.Runtime.PYTHON_3_13],
    compatibleArchitectures: [lambda.Architecture.X86_64],
});