AWS Lambda Managed Instances を AWS CDK で実装してみた

import * as cdk from 'aws-cdk-lib';
import * as ec2 from 'aws-cdk-lib/aws-ec2';
import * as lambda from 'aws-cdk-lib/aws-lambda';
import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';
import * as iam from 'aws-cdk-lib/aws-iam';
import * as path from 'path';
import { Construct } from 'constructs';

export class LambdaManagedInstanceStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    /**
     * VPC の作成
     * Lambda Managed Instances はVPC内でEC2インスタンスを起動するため必須
     * - maxAzs: 高可用性のため2つのAZを使用
     * - subnetConfiguration: プライベートサブネット（Lambda用）とパブリックサブネット（NAT Gateway用）を作成
     */
    const vpc = new ec2.Vpc(this, 'LambdaVpc', {
      maxAzs: 2,
      natGateways: 1,
      subnetConfiguration: [
        {
          cidrMask: 24,
          name: 'Private',
          subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS,
        },
        {
          cidrMask: 24,
          name: 'Public',
          subnetType: ec2.SubnetType.PUBLIC,
        },
      ],
    });

    /**
     * Security Group の作成
     * Capacity Providerが起動するEC2インスタンスに適用されるセキュリティグループ
     * - すべてのアウトバウンド通信を許可
     */
    const securityGroup = new ec2.SecurityGroup(this, 'LambdaSecurityGroup', {
      vpc,
      description: 'Security group for Lambda Managed Instance',
      allowAllOutbound: true,
    });

    /**
     * Capacity Provider の作成
     * Lambda関数を実行するEC2インスタンスのプールを管理
     * - subnets:（プライベートサブネットを使用）
     * - architectures: ARM64（Graviton4）を使用。
     * - instanceTypeFilter: m8g.large（Graviton4ベース）を指定。
     */
    const capacityProvider = new lambda.CapacityProvider(this, 'MyCapacityProvider', {
      capacityProviderName: 'my-lambda-capacity-provider',
      subnets: vpc.selectSubnets({
        subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS,
      }).subnets,
      securityGroups: [securityGroup],

      /**
       * アーキテクチャの指定
       * ARM64（Graviton4）を使用
       * Lambda関数のアーキテクチャと一致させる必要がある
       * インスタンスタイプを指定する場合は必須
       */
      architectures: [lambda.Architecture.ARM_64],

      /**
       * インスタンスタイプの指定（オプション）
       * m8g.large: Graviton4ベースのインスタンス
       */
      instanceTypeFilter: lambda.InstanceTypeFilter.allow([
        ec2.InstanceType.of(ec2.InstanceClass.M8G, ec2.InstanceSize.LARGE),
      ]),

      /**
       * スケーリング設定（オプション）
       * マニュアルモードでCPU使用率70%を目標にスケーリング
       * - 目標値を下回ると自動的にインスタンスを削減
       * - 目標値を上回ると自動的にインスタンスを追加
       */
      scalingOptions: lambda.ScalingOptions.manual([
        lambda.TargetTrackingScalingPolicy.cpuUtilization(70),
      ]),
    });

    /**
     * Lambda実行用のIAMロールを作成
     * VPC内でLambda関数を実行するために必要な権限を付与
     * - AWSLambdaBasicExecutionRole: CloudWatch Logsへの書き込み権限
     * - AWSLambdaVPCAccessExecutionRole: VPC内でのネットワークインターフェース管理権限
     */
    const lambdaRole = new iam.Role(this, 'LambdaExecutionRole', {
      assumedBy: new iam.ServicePrincipal('lambda.amazonaws.com'),
      managedPolicies: [
        iam.ManagedPolicy.fromAwsManagedPolicyName('service-role/AWSLambdaBasicExecutionRole'),
        iam.ManagedPolicy.fromAwsManagedPolicyName('service-role/AWSLambdaVPCAccessExecutionRole'),
      ],
    });

    /**
     * Lambda 関数の作成
     */
    const managedInstanceFunction = new NodejsFunction(this, 'ManagedInstanceFunction', {
      entry: path.join(__dirname, '../lambda/index.ts'),
      handler: 'handler',
      runtime: lambda.Runtime.NODEJS_22_X,
      architecture: lambda.Architecture.ARM_64, // Capacity Providerと一致させる
      role: lambdaRole,
      timeout: cdk.Duration.seconds(10),
      memorySize: 2048, // Lambda Managed Instances では 2048MB 以上が必須
    });

    /**
     * Capacity Providerに関数を追加
     * この操作により、Lambda関数がCapacity Provider上で実行されるようになる
     */
    capacityProvider.addFunction(managedInstanceFunction);
  }
}

| CREATE_FAILED        | AWS::Lambda::Function                 | ManagedInstanceFunctionB21AD5EF
Resource handler returned message: "'MemorySize' value failed to satisfy constraint: Lambda Managed Instance functions must have memory size greater than or equal to 2048 (Service: Lambda, Status Code: 400, Request ID: cc865e2c-55cf-4817-b435-b7f144d9db8d) (SDK Attempt Count: 1)" (RequestToken: a8dcb03e-5954-c5fb-2f9a-3eaebdcfdae4, HandlerErrorCode: InvalidRequest)

'MemorySize' value failed to satisfy constraint: Lambda Managed Instance functions must have memory size greater than or equal to 2048

const managedInstanceFunction = new NodejsFunction(this, 'ManagedInstanceFunction', {
  memorySize: 2048, // メモリサイズを 2048 以上を指定
});