szwnba / affweb

47 stars 6 forks source link

Vercel搭建线上项目 (无服务器版-免费)-CSDN博客 #638

Open szwnba opened 1 month ago

szwnba commented 1 month ago

前言

无服务器方案

这篇文章我给出了一个方案,借助Vercel、NextJS让你几分钟就能实现一个CURD(增删改查)的后端API,无需购买服务器,完全免费。

该方案有以下两个优点:

工具介绍

Vercel是什么

它是一个强大的 网站托管服务。Vercel类似于github page,但比github page强大、速度也快得多。通过绑定你的github项目,就能实现提交代码自动部署你的应用。

Next.JS是什么

Next.js是Vercel官方推荐的、一款极易上手的React 应用框架。使用NextJS可以快速开发 React 应用,而不是先花很多时间和精力去折腾各种开发工具。

Serverless 是什么

简单地理解:Serverless = Faas(函数即服务) + Baas(后端即服务);

Serverless不代表再也不需要服务器了,而是说:开发者再也不用过多考虑服务器的问题

这里只是截图腾讯云对Serverless的表述进行讲解, 并不代表腾讯云才有Serverless技术, 望知悉!

快速开始

账号

首先要在 Vercel 后台注册一个账号,推荐用github直接登录。

初始化Vercel环境

执行 npm i -g vercel 安装vercel(NodeJs版本大于12)

控制台输入 vercel login 登录Vercel账号,输入指令后需要验证你的vercel邮箱,vercel会向该邮箱发送一个链接,点击邮箱中的链接就可以确认登录。

创建一个Vercel项目

创建一个空目录 demo-vercel

`mkdir demo-vercel && cd demo-vercel` 

*   1

输入命令 vercel ,将当前目录初始化为vercel项目,vercel会询问你一些信息,一路回车就好。

第一个简单页面

在根目录新建的配置文件vercel.json,并填入下面的配置。(配置说明默认访问服务将跳转到welcome.html页面)

`{
    "routes": [
        {
            "handle": "filesystem"
        },
        {
            "src": "/(.*)",
            "status": 404,
            "dest": "/welcome.html"
        }
    ]
}` 

*   1
*   2
*   3
*   4
*   5
*   6
*   7
*   8
*   9
*   10
*   11
*   12

welcome.html页面内容如下:

`<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <title>欢迎</title>
    </head>
    <body>
            <h1>欢迎</h1>
    </body>
</html>` 

*   1
*   2
*   3
*   4
*   5
*   6
*   7
*   8
*   9
*   10
*   11

代码结构

第一个api接口

Vercel官方仅支持 Nodejs、Go、Python、Ruby 这几门语言创建服务,具体使用接入请参考 官方文档

这里选用 Node.js 来开发接口,初始化package.json、引入vercel相关的Typescript便于规范,执行以下脚本:

`npm init 
npm i typescript 
npm i @vercel/node -D` 

*   1
*   2
*   3

新建目录/api,并在/api下创建文件helloworld.ts, 文件内容如下:

`import { VercelRequest, VercelResponse } from '@vercel/node';
module.exports = async (req: VercelRequest, res: VercelResponse) => {
    const data = {
        msg: "hello world!"
    };
    res.status(200).json(data);
}` 

*   1
*   2
*   3
*   4
*   5
*   6
*   7

当前目录结构如下:

执行 vercel dev 进行本地调试

`vercel dev --debug` 

*   1

访问页面 http://localhost:3000/api/helloworld ; 链接效果如图:

部署上线

在控制台输入 vercel 即可开始自动部署,点击控制台输出的Preview后面的链接即可预览部署效果。

数据库持久化

API接口最基本的增删改查等功能,依托于数据库持久化。这里我们选择接入免费的云数据库。

这里我使用 mongodb 举例, 你也可根据实际业务需要接入任意数据库来完成你的项目。因篇幅有限不做拓展

https://cloud.mongodb.com 提供的Mongodb数据库举例,512M免费存储额度,个人使用已经绰绰有余。

当然还有 db4free.net、mlab.com等其他云数据库网站,除此之外还有免费的rabbitMQ,kafka等。

创建数据库

https://cloud.mongodb.com 注册一个账号,注册完毕后进入找到 Create a cluster, 选择Free的免费方案。

配置服务器地点和服务提供商,(举例用的是Google Cloud,北美中部的服务器);等待1-3分钟后创建完毕:

配置连接参数

创建一个访问用户,并选择用Password密码的形式连接:

添加允许访问改数据库的IP地址:这里可以点Add current ip address 表示添加当前电脑ip地址,点击 Allow access from anywhere 表示允许所有网络ip地址访问该数据库(这样可能会有风险)

客户端连接数据库:

点击connect

点击第三个Connect using MongoDB Compass,采用图形界面连接;

复制下面的连接代码

打开Navicat,选择新建MongoDB,在URI中输入刚才复制的代码,并且将密码部分改成你实际设置的密码;点击测试连接。

添加测试数据

我们用Navicat往MongoDB添加一条数据:创建一个数据库名叫vercel、创建一个集合的名叫demo,document内容为 {name:“tanghh”}

至此,数据库的创建,与连接配置已经完成,接下来在代码中实现功能

在代码中访问数据库

NPM 安装Mongodb依赖库

`npm i mongodb
npm i @types/mongodb -D` 

*   1
*   2

接下我们用接口查询这条数据。我们在api目录下创建名为getUsername.ts的文件

`import { VercelRequest, VercelResponse } from '@vercel/node';
import { MongoClient } from 'mongodb'
const CONNECTION_STRING = "mongodb+srv://xxx/vercel";
module.exports = async (req: VercelRequest, res: VercelResponse) => {
  const client = await MongoClient.connect(CONNECTION_STRING, { useNewUrlParser: true, useUnifiedTopology: true });
  const db = await client.db('vercel');
  var result = await db.collection("helloworld").find().toArray();
  console.log(client)
  console.log(db)
  console.log(result)
  res.status(200).json(result);
}` 

*   1
*   2
*   3
*   4
*   5
*   6
*   7
*   8
*   9
*   10
*   11
*   12

注意:

代码中的CONNECTION_STRING信息更换成你自己的!!!
CONNECTION_STRING变量的值,和之前用Navicat连接的代码不太一样,可以在网站后台找到, 如下图:

完成效果展示

至此,一个通过MongoDB返回数据的serverless接口开发完毕;类似的你可以用这个平台简易的完成一个CURD的功能

通过运行vercel --prod命令即可将其发布。

总结

动态API,数据库,托管服务器都是免费的,结合这套方案,轻装上阵,搭建你的API服务端吧~

拓展

Vercel API说明

在 vercel 中通过 res.json(obj) 来返回 JSON 数据,像这样的简单方便的函数并不为原生的 HTTP Handler (opens new window) 所提供。而由 vercel 提供的 Node.js Helper (opens new window) 实现:

Vercel.json 重定向说明

部署完成后,默认的路由路径是 /api,此时 / 会显示文件目录,如果想更好地扩展路由呢?

通过配置文件 vercel.json 配置 Rewrites/Redirects 可完成此功能,通过这一功能可以快速实现反向代理、路由转换等功能。

`{
  "rewrites": [
    {
      "source": "/",
      "destination": "/api"
    }
  ]
}` 

*   1
*   2
*   3
*   4
*   5
*   6
*   7
*   8