无需修改业务代码,就能将 Vue 应用前后端一键托管部署在云开发平台~
Cloudbase Framework 是云开发官方出品的前后端一体化部署工具。目前已经 开源 。
关于 Cloudbase Framework 的介绍,bookerzhao(赵兵)发布过一篇
binggg:效能提升100%? 云开发开源「前后端一体化部署工具」CloudBase Frameworkzhuanlan.zhihu.com。想必大家看完,一定都磨刀霍霍。今天就给大家带来一篇实战文章,如何用Cloudbase Framework部署一个Vue 项目。
准备工作 ♀️
第一步:确保本地安装了 Node.js
node 版本需要在10以上,如果没有安装,请前往 官网 安装,建议选择 LTS 版本。
第二步:拥有腾讯云账号、开通环境、获得环境ID
开通环境cloud.tencent.com第三步:安装 Cloudbase CLI
npm i -g @cloudbase/cli
检查是否安装成功。如果有版本输出,就代表安装成功了。
cloudbase -v
cloudbase 命令可以简写成 tcb(Tencent CloudBase 的简称)。
tcb -h
看看 cloudbase 有哪些能力。
总结下来,大概是这几方面:
- 腾讯云账号登录、退出
- 云开发环境配置
- 应用配置初始化与部署
- 云函数相关
- 文件上传、下载、删除、权限设置
- HTTP Service相关
第四步:登录 Cloudbase
输入以下命令,会在浏览器打开腾讯云的授权页面,点击“确认授权”即可。
cloudbase login
准备工作都做好以后,我们就可以着手部署相关的工作了。
部署 Vue 应用
总的来说,用 Cloudbase Framework 部署一个 Vue 应用,只需要两步。第一步:初始化项目配置;第二步,部署。
现有项目
如果你的项目已经存在,在项目根目录,执行以下命令,生成项目配置。
cloudbase init --without-template
选择关联环境后,会在项目根目录,生成一个 cloudbasrc.json 文件。云开发环境 ID 会被写进这个文件。
{"envId":"static-176d4a"}
接下来,输入以下命令,进行部署。
cloudbase framework:deploy
这个命令会做以下几件事:
1)安装插件 @cloudbase/framework-plugin-website。在cloudbaserc.json里,你会发现执行这个命令后,新增了这个插件。
2)读取云开发环境ID
3)读取publicPath,并将应用资源托管到/
下。因为my-vue-app是用vue-cli创建的项目,所以publicPath默认为"/"
4)打包
5)安装 node_modules
6)部署
部署成功后,访问地址:https://static-176d4a.tcloudbaseapp.com/
新项目
第一步:初始化项目
执行以下命令,Cloudbase 除了会帮你生成项目配置外,还会初始化项目。
cloudbase init --template=vue
执行命令后,会让你选择关联环境、选择云开发模板(Vue 应用)、输入项目名称。这里,我们的项目名是cloudbase-example。
需要注意的是,cloudbase 默认会创建一个全栈 Vue 应用,如果你只想要一个静态 Vue 应用,需要手动去掉云函数部分的代码。
进入创建好的项目根目录,浏览文件结构你会发现和 cloudbase 相关的,除了 cloudbaserc.json 以外,还有一个 cloudfunctions 目录。这个目录就是云函数所在的目录。在 cloudfunctions 目录下有一个名为 vue-echo 的函数,这个云函数,稍后会用到。
cloudebaserc.json里,会默认安装两个插件。之前提到的 @cloudbase/framework-plugin-website 和 云函数部署相关的 @cloudbase/framework-plugin-function
第二步(可跳过):本地开发。
执行npm i
, 安装 node_modules。
执行npm run dev 。
本地运行时,默认监听端口是 5000,publicPath 是 /vue
。这些配置项均可在 package.json 里修改。
部署云函数:tcb functions:deploy vue-echo
点击“调用 hello world 云函数”按钮时,会调用 callFunction 这个方法。
而这个方法,会去调用名为“vue-echo” 的云函数。这个云函数做的就是“echo”的工作,返回一个对象,key名为“event”, value是你传入的对象 { "foo": "bar" }
点击按钮,试试。你会发现返回结果已经展现在页面里了:
关于 cloudbase 的云函数,之后的文章会进一步说明,这里就不赘述了。
第三步:部署
默认 cloudPath 是 /vue
。如果要修改静态资源路径,请在 cloudbaserc.json 里修改 cloudPath。
输入以下命令,进行部署。
cloudbase framework:deploy
部署成功
待优化的地方
在体验过程中,用户反馈了这些问题,我们之后会逐步优化。
1)初始化新项目时,支持自动安装node_modules
目前执行cloudbase init --template=vue
时,是不会执行npm install
的脚本来安装node_modules的。
2)初始化项目,支持仅初始化静态 Vue 应用。
目前执行cloudbase init --template=vue
时,只支持初始化全栈 Vue 应用,不支持仅初始化静态 Vue 应用。这对于不想用云函数的团队来说,很不方便。
3) 优化静态网站托管缓存
将 cloudPath 从 /a
更改到 /b
时, /a
依然能请求到静态资源。而我们期望的是“覆盖”: /a
下不能请求到静态资源。
如果你在部署过程中,遇到了问题,或者希望我们能支持新功能,欢迎 issues 反馈~~
当然,也欢迎更多的小伙伴加入,共建社区生态。
Cloudbase Framework GitHub 地址github.com欢迎给我们点个star,帮助我们做得更好