博客自动化部署

leader755

发布于 2022-03-09 14:46:25

4690

发布于 2022-03-09 14:46:25

文章被收录于专栏：万丈高楼平地起

为什么要写 Blog？

是啊，为什么要写 Blog？毕竟这里没有人支付稿酬，也看不出有任何明显的物质性收益。不管你选择那种博客，这本身也是一个学习过程。 —— 阮一峰

一.目前常见的博客框架：

hexo 官网：https://hexo.io，基于 node.js 的静态博客。
vuepress 官网：https://vuepress.vuejs.org/zh/基于 vue.js 的
halo 官网：https://halo.run/ 基于 springboot vue 动态博客。
WordPress 官网：https://wordpress.org/,php 动态博客
Z-Blog 官网：https://www.zblogcn.com/ PHP
typecho http://typecho.org/ PHP
emlog https://emlog.cn/ PHP
jekyll http://jekyllcn.com/ 将纯文本转换为静态博客网站
hugo 官网：https://www.gohugo.org/，基于 go 语言
solo 官网：https://solo.b3log.org/ 基于 java,有后台管理

二.hexo 博客搭建部署

1.搭建本地 hexo 博客

npm install hexo-cli -g   //全局安装 hexo
hexo init blog            //初始化
hexo new "Hello Hexo"     //新建一个makedown 文档
hexo generate             //打包生成静态文件
hexo server               //启动服务(可以看到新增的文档)

"scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
  }

2.hexo 的主题配置以常用插件

说明：在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。

git clone https://github.com/iissnan/hexo-theme-next themes/next

theme: next;

3.hexo 博客部署到 Github

npm install hexo-deployer-git --save

deploy:
  - type: 'git'
  repo:
    gitee: git@gitee.com:leader755/leader755.git,master
    github: git@github.com:Leader755/leader755.github.io.git,master
  name: "Leader755"
  email: "1181012791@qq.com"

hexo g -d

###

4.语雀文档同步到 hexo 博客

1>安装 yuque-hexo 同步文章插件

npm i -g yuque-hexo  //安装 yuque-hexo

//底部新增以下配置
"yuqueConfig": {
    "postPath": "source/_posts/yuque",
    "cachePath": "yuque.json",
    "mdNameFormat": "title",
    "adapter": "hexo",
    "concurrency": 5,
    "baseUrl": "https://www.yuque.com/api/v2",
    "login": "leader755",
    "repo": "blog",
    "token": "在语雀上申请的 token",
    "onlyPublished": false,
    "onlyPublic": false
  }

参数含义：

参数名	含义	默认值
postPath	文档同步后生成的路径	source/_posts/yuque
cachePath	文档下载缓存文件	yuque.json
mdNameFormat	文件名命名方式 (title / slug)	title
adapter	文档生成格式 (hexo/markdown)	hexo
concurrency	下载文章并发数	5
baseUrl	语雀 API 地址	-
login	语雀 login (group), 也称为个人路径	-
repo	语雀仓库短名称，也称为语雀知识库路径	-
onlyPublished	只展示已经发布的文章	false
onlyPublic	只展示公开文章	false

2>语雀上申请 token

3>可执行的命令行

"scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server",
    "sync": "yuque-hexo sync",
    "clean:yuque": "yuque-hexo clean"
  }

三.全自动部署博客

使用 Hexo + Github + 语雀 + yuque-hexo +actions+severless + jenkins 打造全自动持续集成个人博客，云端写作，自动部署，完美体验~。

整体流程： https://www.processon.com/embed/6222efc56376890772902783

语雀发布一篇文章
webhook 调用 serverless 函数
serverless 发起请求 trigger 一个 build 任务
actions 同步语雀文章并构建 hexo
github 生成静态页面展示
jenkins 自动拉取代码部署到个人网站

1. Serverless 云函数自动化

目前阿里云和腾讯云都有 serverless 服务，免费的额度完全够用了，目前用的腾讯云的。

1）创建函数

2）serverless 函数示例:

# -*- coding: utf8 -*-
import requests,time

text = time.strftime("%Y-%m-%d, %H:%M:%S", time.localtime())


def main_handler(event, context):
    r = requests.post("https://gitee.com/api/v5/repos/leader755/blog-master/hooks/572161/tests",
    json = {
        "access_token":"gitee申请的token",
        # "body":"语雀文章更新，itee触发构建" + str(text)
    },
    headers = {
        "User-Agent":'curl/7.52.1',
        'Content-Type': 'application/json;charset=UTF-8'})
    if r.status_code == 204:
        return "This's OK!"
    else:
        return r.status_code

2.语雀配置

步骤：语雀文档 ->设置->新消息推送

已添加的 webhook 列表：

3.Github Actions 自动化部署 github pages

在博客源文件库中新建文件 .github/workflows/deploy.yml，配置内容如下：

1>准备 2 个 github 仓库

博客源文件库：https://github.com/Leader755/blog-master.git 页面文件仓库：https://github.com/Leader755/leader755.github.io.git

2>为 github 仓库配置秘钥

目的：源码仓库代码推送到 githubPage 仓库

页面文件仓库（即 leader755.github.io）:
- 在 **Settings > Deploy keys** 中添加 Deploy key，内容为 **hexo-deploy-key.pub** 文件内容，同时勾选 **Allow write access** 选项。
博客源文件库：
- 在 **Settings > Secrets** 中添加一个 Secret，名称为 **DEPLOY_KEY**，内容为 **hexo-deploy-key** 文件内容。后续在 Workflow 中通过名称 DEPLOY_KEY 使用这个密钥。

3>工作流 Workflow 配置

在博客源文件库中新建文件 .github/workflows/deploy.yml，配置内容如下：

# workflow name
name: actions single

# 当有 push 到仓库和外部触发的时候就运行
on: [push, repository_dispatch]

# YQ_TOKEN
# YUQUE_GIT_HEXO
jobs:
  deploy:
    name: Deploy Hexo Public To Pages
    runs-on: ubuntu-latest
    env:
      TZ: Asia/Shanghai

    steps:
    # check it to your workflow can access it
    # from: https://github.com/actions/checkout
    - name: Checkout Repository master branch
      uses: actions/checkout@master

    # from: https://github.com/actions/setup-node
    - name: Setup Node.js 10.x
      uses: actions/setup-node@master
      with:
        node-version: "10.x"

    #安装依赖(包含yuque-hexo，此处无需安装) from https://github.com/x-cold/yuque-hexo
    - name: Install dependencies
      run: |
        npm install hexo-cli -g
        npm install yuque-hexo -g
        npm install

    # 此处请勿使用hexo clean&&yuque-hexo（重新构建时无需此命令行）同步语雀文章
    - name: yuque-hexo sync
      env:
        YUQUE_TOKEN: ${{ secrets.YUQUE_TOKEN_HEXO_SYNC_GITHUB_ONLINE}} # from: 这里是YUQUE_TOKEN: $不能随意改
      run: |
        hexo clean
        yuque-hexo sync || yuque-hexo sync || yuque-hexo sync  # 用 || 来重试的次数


    # 生成可访问的文档
    - name: hexo generate
      run: |
        hexo g

    # 生成pages且推送到文件仓库 from https://github.com/peaceiris/actions-gh-pages
    - name: Deploy hexo to Github pages
      uses: peaceiris/actions-gh-pages@v3
      with:
        deploy_key: ${{ secrets.YUQUE_GIT_HEXO }} # 此处为 hexo-deploy-key
        external_repository: Leader755/leader755.github.io
        publish_branch: master
        publish_dir: ./public
        commit_message:  deploy githubPage
        # commit_message: ${{ github.event.head_commit.message }}

利用 GitHub Actions 实现博客自动发布，将静态博客页面部署到多个服务器上，比如 GitHub Pages、Gitee pages 、云服务器上。

4.jenkins 的自动化部署

1>搭建 jenkins

yum 安装

//yum安装 （yum的repos中默认是没有Jenkins的，需要先将Jenkins存储库添加到yum repos)
1>cd ~ //回到主目录进行安装 jenkins
2>sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
3>sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
4>yum install jenkins // 安装jenkins(稳定版)

修改用户为 root（为了不因为权限出现各种问题，这里直接使用 root）

1>[root@localhost ~] vim /etc/sysconfig/jenkins
2>修改其中的2处为（防止权限问题）
   JENKINS_USER="root"
   JENKINS_PORT="8081"
3>查看到 jenkins根目录是 "/var/lib/jenkins"

启动 jenkins 服务（默认端口是 8080，目前已经修改为 8081）

  1>[root@localhost ~]# systemctl start jenkins.service  //启动 jenkins 服务
  2>[root@localhost ~]# chkconfig jenkins on  //将Jenkins服务设置为开机启动
  3>web访问页面:   ip+端口

  #jenkins启动/停止/重启
  service jenkins start/stop/restart

  #重载服务（由于前面修改了Jenkins启动脚本）
    sudo systemctl daemon-reload

  #查看 jenkins 信息
  ps -ef | grep jenkins