betdcplus/localstack

自定义LocalStack镜像（带Lambda层自动加载）

镜像概述

本镜像基于官方LocalStack构建，是一个定制化的本地AWS服务模拟环境，核心功能是从指定路径/var/task/layer自动加载用户提供的Lambda层，简化本地开发流程，无需手动配置即可测试依赖Lambda层的应用。

核心功能与特性

• LocalStack基础功能：完整模拟AWS服务本地环境，支持Lambda、S3、DynamoDB等核心服务
• Lambda层自动加载：无需手动配置，自动识别并加载/var/task/layer路径下的Lambda层
• 开发效率提升：简化本地开发流程，快速验证包含Lambda层依赖的应用逻辑

使用场景

• 本地开发依赖自定义Lambda层的AWS Lambda函数
• 测试包含多层Lambda依赖的复杂应用
• 在无网络环境下进行Lambda层相关功能调试与验证

使用方法

基本部署（docker run）

通过挂载本地Lambda层目录到容器的/var/task/layer路径启动镜像：

bash
docker run -d \
  -p 4566:4566 \  # 映射LocalStack默认API端口
  -v /本地/lambda/layer目录:/var/task/layer \  # 挂载Lambda层目录
  --name custom-localstack \
  custom-localstack:latest

参数说明

• -p 4566:4566：映射LocalStack默认端口，提供AWS兼容API接口
• -v /本地/lambda/layer目录:/var/task/layer：将本地Lambda层文件挂载到容器内指定路径，实现自动加载
• --name custom-localstack：指定容器名称，便于后续管理

验证Lambda层加载

容器启动后，可通过LocalStack CLI工具awslocal验证Lambda层是否加载成功：

bash
# 安装awslocal（需先安装AWS CLI）
pip install awscli-local

# 列出已加载的Lambda层
awslocal lambda list-layers

若配置正确，命令输出将包含从/var/task/layer路径加载的Lambda层信息。