更新时间:2025-06-28 gmt 08:00

服务-j9九游会登录

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

相关文档

网站地图