AWS SAM 实战指南：从零构建无服务器应用-优快云博客

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

serverless-application-model aws/serverless-application-model - 这是一个关于 AWS Serverless 应用模型的开源项目，包含了一些关于 AWS Serverless、云服务、Python 语言的示例和教程。适用于 AWS Serverless、云服务、Python 语言编程等场景。项目地址: https://gitcode.com/gh_mirrors/se/serverless-application-model

什么是 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 开发流程包括：

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

快速入门实践

初始化项目

使用 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

常见问题与解决方案

ImportValue 限制：
- 不支持在 RestApiId、函数 Policies 和 API StageName 属性中使用
- 解决方法：直接引用资源而非导入值
跨堆栈引用：
- 建议将紧密耦合的资源放在同一个堆栈中
- 对于松散耦合的服务，使用输出(Outputs)和导入值(ImportValue)
部署失败排查：
- 检查 CloudFormation 事件日志
- 确保 IAM 权限足够
- 验证模板语法正确性