AWS SAM 实战指南：从零构建无服务器应用

什么是 AWS SAM

AWS Serverless Application Model (SAM) 是 AWS 提供的无服务器应用框架，它基于 CloudFormation 扩展而来，专门用于简化无服务器应用的开发和部署流程。通过 SAM，开发者可以使用简洁的 YAML 或 JSON 模板定义 Lambda 函数、API 网关等资源，而无需手动配置每个服务的细节。

核心概念解析

1. SAM 模板基础

SAM 模板是 CloudFormation 模板的扩展，主要包含以下关键部分：

• Transform 声明：必须包含 AWS::Serverless-2016-10-31 转换声明，表明这是一个 SAM 模板
• Resources 部分：定义各种无服务器资源
  • AWS::Serverless::Function：Lambda 函数
  • AWS::Serverless::Api：API 网关
  • AWS::Serverless::SimpleTable：DynamoDB 表

2. 开发工作流

典型的 SAM 开发流程包括：

1. 编写 SAM 模板
2. 打包应用代码和依赖
3. 部署到 AWS 环境
4. 测试和迭代

快速入门实践

初始化项目

使用 SAM CLI 可以快速初始化项目骨架：

sam init --runtime python3.8

这将创建一个包含基本模板和示例代码的项目结构。

编写模板示例

下面是一个典型的 SAM 模板示例：

AWSTemplateFormatVersion: '2010-09-09'
Transform: 'AWS::Serverless-2016-10-31'
Description: 我的无服务器应用

Resources:
  HelloWorldFunction:
    Type: 'AWS::Serverless::Function'
    Properties:
      CodeUri: hello_world/
      Handler: app.lambda_handler
      Runtime: python3.8
      Events:
        HelloWorld:
          Type: Api
          Properties:
            Path: /hello
            Method: get

高级部署技巧

1. 打包资源

在部署前，需要将代码包上传到 S3：

aws cloudformation package \
    --template-file template.yaml \
    --s3-bucket my-bucket \
    --output-template-file packaged-template.yaml

2. 实际部署

使用打包后的模板进行部署：

aws cloudformation deploy \
    --template-file packaged-template.yaml \
    --stack-name my-stack \
    --capabilities CAPABILITY_IAM

实用技巧与最佳实践

1. 使用内建函数

CloudFormation 提供的内建函数可以在 SAM 模板中使用：

Environment:
  Variables:
    TABLE_NAME: !Ref MyDynamoDBTable
    API_URL: !Sub "https://${MyApi}.execute-api.${AWS::Region}.amazonaws.com/Prod"

2. 参数化配置

通过参数实现环境差异化配置：

Parameters:
  StageName:
    Type: String
    Default: dev

Resources:
  MyFunction:
    Properties:
      FunctionName: !Sub "myapp-${StageName}-processor"

3. 部署策略控制

使用变更集(ChangeSet)预览部署变更：

aws cloudformation create-change-set \
    --stack-name my-stack \
    --template-body file://packaged-template.yaml \
    --change-set-name my-change-set

常见问题与解决方案

1. ImportValue 限制：

   • 不支持在 RestApiId、函数 Policies 和 API StageName 属性中使用
   • 解决方法：直接引用资源而非导入值

2. 跨堆栈引用：

   • 建议将紧密耦合的资源放在同一个堆栈中
   • 对于松散耦合的服务，使用输出(Outputs)和导入值(ImportValue)

3. 部署失败排查：

   • 检查 CloudFormation 事件日志
   • 确保 IAM 权限足够
   • 验证模板语法正确性

总结

AWS SAM 为无服务器应用开发提供了标准化的框架和工具链。通过本文介绍的内容，开发者可以快速上手 SAM 开发，并掌握进阶部署技巧。实际项目中，建议结合 CI/CD 管道实现自动化部署，并充分利用 SAM 的模板特性实现环境一致性。