使用Vuepress配合GitHub的Actions搭建自动化构建部署博客 #

mkdir demo-docscd demo-docs```  
  
初始化 `demo-docs` 目录  
  
```sh  
git initnpm init```  
  
将 `Vuepressv2 ` 添加到本地依赖  
  
```sh  
npm install -D vuepress@next```  
  
在 `package.json` 添加一下脚本代码  
  
```json  
{  
"scripts": {  
"docs:dev": "vuepress dev docs",  
"docs:build": "vuepress build docs"  
}  
}  

echo 'node_modules' >> .gitignoreecho '.temp' >> .gitignoreecho '.cache' >> .gitignore```  
  
创建第一篇文档  
  
```sh  
mkdir docsecho '# Hello VuePress' > docs/README.md```  
  
在本地启动服务器来开发你的文档网站  
  
```sh  
npm run docs:dev```  
  
VuePress 会在 [http://localhost:8080在新窗口打开](http://localhost:8080/) 启动一个热重载的开发服务器。当你修改你的 Markdown 文件时，浏览器中的内容也会自动更新。  
  
![](https://images.mankvis.com/article/2023/06/28/20230628133213.png)

  
本地网站顺利现实成功，接下来把网站部署到服务器上，在根目录创建 `.github` 文件夹，接着在 `.github` 目录里面创建 `workflows` 文件夹  
  
```sh  
mkdir .githubcd .githubmkdir workflows```  
  
创建 `Actions 的 配置文件`  
  
```sh  
touch deploy.yml```  
  
` deploy.yml` 内容如下  
  
```yaml  
# 这是一个基本的工作流程，可帮助您开始使用 Actions  
name: build  
  
# 控制操作何时运行  
on:  
# 在推送或拉取请求事件上触发工作流，但仅针对主分支  
push:  
branches: [ main ]  
  
# 允许您从“操作”选项卡手动运行此工作流  
workflow_dispatch:  
  
# 工作流运行由一个或多个可以顺序或并行运行的作业组成  
jobs:  
# 此工作流包含一个名为“构建和部署”的作业  
build-and-deploy:  
# 作业将在其上运行的系统类型  
runs-on: ubuntu-latest  
  
# 步骤表示将作为作业的一部分执行的一系列任务  
steps:  
# 在 $GITHUB_WORKSPACE 下签出您的存储库，以便您的工作可以访问它  
- name: Checkout  
uses: actions/checkout@v2  
# 安装 node 环境  
- name: Setup Node.js Environment  
uses: actions/setup-node@master  
# 构建项目  
- name: Buld Project  
run: |  
npm install  
npm run docs:build  
# 发布内容到服务器，这里直接使用现成的轮子 easingthemes/ssh-deploy@@main- name: Deploy to Server  
uses: easingthemes/ssh-deploy@main  
env:  
SSH_PRIVATE_KEY: ${{ secrets.SERVER_SSH_KEY }}  
ARGS: "-rltgoDzvO --delete"  
SOURCE: "docs/.vuepress/dist/"  
REMOTE_HOST: ${{ secrets.REMOTE_HOST }}  
REMOTE_USER: ${{ secrets.REMOTE_USER }}  
TARGET: ${{ secrets.REMOTE_TARGET }}  
EXCLUDE: "/dist/, /node_modules/"  

git add .git commit -m "init"git push origin main

chattr -i .user.inirm .user.ini