使用github action发布hexo博客到云服务器

目录

• 搭建Hexo博客
• 安装主题hexo-theme-bamboo
• 修改博客名称等信息
• 添加github action发布
  • • 1. 在github中创建自己的博客仓库
    • 2. 设置Secrets
    • 3. 在/.github/workflows/下添加一个yml文件，可以进行自定义
• 另一种办法，直接fork
• 从博客园拉取之间创建的博客到新建的hexo
• 遇到的问题
  • • 1.阿里云登陆和docker push 时tag错误，问题描述参见docker tag error，解决办法参见GitHub Actions持续集成阿里云容器镜像服务（ACR），我后面这么写的
    • 2.go传入参数和secrets截断问题
• 博客github地址

搭建Hexo博客

环境

> node -v
v16.15.0
> npm -v
8.5.5

安装Hexo CLI

# 在你的博客文件夹根目录下下执行
npm install -g hexo-cli
hexo init blogname
cd blogname
hexo s
# 打开http://localhost:4000 即可浏览

安装主题hexo-theme-bamboo

hexo-theme-bamboo
我们不使用npm安装，直接将主题download到themes文件夹下
github安装

git clone https://github.com/yuang01/hexo-theme-bamboo.git

gitee安装

git clone https://gitee.com/yuang01/hexo-theme-bamboo.git

修改hexo根目录下的站点配置文件_config.yml，把主题改为hexo-theme-bamboo，通过主题文件夹下的config.yml配置主题即可，然后在\themes\hexo-theme-bamboo\删除.git文件夹
然后根据https://yuang01.github.io/或者作者博客地址来配置对应的样式或者widget

修改博客名称等信息

在_config.yml和\themes\hexo-theme-bamboo\_config.yml中将自己博客名称、网址信息等进行替换

添加github action发布

1. 在github中创建自己的博客仓库

然后在Settings/Secrets/Actions中New repository secret , 其中docker信息是在阿里云容器仓库中创建了一个个人实例(创建之后需要去/个人实例/访问凭证设置固定密码)，当然，你也可以使用其他的docker仓库，不过第2步的Login to Aliyun Container Registry (ACR)需要进行修改

2. 设置Secrets

表格

Name	Value	说明	举例
DOCKER_USERNAME	your docker username	docker仓库登陆用户名	spatxos
DOCKER_PASSWORD	your docker pwd	docker仓库固定密码	spatxospwd
HOST	your server ip	服务器IP	101.10.11.121
HOST_USERNAME	your server username	服务器ssh登陆账户名	spatxosdocker
HOST_PASSWORD	your server pwd	服务器ssh登陆密码	spatxosdockerpwd
HOST_PORT	your server ssh port	服务器ssh端口	22
DOCKER_REGISTRY	docker registry	docker仓库地址	registry.cn-hongkong.aliyuncs.com
DOCKER_REGISTRY_REGION	docker registry region id	docker仓库区域id	cn-hongkong
CNBLOGS_ISDOWN	Whether to pull blogs from cnblogs	本次执行是否从cnblogs拉取博客	true或false
CNBLOGS_COOKIE	cnblogs of cookie	cnblogs的cookie	__gads=ID=bbfxxxxxxxxxx
BLOG_NAME	blog of name	博客的名称，发布到docker或者服务器上创建的文件夹都将使用这个	spatxos

3. 在/.github/workflows/下添加一个yml文件，可以进行自定义

我写好了一个yml，是将hexo发布到阿里云的docker仓库，然后进行服务器部署，后期将会添加发布到github pages的yml

name: Build Docker Image

on:
push:
  tags:
    - "v*.*.*" # 后面每次更新提交，只有打上tag之后才会进行发布更新，减少actions执行次数
workflow_dispatch:

jobs:
build:
  env:
    CNBLOGS_ISDOWN: ${{secrets.CNBLOGS_ISDOWN}}
    CNBLOGS_COOKIE: ${{secrets.CNBLOGS_COOKIE}}
  runs-on: ubuntu-latest
  steps:
    - name: Checkout source
      uses: actions/checkout@v2
      with:
        ref: master

    - name: Setup Node.js
      uses: actions/setup-node@v1
      with:
        node-version: '16.15.0'

    - name: Set up Go 1.18.3
      if: ${{ env.CNBLOGS_ISDOWN == 'true' }}  # 是否从博客园下载，可通过更改CNBLOGS_ISDOWN的值进行提交时的下载控制
      uses: actions/setup-go@v1
      with:
        go-version: 1.18.3
      id: go
    - name: Pull blogs from cnblogs
      if: ${{ env.CNBLOGS_ISDOWN == 'true' }}  # 是否从博客园下载，可通过更改CNBLOGS_ISDOWN的值进行提交时的下载控制
      run: |
        cd source/_posts/
        echo $env.CNBLOGS_COOKIE |wc -L
        echo ${{env.CNBLOGS_COOKIE}} |wc -L
        go run downmyblogs.go -cookie ${{env.CNBLOGS_COOKIE}}
        ls -la

    - name: Setup Hexo
      run: |
        npm install hexo-cli -g
        npm install hexo-generator-search --save
        npm install hexo-generator-feed --save
        npm i hexo-wordcount
        npm install
    # get image tag name
    - name: Get Image Tag Name
      run: |
        if [ x${{ github.event.inputs.tag }} == x"" ]; then
          echo "TAG_NAME=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
        else
          echo "TAG_NAME=${{ github.event.inputs.tag }}" >> $GITHUB_ENV
        fi
    - name: Login to Aliyun Container Registry (ACR)
      uses: aliyun/acr-login@v1
      with:
        login-server: "${{ secrets.DOCKER_REGISTRY }}"
        region-id: "${{ secrets.DOCKER_REGISTRY_REGION }}"  # 3
        username: "${{ secrets.DOCKER_USERNAME }}"
        password: "${{ secrets.DOCKER_PASSWORD }}"
    - name: Deploy and Build Image
      run: |
        hexo clean
        hexo deploy
        ls -la
        pwd
        docker build -t "${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}" -f Dockerfile .
    - name: Push Image
      run: |
        docker images
        docker push "${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}"

# Docker 自动部署
deploy-docker: 
  needs: [build]
  name: Deploy Docker
  runs-on: ubuntu-latest
  steps:
    # get image tag name
    - name: Get Image Tag Name
      run: |
        if [ x${{ github.event.inputs.tag }} == x"" ]; then
          echo "TAG_NAME=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
        else
          echo "TAG_NAME=${{ github.event.inputs.tag }}" >> $GITHUB_ENV
        fi
    - name: Deploy
      uses: appleboy/ssh-action@master
      with:
        host: ${{ secrets.HOST }} # 服务器ip
        username: ${{ secrets.HOST_USERNAME }} # 服务器登录用户名
        password: ${{ secrets.HOST_PASSWORD }} # 服务器登录密码
        port: ${{ secrets.HOST_PORT }} # 服务器ssh端口
        script: |
          docker info
          echo $(docker ps -aqf "name=${{secrets.BLOG_NAME}}-blog")
          docker stop $(docker ps -aqf "name=${{secrets.BLOG_NAME}}-blog")
          docker container rm ${{secrets.BLOG_NAME}}-blog
          docker rmi ${{secrets.BLOG_NAME}}-blog
          echo 查看是否成功删除${{secrets.BLOG_NAME}}-blog
          docker ps -a
          echo 从harbor拉取docker镜像
          chmod 777 /root/${{secrets.BLOG_NAME}}-blog/html/
          docker pull ${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}
          docker tag ${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}} ${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}
          docker run -it --rm -d -p 80:80 --name ${{secrets.BLOG_NAME}}-blog ${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog
          docker cp ${{secrets.BLOG_NAME}}-blog:/usr/share/nginx/html /root/${{secrets.BLOG_NAME}}-blog/html
          docker system prune -f
          echo docker容器启动成功

另一种办法，直接fork

现在我已经把仓库创建好并且上传到了github，仓库地址https://github.com/spatxos/spatxos-blog，可以直接进行fork，然后去阿里云容器仓库中创建一个个人实例，购买或者使用一个云服务器，在github仓库中填写一下Secrets表格中Secrets即可

从博客园拉取之间创建的博客到新建的hexo

在Secrets表格中设置好CNBLOGS_ISDOWN是true，然后去登陆博客园，F12，随便找一个xhr类型的请求，查找对应的cookie，然后到/source/_posts下执行一下go run convertcnblogbookie.go -cookie "替换成你的cookie"将会获得一个输出的新cookie，将新的cookie作为CNBLOGS_COOKIE的value写入进去（github action中使用secrets时，不能包含某些特殊字符，否则会被截断，所以这次执行其实是对特殊字符的替换，后面拉取博客时再替换回来）
在每次执行提交时，将会把docker里面的hexo静态页面映射到服务器的/root/${{BLOG_NAME}}-blog/html文件夹下，首次拉取博客园的文章之后，如何博客园文章未进行更新，我们可以更改一下CNBLOGS_ISDOWN为false，那么就不会从博客园拉取了，原本的文件还会存在，不会进行覆盖

遇到的问题

1.阿里云登陆和docker push 时tag错误，问题描述参见docker tag error，解决办法参见GitHub Actions持续集成阿里云容器镜像服务（ACR），我后面这么写的

docker build -t "${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}" -f Dockerfile .

2.go传入参数和secrets截断问题

  go传入参数使用conf来做，secrets截断问题通过先替换掉会截断的字符，然后使用时替换回去

博客github地址