Serverless 框架中的 SAM：一种思考及使用的指南-JavaScript中文网-JavaScript教程资源分享门户

前言

Serverless 架构的出现，使得开发者可以更加专注于业务逻辑的实现，而无需关注底层的基础设施细节。Serverless 框架则进一步简化了 Serverless 应用的开发和部署流程。AWS 的 Serverless Application Model (SAM) 是其中一种 Serverless 框架，本文将介绍 SAM 的基本概念、使用方法以及一些实践经验。

SAM 的基本概念

SAM 模板

SAM 模板是一个 YAML 文件，用于定义 Serverless 应用的资源和事件处理函数。一个 SAM 模板包含以下几个部分：

Transform：指定使用 SAM 的版本；
Resources：定义 Serverless 应用的资源，例如 Lambda 函数、API Gateway、DynamoDB 等；
Outputs：定义输出的资源，例如 API Gateway 的 URL；
Parameters：定义模板中所需的参数。

以下是一个简单的 SAM 模板示例：

// www.javascriptcn.com code example
Transform: AWS::Serverless-2016-10-31
Resources:
  HelloWorld:
    Type: AWS::Serverless::Function
    Properties:
      Handler: index.handler
      Runtime: nodejs14.x
      CodeUri: .
      Events:
        HelloWorldApi:
          Type: Api
          Properties:
            Path: /hello
            Method: get
Outputs:
  HelloWorldApi:
    Value:
      Fn::Sub: "https://${ServerlessRestApi}.execute-api.${AWS::Region}.amazonaws.com/Prod/hello"
    Export:
      Name: HelloWorldApi

SAM CLI

SAM CLI 是一个命令行工具，用于本地开发和部署 Serverless 应用。SAM CLI 提供了以下几个命令：

sam init：初始化一个新的 Serverless 应用；
sam build：构建应用代码；
sam local invoke：本地调用 Lambda 函数；
sam local start-api：启动本地 API Gateway；
sam deploy：部署 Serverless 应用。

SAM 的使用方法

初始化一个新的 Serverless 应用

使用 SAM CLI 的 init 命令可以初始化一个新的 Serverless 应用。SAM CLI 提供了多种语言的模板，例如 Node.js、Python、Java 等。以下是一个初始化 Node.js 应用的示例：

sam init --runtime nodejs14.x --name my-serverless-app --app-template hello-world

构建应用代码

使用 SAM CLI 的 build 命令可以构建应用代码。SAM CLI 会自动检测应用的语言和构建工具，并执行相应的构建命令。以下是一个构建 Node.js 应用的示例：

sam build

本地调用 Lambda 函数

使用 SAM CLI 的 local invoke 命令可以本地调用 Lambda 函数。SAM CLI 会自动启动一个 Lambda 运行环境，并将事件传递给函数。以下是一个本地调用 Node.js Lambda 函数的示例：

sam local invoke HelloWorldFunction --event event.json

启动本地 API Gateway

使用 SAM CLI 的 local start-api 命令可以启动本地 API Gateway。SAM CLI 会自动启动一个本地 API Gateway，并将请求转发到本地运行的 Lambda 函数。以下是一个启动本地 API Gateway 的示例：

sam local start-api

部署 Serverless 应用

使用 SAM CLI 的 deploy 命令可以部署 Serverless 应用。SAM CLI 会自动打包应用代码，并将应用部署到 AWS 上。以下是一个部署 Serverless 应用的示例：

sam deploy --guided

实践经验

使用 Layers 分离公共代码

在 Serverless 应用中，多个 Lambda 函数可能会共享一些公共代码。这时可以使用 Layers 将公共代码分离出来，以便多个 Lambda 函数共享。以下是一个使用 Layers 的 SAM 模板示例：

// www.javascriptcn.com code example
Transform: AWS::Serverless-2016-10-31
Resources:
  SharedLib:
    Type: AWS::Serverless::LayerVersion
    Properties:
      LayerName: SharedLib
      Description: A layer for shared code
      ContentUri: shared/
      CompatibleRuntimes:
        - nodejs14.x
  HelloWorld:
    Type: AWS::Serverless::Function
    Properties:
      Handler: index.handler
      Runtime: nodejs14.x
      CodeUri: .
      Layers:
        - !Ref SharedLib
      Events:
        HelloWorldApi:
          Type: Api
          Properties:
            Path: /hello
            Method: get
Outputs:
  HelloWorldApi:
    Value:
      Fn::Sub: "https://${ServerlessRestApi}.execute-api.${AWS::Region}.amazonaws.com/Prod/hello"
    Export:
      Name: HelloWorldApi

使用 Environment Variables 存储配置信息

在 Serverless 应用中，需要将一些配置信息以环境变量的形式传递给 Lambda 函数。SAM CLI 的 deploy 命令可以通过 --parameter-overrides 参数指定环境变量的值。以下是一个使用 Environment Variables 的 SAM 模板示例：

// www.javascriptcn.com code example
Transform: AWS::Serverless-2016-10-31
Resources:
  HelloWorld:
    Type: AWS::Serverless::Function
    Properties:
      Handler: index.handler
      Runtime: nodejs14.x
      CodeUri: .
      Environment:
        Variables:
          TABLE_NAME: !Ref MyTable
      Events:
        HelloWorldApi:
          Type: Api
          Properties:
            Path: /hello
            Method: get
  MyTable:
    Type: AWS::DynamoDB::Table
    Properties:
      TableName: my-table
      AttributeDefinitions:
        - AttributeName: id
          AttributeType: S
      KeySchema:
        - AttributeName: id
          KeyType: HASH
Outputs:
  HelloWorldApi:
    Value:
      Fn::Sub: "https://${ServerlessRestApi}.execute-api.${AWS::Region}.amazonaws.com/Prod/hello"
    Export:
      Name: HelloWorldApi

使用 deploy 命令时，可以通过 --parameter-overrides 参数指定环境变量的值：

sam deploy --guided --parameter-overrides TABLE_NAME=my-table

结语

SAM 是 AWS 的一种 Serverless 框架，可以帮助开发者更加方便地开发和部署 Serverless 应用。本文介绍了 SAM 的基本概念、使用方法以及一些实践经验，希望能对读者有所帮助。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/67d4f760a941bf71349389f6

Serverless 框架中的 SAM：一种思考及使用的指南

前言