本文章首发于 https://szhshp.org/tech/2020/03/15/hexocicd.html 转载请注明
2020-03-15: 以下两个方法测试通过
开发背景
- 为知笔记的搜索太慢了。
- 我想要迁移笔记。
- 我想要迁移笔记。
- 我想要迁移笔记。
- 我想要迁移笔记。
- 我想要迁移笔记。
- 我想要迁移笔记。
- 我想要迁移笔记。
- 我想要迁移笔记。
- 我很需要迁移笔记。
- 为知笔记的搜索太慢了。
- 希望能有一个免费的笔记托管平台。
Github & Coding 的服务差异
主要配置:
- 一个 Source Repo, 用于存放源码
- 一个 Release Repo, 用于存放 build 之后的 pages 文件
Pages 服务的限制:
- Github 的 pages 服务 repo 必须设置为开源, 因此 Source Repo 可以设置为闭源
- Coding 的 pages 服务 repo 没有任何限制, 所以 两个都可以设置为闭源.
其他 CI/CD 服务的限制:
- Travis 可以用于 Github, 但是不能用于国内的 Coding
- https://travis-ci.org 不支持私有仓库, https://travis-ci.com 才支持选择私有仓库 (但是对于私有仓库只有 100 次次数限制)
最终决定:
- Github 端使用 Github Actions
- Coding 端使用新开放的
持续集成功能, 类似 Github Actions
Hexo 站点搭建
(略)
Github 操作方法
主要目的:
- 创建一个 Github Action
- 当我 push 代码的时候自动 build
- 由于 hexo 自身就有用 deploy 的功能, 所以只需要在 push 的时候执行以下
hexo deploy将生成的文件全部部署到 Release Repo - 需要实现从 Source Repo 中提交到 Release Repo 的认证
- 最大的麻烦就是这一步
认证模式: SSH
生成一对公钥和私钥
公钥放置在 请求操作端: 本机或者远程服务器 (一般放置在 .ssh/rsa_id)
私钥放置在 目标端, 可以放在两个地方:
- 如果放置在用户级别的私钥处设置 (Github-Setting-SSH and GPG Keys), 那么可以不需要账号密码操作整个用户的所有 repo
- 如果放置在单个 repo 的 deploy key 中, 那么如果拥有这个私钥, 就可以不需要账号密码操作单个 repo
设置 SSH
我们这里实现单个 repo 的 SSH 访问
首先本地使用 ssh-keygen 可以生成一个私钥, 一个公钥
首先跑到 bash 里面执行 ssh-genkey
如果是 windows 系统, 就可以直接跑到
${GitDirectory}\usr\bin\ssh-keygen.exe然后使用 管理员权限+CMD 执行
最后生成了一个公钥 TESTKEY.PUB , 一个私钥 TESTKEY .
将生成的 私钥全部内容 (不要担心格式) 放置在 Source Repo 的 Serect 里面, 然后取一个名字, 比如我给他取名成 DEPLOY_KEY
然后将 公钥全部内容 放置到 Release Repo 的 Deployed Keys 里面, 并且要赋予读写的权限, 公钥的名字不重要
这个公钥并不是放置在用户的公钥设置里面, 我们仅仅对 Release Repo 进行操作
Config.yml 设置
这一段代码放置在 Source Repo 里面. 下方设置了对应的 Release Repo 的名字以及对应的分支名字.
deploy:
type: git
repo: git@github.com:szhielelp/notebook-release.git # 改成你自己的 repo 地址，需要设置 SSH 地址。
branch: master # 改成你自己的分支名称。
设置完之后本地测试一下
hexo d
因为对应的私钥同时也保存在本地, 所以应该可以部署成功.
创建 Github Action
跑到 Github Action 的页面创建一个新的 action, 然后这个 action 就会被放置在 Repo 的根目录的 .github/workflows/nodejs.yml 文件夹下面
name: Notebook Deployment
on: [push]
jobs:
build:
runs-on: ubuntu-latest
strategy:
matrix:
node-version: [10.x]
steps:
- name: Deployment Start
uses: actions/checkout@v1
- name: Setup Node ${{matrix.node-version}}
uses: actions/setup-node@v1
with:
node-version: ${{matrix.node-version}}
- name: Setup Git Env
env:
DEPLOY_KEY: ${{secrets.DEPLOY_KEY}} # 这里写上刚才在 Secret 里面设置的变量名
run: |
mkdir -p ~/.ssh/
echo "$DEPLOY_KEY" > ~/.ssh/id_rsa # 将私钥的全部内容输出到一个文件里面。
chmod 600 ~/.ssh/id_rsa # 修改对应私钥文件的权限。
ssh-keyscan github.com >> ~/.ssh/known_hosts # 将 Github.com 添加到已知文件列表。
git config --global user.name "你的 Github 用户名" # 设置一下提交的姓名和邮箱。
git config --global user.email "你的 Github 邮箱"
- name: Setup Hexo CI
run: |
npm i -g hexo-cli # 全局安装需要的库。
npm i
- name: Setup other package
run: |
npm install
- name: Deploy
run: |
rm -rf .deploy_git
hexo g && hexo deploy # 开始部署
rm ~/.ssh/id_rsa
Coding 操作方法
主要目的基本相同, 但是选用的一个完全不同的认证方法
SSH 认证模式的问题
理论上按照 github 的模式可以实现, 但是 SSH 模式请求的时候一直报 Permission denied (publickey)
我说尝试过的方法:
- 修改权限为 7, Github 上方脚本里面设置的权限为 6
- 生成一对完全不同的新的公钥
- 使用 ssh-add 将添加公钥到设备
- 公钥对于 git.coding.net 无效，应该改成 e.coding.net
最终发现用户级别公钥可以实现本地的部署, 但是无法实现 repo 之间的部署, 一直出现 Permission denied (publickey)
最终决定选用另一种认证方式.
认证模式: Token
首先创建一个 token
-
是在 repo - 开发者选项 - 项目令牌里面生成
- 这个东西生成一次就无法再看到了, 一定要复制保存
Token 也可以放在两个地方： 一个是用户级的 Token 可以操作所有 Repo， 一个是 Repo 级的 token 只能操作单个 repo
Config.yml 设置
同样的, 在 Source Repo 那边设置:
注意, 下方需要设置的是 HTTPS 的链接, 然后需要将你得到的 token 的账号密码扔进去.
deploy:
type: git
repo: https://[token name]:[token password]@e.coding.net/szhshp/szhshp-notebook-release.git
branch: master
同样现在本地测试一下, 这种模式上并没有使用任何的 SSH 访问, 直接就可以部署成功
创建持续集成任务
因为这个地方没有使用 SSH 访问, 并且 token 已经设置到了上方的链接当中, 直接 push 即可.
pipeline {
agent any
stages {
stage('检出') {
steps {
checkout([$class: 'GitSCM', branches: [[name: env.GIT_BUILD_REF]],
userRemoteConfigs: [[url: env.GIT_REPO_URL, credentialsId: env.CREDENTIALS_ID]]])
}
}
stage('构建') {
steps {
echo '构建中。..'
sh '''
git config --global user.name xxxxx
git config --global user.email xxxxx@sina.com
npm i -g hexo-cli
npm i
rm -rf .deploy_git
hexo g && hexo deploy
'''
echo '构建完成。'
}
}
}
environment {
HOSTINFO = 'Host coding.net IdentityFile ~/.ssh/id_rsa.coding User szhshp'
}
}
Nice Work !!!
花了我三天, 搞定了累死我了
Coding 单个 Repo 多仓库操作方法。
Coding 更新后, 一个项目里面可以有多个仓库
实际上就是多个 Repo
在这种情况下完全可以只用一个项目控制 Source Repo 和 Release Repo
处理方法很简单:
- 因为是同一个 Repo, 在 Repo 里面创建一个项目 Token
- 将 _config.yml 里面 deploy 一列的 repo 改为 release 仓库对应的 HTTPS 连接, 记得带上 token
deploy:
type: git
repo: https://{token name}:{token pswd}@e.coding.net/ssszzz/notebook/release.git
branch: master
- CI 脚本如上文设置 Coding 操作方法
- 这样子以后就不需要了来回跑两个不同的 repo 了
参考文献
- https://www.iots.vip/post/hexo-ci-wiki.html
- https://segmentfault.com/a/1190000002900848
- https://blog.csdn.net/qq_33619378/article/details/81191564
- https://zhuanlan.zhihu.com/p/26625249
- https://hexo.io/zh-cn/docs/commands.html
- https://www.jianshu.com/p/5691815b81b6
- https://www.voidking.com/dev-hexo-travis-ci/
- https://www.cnblogs.com/milovetingting/p/12159100.html
- https://hdj.me/github-actions-hexo-cicd/
- https://yanyinhong.github.io/2017/05/02/How-to-insert-image-in-hexo-post/
