all-serverless

改三行代码，直接切换 Serverless 云厂商！

比如原先在服务端/云函数（Node.js）使用的微信云开发

const cloud = require("wx-server-sdk")
cloud.init()

使用原写法，切换到 Laf 云，只要这样做：

const asls = require("all-serverless")
const { wxcb: cloud, SdkType } = asls
cloud.init({
  targetSdk: SdkType.LAF,
  lafConfig: {
    baseUrl: "你的 laf 云环境地址",
    dbProxyUrl: "你的 laf 云访问策略路径",
  }
})

// 之后的代码 几乎无需改动！

初始化后的剩余代码，都无需改变；从今以后使用 Serverless 拒绝厂商绑定！

概览

Serverless 没有严格的定义，普遍上大家认为是 BaaS (后端即服务) + FaaS (函数即服务)。

Serverless 确实免去了业务开发人员关于服务器运维的工作量，却也带来了"厂商绑定"、"围墙花园"的问题。当开发者基于特定云厂商的 sdk 进行低成本开发，直到有一天云厂商说我要涨价，没有商量的余地，开发者才发现我所有的代码、配置、数据格式都是基于该云厂商的，想迁云？天方夜谈！

all-serverless 是在这样的背景下诞生的。虽然做不到一键迁云这么简单，但还是非常期望让开发者在业务层只要修改少许的代码（主要是初始化的部分）就完成切换云平台的作用。

撇开人和设备 (机器) 所扮演的角色，如果将一个完整的应用简化成 "前端代码" + "后端代码" + "配置(环境)" + "数据"，那么值得注意的是，all-serverless 提供的是 "后端代码" 运行时的迁移 (兼容) 方案，并且聚焦于 数据库 db 的操作 上，所以其他因素的迁移————包括后端代码如何部署、CLI脚手架、配套插件等————都不在本项目的讨论范围。

在研究各个云厂商关于 Serverless SDK 的实现时，有不少是大同小异的，比如都是触发云函数有的叫 callFunction 有的则叫 invokeFunction，有的返回参数用 data 有的则用 list，仔细一看明明做的是一样的事却有着不同的写法，直叫人头大！

因此，才有了 all-serverless。all-serverless 的目标是弭平各个云厂商 SDK 的差异，让开发者随意使用一种 sdk 的写法也可以快速兼容其他云平台的 Serverless 服务，远景是让万物皆可 Serverless!

安装

npm i all-serverless
# or
pnpm i all-serverless

迁云

如果你之前使用了 laf-client-sdk / @cloudbase/node-sdk / wx-server-sdk 以上任意 sdk 写了后端应用，现在想实现快速迁移至其他 Serverless 平台时，请留意以下注意事项:

1. 本项目仅支持后端云函数上的代码迁移
2. all-serverless 为后端 sdk，请不要在前端使用
3. 本项目不提供数据的迁移，请在迁移云函数代码前，确保迁移后的数据库也包含原数据库的结构。
4. 支持 Laf / 腾讯云开发 / 微信云开发 之间的任意切换，然而目前仅支持微信云开发 wx-server-sdk 的写法格式，即初始化之后的 cloud 的使用方式完全与微信云开发一致。
5. 原 wx-server-sdk 下关于 openapi / cloudPay / callContainer 属性或方法皆能在 wxcb 中使用，只不过 all-serverless 会直接调用 wx-server-sdk 而非你所指定的 targetSdk。
6. 本项目聚焦于 db 数据库操作的代码迁移，也就是最常见的增删改查 CRUD 和聚合操作，故不支持文件存储 (uploadFile / getTempFileURL / deleteFile / downloadFile)、数据库事务 (startTransaction) 、广告数据上报 (analytics) 等延申操作。
7. 与其说"迁移"，不如说"兼容"。

开新项目

如果你不是迁移用户，没有任何历史包袱，依然非常推荐你使用 all-serverless。一起拒绝被任何云厂商绑定！

// CommonJS
const asls = require("all-serverless")
const { wxcb: cloud, SdkType } = asls

// or ESModule or TypeScript
import { wxcb as cloud, SdkType } from "all-serverless"

// 数据库连接到 laf
cloud.init({
  targetSdk: SdkType.LAF,
  lafConfig: {
    // 配置见 https://www.lafyun.com/guide/db/
  },
  // 如果直接在 laf 云函数上，可以直接传
})

// 数据库连接到 腾讯云开发
cloud.init({
  targetSdk: SdkType.TCB,
  tcbConfig: {
    // 配置见 https://docs.cloudbase.net/api-reference/server/node-sdk/initialization#init
    // 结构同 tcb.init(opt) 的 opt
    secretId: "你的腾讯云 secretId",
    secretKey: "你的腾讯云 secretKey",
    env: "你的腾讯云开发环境标识",
  }
})

// 数据库连接到 微信云开发
cloud.init({
  targetSdk: SdkType.WXCB,
  wxcbConfig: {
    // 配置见 https://developers.weixin.qq.com/miniprogram/dev/wxcloud/reference-sdk-api/init/server.init.html
    // 结构同 cloud.init(options) 的 options
  }
})

其中，wxcb（weixin-cloudbase）表示使用微信云开发的写法，未来也会支持 tcb (腾讯云开发) 和 laf (laf云开发) 的写法

all-serverless 让你的后端代码与平台无关，不再被特定 sdk 绑架，快速兼容其他云平台的 sdk。

你的后端云就应该像装在口袋里的巧克力，想吃哪一个就吃哪一个！

初始化

import { wxcb as cloud, SdkType } from "all-serverless"
cloud.init(initOptions)

其中 initOptions 配置如下

initOptions

注1: 当前云函数部署在 laf 云时，可传入 import cloud from '@/cloud-sdk' 的 cloud 作为属性 lafCloudSdk 的值，使后续调用执行的是免鉴权的 cloud-sdk 而非 laf-client-sdk，省略前端访问策略的配置。

SdkType

有以下枚举值

注2: 若 lafCloudSdk 有值，最终调用的 sdk 改为 laf 云上的 cloud-sdk

LafCloudOpt

该配置项同 laf-client-sdk 的使用示例:

import { Cloud } from 'laf-client-sdk'
const cloud = new Cloud(lafConfig)

具体请参考 https://github.com/labring/laf/tree/main/packages/client-sdk

TcbCloudOpt

结构与腾讯云开发 Node.js SDK 的 init() 入参保持一致，即

const tcb = require("@cloudbase/node-sdk")
const app = tcb.init(tcbCloudOpt)

具体请参见 https://docs.cloudbase.net/api-reference/server/node-sdk/initialization

WxcbCloudOpt

结构与微信云开发 Node.js SDK 的 init() 入参保持一致，即

const cloud = require("wx-server-sdk")
cloud.init(wxcbCloudOpt)

具体请参见 https://developers.weixin.qq.com/miniprogram/dev/wxcloud/reference-sdk-api/init/server.init.html

TODO

• 支持 腾讯云开发 的写法
• 支持 Laf 的写法
• 支持 Firebase 的写法 + 覆盖其他端
• 支持 Supabase 的写法 + 覆盖其他端 （需调研 MonogoDB 和 PostgreSQL 的转换）

开源协议

MIT