如何使用 Serverless Devs 部署静态网站到函数计算

作者 | 邓超 Serverless Devs 开源贡献者

前言

公司经常有一些网站需要发布上线，对比了几款不同的产品后，决定使用阿里云的函数计算（FC)来托管构建出来的静态网站。FC 弹性实例自带的 500 Mb 存储空间[1]对静态网站来说简直是太充足了。

函数计算资源使用：help.aliyun.com/document_de…

部署静态网站到 Custom Runtime 函数

假设我们现在有如下结构的前端工程：

/
├ dist/ 待部署的构建产物
│  └ index.html 
├ src/
└ package.json
复制代码

step 1.编写一个简单的 HTTP 服务器

以 Express 为例, 首先添加依赖到工程:

yarn add express
复制代码

然后新建 app.js 并写入:

let Express = require("express");
let app = new Express();
app.use(Express.static('dist'));
 //使用 dist 文件夹中的内容对外提供静态文件访问
app.use((req, res) => { res.redirect("/"); }); 
// 重定向无法处理的请求到网站的根目录
let port = 9000;
app.listen(port, () => { console.log(`App started on port ${port}`); }); 
// 监听 FC custom 运行时默认的 9000 端口
复制代码

通过 node app.js 启动这个简单的 Express 服务器, 并问 http://localhost:9000 确认 /dist/index.html 能被访问到。

接下来就是把 app.js 和 dist 一起发布到函数计算上就行了。

step 2.编写 bootstrap

函数计算 custom 运行时要求用户提供一个 bootstrap 文件用于启动自定义的 HTTP 服务器, 所以我们需要在根目录下创建这个文件:

#! /bin/bash
node app.js
复制代码

注意第一行的 #! /bin/bash 是必须的, 不然函数计算不知道该用哪一个解释器来执行脚本中的内容。Windows 用户记得把这个文件的换行符从 /r/n 改成 /n , 不然会遇到函数计算启动超时的问题。

step 3. 安装 @serverless-devs/s 并编写 s.yaml

添加 @serverless-devs/s 命令行工具到工程:

yarn add @serverless-devs/s -D
复制代码

然后在根目录下创建一个基础的 s.yaml 配置文件:

# https://github.com/devsapp/fc/blob/main/docs/zh/yaml/
edition: 1.0.0
name: my-awesome-website-project
services:
  my-service: # 任意的名称
    component: devsapp/fc       # 使用 fc 组件
    props:
      region: cn-shenzhen       # 部署到任意的可用区, 例如深圳.
      service:
        name: my-awesome-websites   # 深圳可用区的 my-awesome-websites 服务
      function:
        name: www-example-com     # my-awesome-websites 服务下的一个函数
        runtime: custom        # 使用 custom 运行环境
        handler: dummy-handler     # 由于使用了 custom 运行环境, 所以这里可以随便填
        codeUri: ./          # 部署当前文件夹下的全部内容
      triggers:
        - name: http
          type: http        # 创建一个 HTTP 类型的触发器, 以便客户端可以通过 HTTP 协议进行访问
          config:
            authType: anonymous    # 允许匿名访问
            methods: [ HEAD, GET ]  # 静态网站只需要处理 HEAD 和 GET 请求就够了
复制代码

step 4. 部署到函数计算

配置好 AccessKey 和 AccessSecret[2] 后，执行命令:

s deploy
复制代码

你的网站就部署上去了。

接下来就是配置自定义域名了, 配置好以后就可以通过你自己的域名访问到这个网站了。

step 5.配置自定义域名

以自定义域名 deploy-static-website-to-fc.example.dengchao.fun 为例；首先添加 CNAME 记录, 解析值填写 ${UID}.$ {REGION}.fc.aliyuncs.com. 因为我们的 s.yaml 中设置的 region 是 cn-shenzhen, 所以对应的值就是 xxxxxx.cn-shenzhen.fc.aliyuncs.com .