入参
| 参数 | 描述 | 是否必传 | 默认值 |
|---|---|---|---|
gitee-username | Gitee用户名 | 是 | - |
gitee-password | Gitee密码 | 是 | - |
gitee-repo | Gitee仓库(严格区分大小写) | 是 | - |
branch | 要部署的分支 | 否 | master |
directory | 要部署的分支上的目录 | 否 | '' |
https | 是否强制使用https | 否 | true |
示例
在GitHub的仓库创建 .github/workflows/ 文件夹并且创建一个**sync.yml** 文件
| |
先使用 wearerequired/git-mirror-action 将 GitHub 仓库同步到 Gitee 仓库,再使用 yanglbme/gitee-pages-action 实现 Gitee Pages 的自动部署。
运行需要在 GitHub 项目的 Settings -> Secrets 路径下配置好 **PRIVATE **以及 PASSWORD 两个密钥。其中:
**PRIVATE **: 存放你的
id_rsa私钥。PASSWORD: 存放你的Gitee账户密码。
1. 配置PRIVATE
生成SSH密钥
1ssh-keygen -t rsa -C "name"“name"是任意指定的标识
- 获取公钥
1cat ~/.ssh/id_rsa.pub- 绑定
Gitee
复制公钥,通过仓库主页个人图像下拉设置->SSH公钥添加公钥
测试
打开终端输入:
1ssh -T git@gitee.com显示如下图则成功

绑定
Github复制公钥,通过仓库主页个人图像下拉Setting->SSH and GPG keys添加公钥
测试
打开终端输入:
1ssh -T git@github.com显示如下图则成功

配置
获取私钥
1cat ~/.ssh/id_rsa复制私钥,在仓库的Setting->Secrets路径下命名PRIVATE,Value添加私钥(记得复制全部内容)
2. 配置PASSWORD
在仓库的Setting->Secrets路径下命名PASSWORD,Value添加**
Gitee**账户密码。
如果一切配置正常,并成功触发 Gitee Pages Action ,我们可能会收到一封来自 Gitee 的告警邮件/站内信。放心,这是 GitHub Action 程序帮我们登录到 Gitee 官网,并为我们点击了项目的部署按钮。
FAQ
问题 1:遇到短信验证码导致无法自动部署,怎么解决?
因为 Gitee Pages Action 使用的是 GitHub 自家的服务器(美国),在这种情况下,当 Action 自动 帮我们登录 Gitee 的时候,会触发 Gitee 帐号异常登录告警,提示用户在非正常的 IP 地址登陆 Gitee,需要输入验证码。
解决方案是:关注「码云 Gitee」 微信公众号,绑定个人微信到码云帐号。这样 Action 在登录的过程中,Gitee 就不会下发短信验证码,而是通过「码云 Gitee」公众号给我们发送一个登录通知,Action 就能成功登录了。
问题 2:报 deploy error occurred, message: ‘NoneType’ object has no attribute ‘group’ 错误,怎么办?
报了这个错误,说明 Action 已经成功帮我们登录 Gitee 帐号了,但在访问 Gitee Repo 的过程中出现问题。
这种情况,一般是 Gitee Pages Action 的参数配置错误导致,请仔细检查你的配置信息。
注意:
gitee-repo参数严格区分大小写,请准确填写,比如doocs/advanced-java,当你写成doocs/Advanced-java的时候,是访问不到的,不信你可以试试访问:https://gitee.com/Doocs/Advanced-java