Closed sealos-ci-robot closed 1 year ago
gh-rebot 是一个针对 sealos 项目的 GitHub rebot,用于自动执行一些常见操作,如发布新版本等。本文档将介绍该 rebot 的配置文件,并提供相应的使用指南。
下面是 gh-rebot 项目的配置文件:
version: v1 debug: true bot: prefix: /sealos action: printConfig: true release: retry: 15s action: Release allowOps: - cuisongliu spe: _ allowOps: - sealos-ci-robot - sealos-release-robot email: sealos-ci-robot@sealos.io username: sealos-ci-robot repo: org: true name: labring/sealos fork: cuisongliu/sealos message: success: | 🤖 says: The action {{.Body}} finished successfully 🎉 format_error: | 🤖 says: ‼️ The action format error, please check the format of this action. permission_error: | 🤖 says: ‼️ The action no has permission to trigger. release_error: | 🤖 says: ‼️ The action release error.
version
debug
action
printConfig
release
retry
allowOps
bot
prefix
/
spe
/release
_
email
username
repo
org
name
fork
message
success
format_error
permission_error
release_error
使用 gh-rebot 时,需要遵循以下步骤:
.github
gh-bot.yml
/sealos
之前的操作已经废弃,使用 https://github.com/labring/sealos/blob/d528d6be713b9b9cf92169e5822d354d29fffb9d/.github/workflows/release.yml#L72
如果需要发布新版本,请在 issue 或 PR 中使用以下命令:
/sealos_release
根据配置文件中的消息模板,gh-rebot 会在执行操作过程中遇到错误时返回相应的提示消息。例如:
在遇到错误时,请根据提示信息进行相应的调整。
- name: Gh Rebot for Sealos uses: labring/gh-rebot@v0.0.6-rc6 with: version: v0.0.6-rc6 env: SEALOS_TYPE: "/comment" GH_TOKEN: "${{ secrets.GH_PAT }}"
版本支持:
[x] 支持release
目标分支为release-v1.2,如果没有则默认为main分支,该功能v0.0.7-rc1支持
release-v1.2
main
SEALOS_TYPE: "/comment" # 评论触发 example:
SEALOS_TYPE: "/comment"
/release v1.2.1 /release v1.2.3 release-v1.2
[x] 支持PR文本替换回复
该功能v0.0.6 支持 SEALOS_TYPE: "pr_comment" # PR文本替换回复 SEALOS_FILENAME: "README.md" # PR文本替换回复文件位置 SEALOS_REPLACE_TAG: "TAG" # 寻找标记,根据这个标记进行替换
该功能v0.0.6 支持
SEALOS_TYPE: "pr_comment"
SEALOS_FILENAME: "README.md"
SEALOS_REPLACE_TAG: "TAG"
[x] issue创建comment
该功能v0.0.7-rc2支持
SEALOS_TYPE: "issue_comment_reply"
SEALOS_COMMENT: "/xxxx"
SEALOS_ISREPLY: "true"
[x] issue自动创建
SEALOS_TYPE: "issue_renew"
SEALOS_ISSUE_TITLE: "dxxxx"
SEALOS_ISSUE_BODY: "xxxx"
SEALOS_ISSUE_BODYFILE: "README.md"
SEALOS_ISSUE_LABEL: "dayly-report"
SEALOS_ISSUE_TYPE: "day"
FFFFFFF_TEST
gh-rebot 项目说明文档
gh-rebot 是一个针对 sealos 项目的 GitHub rebot,用于自动执行一些常见操作,如发布新版本等。本文档将介绍该 rebot 的配置文件,并提供相应的使用指南。
配置文件
下面是 gh-rebot 项目的配置文件:
配置文件详解
version
- 版本标识,当前为 v1。debug
- 是否开启调试模式,设置为 true 时开启。action
- action配置。printConfig
- 是否打印配置信息,设置为 true 时打印。release
- 发布配置。retry
- 重试间隔,例如:15s。action
- 执行动作,例如:Release。allowOps
- 允许触发发布操作的用户名列表。bot
- 机器人配置。prefix
- 机器人命令前缀,用于识别命令。默认值/
,如果设置为/
则spe
失效。命令为/release
spe
- 机器人命令分隔符,用于识别命令。默认值_
allowOps
- 允许操作的用户名列表。email
- 机器人邮箱。username
- 机器人用户名。repo
- 仓库配置。org
- 是否为组织仓库,设置为 true 时表示是组织仓库。name
- 仓库名称。fork
- fork 的仓库名称。message
- 消息配置。success
- 成功消息模板。format_error
- 格式错误消息模板。permission_error
- 权限错误消息模板。release_error
- 发布错误消息模板。使用文档
使用 gh-rebot 时,需要遵循以下步骤:
.github
目录gh-bot.yml
文件。/sealos
)在 GitHub 仓库的 issue 或 PR 中发表评论,以触发相应的操作。变更日志操作
之前的操作已经废弃,使用 https://github.com/labring/sealos/blob/d528d6be713b9b9cf92169e5822d354d29fffb9d/.github/workflows/release.yml#L72
发布操作
如果需要发布新版本,请在 issue 或 PR 中使用以下命令:
错误处理
根据配置文件中的消息模板,gh-rebot 会在执行操作过程中遇到错误时返回相应的提示消息。例如:
在遇到错误时,请根据提示信息进行相应的调整。
如何使用Action
版本支持:
[x] 支持release
SEALOS_TYPE: "/comment"
# 评论触发 example:[x] 支持PR文本替换回复
[x] issue创建comment
SEALOS_TYPE: "issue_comment_reply"
# issue创建comment,支持回复SEALOS_FILENAME: "README.md"
# issue回复内容如果多可以写文件SEALOS_COMMENT: "/xxxx"
# comment的内容SEALOS_ISREPLY: "true"
# 是否回复,根据当前的comment的内容追加[x] issue自动创建
SEALOS_TYPE: "issue_renew"
# issue创建comment,支持回复SEALOS_ISSUE_TITLE: "dxxxx"
# issue的titleSEALOS_ISSUE_BODY: "xxxx"
# issue内容SEALOS_ISSUE_BODYFILE: "README.md"
# issue内容如果多可以写文件SEALOS_ISSUE_LABEL: "dayly-report"
# 新增issue的labelSEALOS_ISSUE_TYPE: "day"
# day和week , 会在titles上自动加上日期Roadmap