Czhlin's Blog

我的前端开发日志

0%

hexo的自动化部署(三)

发表于 更新于 分类于
本文字数： 4.2k 阅读时长 ≈ 4 分钟

准备工作

在开始第三部分前配置前，你需要有如下准备：

  • github和gitee仓库
  • 私有仓库hexo-blog放在github和gitee上
  • 本地的hexo-blog源码仓库
  • 一个已经备案的域名

使用github的action实现自动化release部署

在本地hexo-blog仓库中新增文件夹.github/workflows/。

在.github/workflows/文件夹下新增release.yml文件，配置如下：

[username]替换成你的用户名

[useremail]替换成你的邮箱

xxx.xxx替换成你的域名

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# workflow name
name: Release CI

# master branch on push, auto run
on: 
  push:
    branches:
      - master
      
jobs:
  build: 
    runs-on: ubuntu-latest 
        
    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 16.x 
      uses: actions/setup-node@master
      with:
        node-version: "16.x"
    
    - name: Setup Hexo Dependencies
      run: |
        npm install hexo-cli -g
        npm install
    
    - name: Setup Deploy Private Key
      env:
        HEXO_DEPLOY_PRIVATE_KEY: ${{ secrets.HEXO_DEPLOY_PRIVATE_KEY }}
      run: |
        mkdir -p ~/.ssh/
        echo "$HEXO_DEPLOY_PRIVATE_KEY" > ~/.ssh/id_rsa 
        chmod 600 ~/.ssh/id_rsa
        ssh-keyscan xxx.xxx >> ~/.ssh/known_hosts
        ssh-keyscan github.com >> ~/.ssh/known_hosts
    - name: Setup Git Infomation
      run: | 
        git config --global user.name '[username]' 
        git config --global user.email '[useremail]'
    - name: Deploy Hexo 
      run: |
        hexo clean
        hexo generate 
        hexo deploy

配置release的公钥和私钥

  • 新建一个github上的hexo-blog远程私有仓库

  • 在hexo-blog仓库的Settings=>Secrets=>Actions上点击New repository secret新增一个secret用于hexo博客的部署

    NameSecret
    HEXO_DEPLOY_PRIVATE_KEY本地的主机：~\.ssh\hexo-blog，（第一部分操作生成的密匙）

  • 在github上的Settings=>SSH and GPG keys =>SSH keys上点击New SSH key新增一个公钥用于hexo博客的部署

    TitleKey typeKey
    HEXO_DEPLOY_KEYAuthentication Key本地的主机：~\.ssh\hexo-blog.pub，（第一部分操作生成的密匙）

注释掉hexo-blog的gitee部署配置

打开hexo的_config.yml配置文件更改为如下配置:

[username]替换成你的用户名

xxx.xxx替换成你的域名

1
2
3
4
5
6
7
8
9
10
deploy:
  - type: git
    repo: [username]@xxx.xxx:/home/git/blog.git   #用户名@服务器Ip:git仓库位置
    branch: master
  - type: git 
    repo: git@github.com:[username]/[username].github.io.git
    branch: master
 # - type: git 
 #   repo: git@gitee.com:[username]/[username].gitee.io.git
 #   branch: master

这样做的目的是因为通过action将博客从github部署到gitee上会出现部署超时的情况，所以我们后续将实现同步工作流将github的博客同步到gitee上。

使用github的action实现自动化synchronize同步到gitee上

在.github/workflows/文件夹下新增synchronize.yml文件，配置如下：

[username]替换成你的用户名

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# workflow name
name: Synchronize To Gitee

# master branch on push, auto run
on: 
  workflow_run:
    workflows: ["Release CI"]
    types:
      - completed

jobs:
  build: 
    runs-on: ubuntu-latest         
    steps:
    - name: Mirror the Github hexo-blog repos to Gitee.
      uses: Yikun/hub-mirror-action@master
      timeout-minutes: 5
      with:
        src: github/[username]
        dst: gitee/[username]
        dst_key: ${{ secrets.GITEE_PRIVATE_KEY }}
        dst_token: ${{ secrets.GITEE_TOKEN }}
        # these repos will be mirrored as private repo
        dst_visibility: "private"
        cache_path: github/workspace/hub-mirror-cache
        clone_style: "ssh"
        static_list: "hexo-blog"
        force_update: true
        debug: true
    - name: Synchronize static pages
      uses: Yikun/hub-mirror-action@master
      timeout-minutes: 5
      with:
        src: github/[username]
        dst: gitee/[username]
        dst_key: ${{ secrets.GITEE_PRIVATE_KEY }}
        dst_token: ${{ secrets.GITEE_TOKEN }}
        mappings: "[username].github.io=>[username].gitee.io"
        clone_style: "ssh"
        static_list: "[username].github.io"
        force_update: true
        debug: true

配置synchronize的公钥、私钥和token

  • 在本地电脑上生成synchronize密匙对

    这里的[your_email@example.com]改成你的邮箱

    1
    2
    # 进入到本地电脑的~\.ssh文件夹下再进行操作
    ssh-keygen -t rsa -C "[your_email@example.com]" -f synchronize

    然后一直回车，新建一个密钥。一般来说在你创建的时候命令行会提示你密钥文件的路径，windows电脑一般是C:\Users\Administrator\.ssh\。复制synchronize.pub文件中的内容备用。

  • 新建一个gitee上的hexo-blog远程私有仓库

  • 在gitee上的设置=>SSH公钥=>添加公钥上添加公钥如下：

    标题公钥
    HEXO_DEPLOY_KEY本地的主机：~\.ssh\hexo-blog.pub，（第一部分操作生成的密匙）
    GITEE_PUBLIC_KEY本地的主机：~\.ssh\synchronize.pub,（用于将github仓库同步到gitee上)

  • 在gitee上的设置=>私人令牌=>生成新令牌如下：

    私人令牌描述请选择将要生成的私人令牌所拥有的权限
    github同步到gitee全选

    将生成的token信息保存下来，用于后续的配置

  • 回到github上。我们在hexo-blog仓库的Settings=>Secrets=>Actions上点击New repository secret新增两个secret用于同步到gitee上。

    NameSecret
    GITEE_PRIVATE_KEY本地的主机：~\.ssh\synchronize,（用于将github仓库同步到gitee`上)
    GITEE_TOKEN上一步在gitee上生成的私人令牌token

将本地hexo-blog提交到github的hexo-blog上

  • 使用git add .和git commit命令提交本地仓库的更改
  • 使用git push提交到github上
  • 观察github上的action运行情况
  • 观察gitee上的代码同步情况
  • 观察www.xxx.xxx、blog.xxx.xxx、xxx.xxx、[username].github.io、[username].gitee.io等网站部署情况

至此hexo-blog的自动化部署流程已经完成。

相关文章