Cloudbase Framework 是云开发官方出品的前后端一体化部署工具,无需修改业务代码,就能将 Vue 应用前后端一键托管部署在云开发平台。借助于 Cloudbase Framework,你可以一键部署一个已有的 Vue 项目,也可以快速创建一个新的 Vue 项目,用于后续开发。
第一步:确保本地安装了 Node.js
node 版本需要在10以上,如果没有安装,请前往 官网 安装,建议选择 LTS 版本。
第二步:拥有腾讯云账号,开通环境并获得了环境ID
第三步:安装 Cloudbase CLI
代码语言:javascript复制npm i -g @cloudbase/cli
检查是否安装成功。如果有版本输出,就代表安装成功了。
代码语言:javascript复制cloudbase -v
cloudbase 命令可以简写成 tcb(Tencent CloudBase 的简称)。
关于tcb -h,来看看 cloudbase 有哪些能力。
总结下来,大概是这几方面:
- 腾讯云账号登录、退出
- 云开发环境配置
- 应用配置初始化与部署
- 云函数相关
- 文件上传、下载、删除、权限设置
- HTTP Service相关
第四步:登录 Cloudbase
输入以下命令,会在浏览器打开腾讯云的授权页面,点击“确认授权”即可。
代码语言:javascript复制cloudbase login
准备工作都做好以后,我们就可以着手部署相关的工作了。
总的来说,用 Cloudbase Framework 部署一个 Vue 应用,只需要两步。第一步:初始化项目配置;第二步,部署。
如果你的项目已经存在,在项目根目录,执行以下命令,生成项目配置。
代码语言:javascript复制cloudbase init --without-template
选择关联环境后,会在项目根目录,生成一个 cloudbasrc.json 文件。云开发环境 ID 会被写进这个文件。
代码语言:javascript复制{"envId":"static-176d4a"}
接下来,输入以下命令,进行部署。
代码语言:javascript复制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 除了会帮你生成项目配置外,还会初始化项目。
代码语言:javascript复制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 里修改。
点击“调用 hello world 云函数”按钮时,会调用 callFunction 这个方法。
而这个方法,会去调用名为“vue-echo” 的云函数。这个云函数做的就是“echo”的工作,返回一个对象,key名为“event”, value是你传入的对象 {"foo":"bar"}
点击按钮,你会发现返回结果已经展现在页面里了。
关于 cloudbase 的云函数,之后的文章会进一步说明,这里就不赘述了。
第三步:部署
默认 cloudPath 是 /vue。如果要修改静态资源路径,请在 cloudbaserc.json 里修改 cloudPath。
输入以下命令,进行部署。
代码语言:javascript复制cloudbase framework:deploy
部署成功展示:
如果你在部署过程中,遇到了问题,或者希望我们能支持新功能,欢迎 issues 反馈!
作者:秦慕,前端开发工程师,目前就职于腾讯医典。热爱开源,业余开发过文档翻译工具Breword(https://www.breword.com/),翻译过husky、create-react-app、redux、esbuild文档。
欢迎在下方评论区留言或在微信开放社区 进入云开发专区与我们交流。
Cloudbase Framework目前已经开源,点击链接查看源码。(https://github.com/TencentCloudBase/cloudbase-framework
)