ITPub博客

首页 > 数据库 > 数据库开发技术 > 一款实用的 GitHub Actions 小工具:Gitee Pages Actions

一款实用的 GitHub Actions 小工具:Gitee Pages Actions

原创 数据库开发技术 作者:Doocs 时间:2020-05-25 08:40:40 0 删除 编辑

使用 GitHub Pages 时,每当项目有更新,GitHub 会自动帮我们重新部署 GitHub Pages。对于国内的 Gitee Pages,一般情况下无法自动部署,除非我们开通 Gitee Pages Pro 功能。而 Pro 功能的开通,需要满足以下其中一个条件:

•花钱开通 Pro 功能,¥ 99/年。•Gitee 项目足够优秀,得到 Gitee 官方的推荐,那么 Gitee 就会提示“您的项目为推荐项目,已自动为您开通 Gitee Pages Pro”。

为了帮助更多朋友实现 Gitee Pages 的自动部署,我开发了 Gitee Pages Action[1],只需要在项目的 Settings 页面下配置 keys,然后在 .github/workflows/ 下创建一个工作流,引入一些配置参数即可。

目前,Doocs 旗下的多个仓库都使用了 Gitee Pages Action 成功进行自动部署,如:jvm[2], advanced-java[3]。若有使用上的问题,可以直接在文章底下评论区留言,也可以到 Issues[4] 区反馈。

注:首次需要手动登录 Gitee 点击构建。

项目地址

https://github.com/yanglbme/gitee-pages-action



入参

参数 描述 是否必传 默认值
gitee-username Gitee 用户名 是 -
gitee-password Gitee 密码 是 -
gitee-repo Gitee 仓库 是 -
branch 构建的分支 否 master
directory 构建的目录 否 ''
https 是否强制 HTTPS 否 true

示例

以下是一个完整示例。

在你的 GitHub 仓库 .github/workflows/ 文件夹下创建一个 sync.yml 文件,内容如下:

name: Sync
on: push: branches: [ master ]
jobs: build: runs-on: ubuntu-latest steps: - name: Sync to Gitee uses: wearerequired/git-mirror-action@master env: # 注意在 Settings->Secrets 配置 GITEE_RSA_PRIVATE_KEY SSH_PRIVATE_KEY: ${{ secrets.GITEE_RSA_PRIVATE_KEY }} with: # 注意替换为你的 GitHub 源仓库地址 source-repo: "git@github.com:doocs/advanced-java.git" # 注意替换为你的 Gitee 目标仓库地址 destination-repo: "git@gitee.com:Doocs/advanced-java.git"
- name: Build Gitee Pages uses: yanglbme/gitee-pages-action@master with: # 注意替换为你的 Gitee 用户名 gitee-username: yanglbme # 注意在 Settings->Secrets 配置 GITEE_PASSWORD gitee-password: ${{ secrets.GITEE_PASSWORD }} # 注意替换为你的 Gitee 仓库 gitee-repo: doocs/advanced-java

先使用 wearerequired/git-mirror-action 将 GitHub 仓库同步到 Gitee 仓库,再使用 yanglbme/gitee-pages-action实现 Gitee Pages 的自动部署。

请确保在 GitHub 项目的 Settings -> Secrets 路径下配置好 GITEE_RSA_PRIVATE_KEY 以及 GITEE_PASSWORD 两个密钥。其中:

•GITEE_RSA_PRIVATE_KEY: 存放你的 id_rsa 私钥。•GITEE_PASSWORD: 存放你的 Gitee 账户密码。



如果一切配置正常,并成功触发 Gitee Pages Action,我们可能会收到一封来自 Gitee 的告警邮件/站内信。放心,这是 GitHub Action 程序帮我们登录到 Gitee 官网,并为我们点击了项目的部署按钮。



引用链接

[1] Gitee Pages Action: https://github.com/marketplace/actions/gitee-pages-action
[2] jvm: https://github.com/doocs/jvm/blob/master/.github/workflows/sync.yml
[3] advanced-java: https://github.com/doocs/advanced-java/blob/master/.github/workflows/sync.yml
[4] Issues: https://github.com/yanglbme/gitee-pages-action/issues




长按识别下图二维码,关注公众号「Doocs开源社区」,第一时间跟你们分享好玩、实用的技术文章与业内最新资讯。



原文作者:Doocs;如有侵权,请联系管理员删除。

请登录后发表评论 登录
全部评论

注册时间:2019-09-18

  • 博文量
    77
  • 访问量
    26524