社区/文章分享/如何用 Cloudbase Framework 部署一个 Vue 项目

如何用 Cloudbase Framework 部署一个 Vue 项目

无需修改业务代码,就能将 Vue 应用前后端一键托管部署在云开发平台~

Cloudbase Framework 是云开发官方出品的前后端一体化部署工具。目前已经 [开源]

关于 Cloudbase Framework 的介绍,《云开发推出「前后端一体化部署工具」CloudBase Framework》。想必大家看完,一定都磨刀霍霍。今天就给大家带来一篇实战文章,如何用 Cloudbase Framework 部署一个 Vue 项目。

准备工作

第一步:确保本地安装了 Node.js

node 版本需要在 10 以上,如果没有安装,请前往官网安装,建议选择 LTS 版本。

第二步:拥有腾讯云账号、开通环境,获得环境 ID

第三步:安装 Cloudbase CLI

npm i -g @cloudbase/cli

检查是否安装成功。如果有版本输出,就代表安装成功了。

cloudbase -v

cloudbase 命令可以简写成 tcb(Tencent CloudBase 的简称)。

tcb -h<span> </span>看看 cloudbase 有哪些能力。

总结下来,大概是这几方面:

  • 腾讯云账号登录、退出
  • 云开发环境配置
  • 应用配置初始化与部署
  • 云函数相关
  • 文件上传、下载、删除、权限设置
  • HTTP Service 相关

第四步:登录 Cloudbase

输入以下命令,会在浏览器打开腾讯云的授权页面,点击“确认授权”即可。

cloudbase login


准备工作都做好以后,我们就可以着手部署相关的工作了。

部署 Vue 应用

总的来说,用 Cloudbase Framework 部署一个 Vue 应用,只需要两步。第一步:初始化项目配置;第二步,部署。

现有项目

如果你的项目已经存在,在项目根目录,执行以下命令,生成项目配置。

cloudbase

选择关联环境后,会在项目根目录,生成一个 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 的。

  1. 初始化项目,支持仅初始化静态 Vue 应用。

目前执行cloudbase init --template=vue 时,只支持初始化全栈 Vue 应用,不支持仅初始化静态 Vue 应用。这对于不想用云函数的团队来说,很不方便。

  1. 优化静态网站托管缓存

将 cloudPath 从 /a 更改到 /b 时, /a 依然能请求到静态资源。而我们期望的是“覆盖”: /a 下不能请求到静态资源。

如果你在部署过程中,遇到了问题,或者希望我们能支持新功能,欢迎 issues 反馈~~

当然,也欢迎更多的小伙伴加入,共建社区生态。

Github 开源地址:https://github.com/TencentCloudBase/cloudbase-framework

欢迎给我们点个 star,帮助我们做得更好。

产品介绍

云开发(Tencent CloudBase,TCB)是腾讯云提供的云原生一体化开发环境和工具平台,为开发者提供高可用、自动弹性扩缩的后端云服务,包含计算、存储、托管等 serverless 化能力,可用于云端一体化开发多种端应用(小程序,公众号,Web 应用,Flutter 客户端等),帮助开发者统一构建和管理后端服务和云资源,避免了应用开发过程中繁琐的服务器搭建及运维,开发者可以专注于业务逻辑的实现,开发门槛更低,效率更高。
开通云开发:https://console.cloud.tencent.com/tcb?tdl_anchor=techsite
产品文档:https://cloud.tencent.com/product/tcb?from=12763
技术文档:https://cloudbase.net?from=10004
技术交流加 Q 群:601134960
最新资讯关注微信公众号【腾讯云云开发】