搭建 VuePress

操作场景

本文档介绍通过腾讯云静态网站托管服务搭建一个 VuePress 网站，并使用云开发 CLI 工具管理部署 VuePress 网站。

• 方式一：一键部署项目至云端。
• 方式二：使用 CLI 工具，手动将本地文件部署至云端。

一键部署 VuePress

单击下方按钮可一键部署 VuePress 到云开发：

CLI 工具部署

前提条件

在进行后续的内容前，请先确保您的电脑中已安装 Node.js 运行环境。如果未安装，可以访问 Node.js 官网 下载安装。

操作步骤

步骤1：安装云开发 CLI 工具 和 VuePresss

执行以下命令，安装云开发 CLI 工具以及 VuePress。

npm i -g @cloudbase/cli vuepress

步骤2：在本地初始化一个 VuePress 项目

1. 执行以下命令，在本地创建一个目录，本文以 tcb 为例：
   

   mkdir tcb && cd tcb

2. 进入到 tcb 目录后，执行以下命令，创建一个默认的 hello world 文件。
   

   echo "# Hello TCB & Vuepress" > README.md

   
3. 执行以下命令，启动 VuePresss。
   

   vuepress dev

   等待其编译完成，完成后如下图所示：
   
4. 打开浏览器访问 localhost:8080，可以看到上述步骤创建的文档产生的页面，说明已成功完成 VuePress 的本地初始化。
   

步骤3：创建一个云开发环境

完成本地的 Vuepress 建设，接下来创建一个云开发环境，用于部署 VuePresss。

1. 开通云开发环境
   1. 登录腾讯云 云开发控制台，单击新建，新建一个环境进行部署。
   2. 应用来源选择模板仓库或代码导入，并进行相应的配置，详情可参见 应用部署。
   3. 选择环境所属地域，选择按量计费计费方式，填写环境名称后单击下一步。
      
   4. 根据提示进行相应的配置创建一个云开发环境。

      说明：

      在开通环境以后，请记住您的环境 ID，该 ID 后续部署需要用到。

2. 开通静态网站托管
   云开发环境创建完成后，单击左侧菜单栏中的静态网站托管，根据页面提示单击开通静态网站托管进行开通。
   
   当出现如下图时，则说明静态网站托管已经开通。
   
   您现在可以通过上传文件手动上传一个文件测试，稍后，我们将会使用云开发 CLI 来完成上传。

步骤4：使用 CLI 部署 VuePress

1. 初始化云开发 CLI
   完成云开发环境配置后，需要初始化云开发 CLI ，从而实现借助 CLI 工具来上传页面（您也可以通过网页端直接上传，但如果您博客的文章比较多，建议使用 CLI 工具进行上传）。
   1. 在命令行中执行以下命令登录云开发：
      

      tcb login

   2. 执行之后将提醒您需要在网页中进行授权：
      
      在弹出的页面中单击确认授权。
      
      确认授权后，您会看到控制台输出相应的命令部署。至此，您的云开发 CLI 已初始化完毕。
2. 部署 VuePress
   1. 在 VuePress 的目录，执行以下命令构建静态页面：
      

      vuepress build

      构建完成后，系统将提醒您生成的静态文件在 .vuepress/dist。如下图所示：
      
   2. 需要将 .vuepress/dist 中的文件夹中的内容上传到云开发静态网站托管。
      执行以下命令进入到 dist 目录：
      

      cd .vuepress/dist

      在 dist 目录中执行以下命令上传文件，此处需要将 EnvID 替换为您自己环境的环境 ID：
      

      tcb hosting:deploy ./ -e EnvID

      稍等片刻，文件即可上传完毕，如下图所示：
      
      此时，您在云开发控制台 静态网站托管 页面同样可以查看到已上传的文件，说明成功上传。
      

步骤5：浏览 VuePress

1. 登录腾讯云 云开发控制台，单击左侧菜单栏中的静态网站托管 > 文件管理，进入文件管理页面。
2. 在文件管理页面可以找到默认的域名，单击域名，即可访问您部署的 VuePress。