如何使用 Serverless Devs 部署静态网站到函数计算
前言
公司经常有一些网站需要发布上线,对比了几款不同的产品后,决定使用阿里云的函数计算(FC)来托管构建出来的静态网站。 FC 弹性实例自带的
函数计算资源使用:
部署静态网站到 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. 部署到函数计算
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 .
样本工程
本文中的样本工程已经上传到 GitHub:
参考链接:
本文作者:邓超(Serverless Devs 开源贡献者)
本文为阿里云原创内容,未经允许不得转载。