用途:为全新项目或迁移场景生成 AWS SAM 工程产物,覆盖最小必需文件、构建验证与部署配置。
主要能力:新建项目时用 sam init 生成脚手架;迁移已有 Lambda 或 CloudFormation 资源时,手动创建带 Transform: AWS::Serverless-2016-10-31 的 template.yaml,并映射为 AWS::Serverless::Function 等资源;生成 samconfig.toml 配置部署默认值与分环境覆盖;添加 events/event.json 供本地调用;用 sam validate 与 sam build 校验。
使用方式:新项目执行 sam init、sam build、sam local invoke <LogicalFunctionId> -e events/event.json、sam deploy --guided。迁移项目先检查现有 handler、运行时与依赖结构,再创建模板并把现有资源映射到 SAM 资源,补充 samconfig.toml(含 stack_name、capabilities、resolve_s3 等),添加事件样例后用 sam build 校验。必需产物为 template.yaml、samconfig.toml 和 events/event.json。
适用场景:需要开始 AWS SAM 项目、迁移现有 Lambda 或 CloudFormation 资源、使用 SAM CLI 命令、配置本地测试,或创建更新 template.yaml / samconfig.toml。
限制:本地需安装 SAM CLI;创建 IAM 资源时需 CAPABILITY_IAM;容器镜像打包需 Docker;迁移项目可能需要重构 handler 路径以符合 SAM 约定;sam deploy --guided 会写入本地配置,提交前应检查。选定运行时要求为当前未弃用版本,包类型可选 Zip(默认)或 Image。