更新时间:2023-11-02 GMT+08:00
分享

服务

service就像一个项目,您可以在服务中定义华为云函数工作流的函数和触发它们的events,所有这些都在一个名为serverless.yml的文件中。

若您要构建第一个Serverless Framework项目,请先创建一个service。

组织

在最初使用应用时,建议您可以使用单个服务来定义该项目的所有函数和事件。
myService/
  serverless.yml  # Contains all functions and infrastructure resources
但是,随着应用增多,您可以将其拆分为多个服务。大多数用户按工作流或数据模型组织他们的服务,并在服务中将与这些工作流和数据模型相关的函数进行分组。
users/
  serverless.yml # Contains 4 functions that do Users CRUD operations and the Users database
posts/
  serverless.yml # Contains 4 functions that do Posts CRUD operations and the Posts database
comments/
  serverless.yml # Contains 4 functions that do Comments CRUD operations and the Comments database

这是有意义的,因为相关函数通常使用公共基础设施资源,并且用户希望将这些函数和资源作为单个部署单元放在一起,以便更好地组织和分离关注点。

创建

使用create命令创建服务。您可以输入路径创建目录并将服务自动命名:
# Create service with Node.js template in the folder ./my-service
serverless create --template-url https://github.com/zy-linn/examples/tree/v3/legacy/huawei-nodejs --path my-service

huawei-nodejs是华为云函数工作流的可用运行时。

有关所有详细信息和选项,请查看创建

目录

您将在工作目录中看到以下文件:

  • serverless.yml
  • src/index.js

serverless.yml

每个service配置都在serverless.yml文件中管理。本文件的主要用途是:

  • 声明Serverless服务。
  • 在服务中定义一个或多个函数:
    • 定义服务将被部署到的提供商(如果有运行时,也要定义)。
    • 定义要使用的任何自定义插件。
    • 定义触发每个函数执行的事件(如HTTP请求)。
    • 允许“events”部分中列出的事件在部署时自动创建事件所需的资源。
    • 允许使用Serverless变量进行灵活配置。
您可以看到服务名称、提供商配置,以及functions定义中的第一个函数。任何后续的服务配置都将在此文件中完成。
# serverless.yml
service: my-fc-service

provider:
  name: huawei
  runtime: Node.js14.18
  credentials: ~/.fg/credentials # path must be absolute

plugins:
  - serverless-huawei-functions

functions:
  hello_world:
    handler: index.handler

index.js

index.js文件包含您导出的函数。

部署

部署服务时,serverless.yml中的所有函数和事件都会转换为对华为云API的调用,用于动态定义这些资源。

使用deploy命令部署服务:

serverless deploy

查看部署指南,了解有关部署的更多信息及其工作原理。有关所有详细信息和选项,请查看deploy命令文档

移除

为了方便地在华为云上移除您的服务,可以使用remove命令。

运行serverless remove触发移除进程。

Serverless开始移除时,会在控制台中通知您进程。移除整个服务后,打印成功消息。

移除过程将仅移除提供商基础设施上的服务。服务目录仍将保留在本地计算机上,因此您仍可以在稍后修改并(重新)将其部署到另一个环境、区域或提供商。

版本固定

Serverless Framework通常通过npm install -g serverless全局安装。因此,您的所有服务都可以使用Serverless CLI。

全局安装工具的缺点是无法将版本固定在package.json内部。如果升级Serverless,但您的同事或CI系统不升级,这可能会导致问题。您可以在serverless.yml中使用某个特性,而不必担心CI系统会使用旧版本的Serverless进行部署。

  • 固定版本

    要配置版本固定,请在serverless.yml中定义frameworkVersion属性。每当您从CLI运行Serverless命令时,它都会检查当前Serverless版本是否匹配frameworkVersion的范围。CLI使用语义化版本,因此您可以将其固定为明确的版本或提供版本范围。一般来说,建议固定到明确的版本,以确保团队中的每个人都有完全相同的设置,并且不会发生意想不到的问题。

    示例

    明确的版本。

    # serverless.yml
    
    frameworkVersion: '2.1.0'
    版本范围。
    # serverless.yml
    
    frameworkVersion: ^2.1.0 # >=2.1.0 && <3.0.0

在现有服务中安装Serverless

如果您已经有Serverless服务,并且更愿意使用package.json锁定框架版本,那么您可以按以下方式安装Serverless:

# from within a service
npm install serverless --save-dev
  • 本地调用Serverless
    要执行本地安装的Serverless,您必须引用node_ modules目录中的二进制文件,示例如下:
    node ./node_modules/serverless/bin/serverless deploy

相关文档