This repository was archived by the owner on Apr 2, 2025. It is now read-only.
Description robot 项目说明文档
robot 是一个针对 sealos 项目的 GitHub robot,用于自动执行一些常见操作,如发布新版本等。本文档将介绍该 robot 的配置文件,并提供相应的使用指南。
配置文件
下面是 robot 项目的配置文件:
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 - 版本标识,当前为 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 - 发布错误消息模板。
使用文档
使用 robot 时,需要遵循以下步骤:
将配置文件添加到项目的.github目录gh-bot.yml文件。
确保配置文件中的用户名、仓库名称等信息与实际情况相符。
根据配置文件中的命令前缀(如本例中的 /sealos)在 GitHub 仓库的 issue 或 PR 中发表评论,以触发相应的操作。
变更日志操作
之前的操作已经废弃,使用 https://github.com/labring/sealos/blob/d528d6be713b9b9cf92169e5822d354d29fffb9d/.github/workflows/release.yml#L72
发布操作
如果需要发布新版本,请在 issue 或 PR 中使用以下命令:
错误处理
根据配置文件中的消息模板,robot 会在执行操作过程中遇到错误时返回相应的提示消息。例如:
格式错误:‼️ 机器人说:操作格式错误,请检查此操作的格式。
权限错误:‼️ 机器人说:操作无权限触发。
发布错误:‼️ 机器人说:操作发布错误。
在遇到错误时,请根据提示信息进行相应的调整。
如何使用Action
- name : Gh Rebot for Sealos
uses : labring/robot@v2.0.0
with :
version : v2.0.0
env :
SEALOS_TYPE : " /comment"
GH_TOKEN : " ${{ secrets.GH_PAT }}"
版本支持 :
Roadmap
Reactions are currently unavailable
robot 项目说明文档
robot 是一个针对 sealos 项目的 GitHub robot,用于自动执行一些常见操作,如发布新版本等。本文档将介绍该 robot 的配置文件,并提供相应的使用指南。
配置文件
下面是 robot 项目的配置文件:
配置文件详解
version- 版本标识,当前为 v1。debug- 是否开启调试模式,设置为 true 时开启。action- action配置。printConfig- 是否打印配置信息,设置为 true 时打印。release- 发布配置。retry- 重试间隔,例如:15s。action- 执行动作,例如:Release。allowOps- 允许触发发布操作的用户名列表。bot- 机器人配置。prefix- 机器人命令前缀,用于识别命令。默认值/,如果设置为/则spe失效。命令为/releasespe- 机器人命令分隔符,用于识别命令。默认值_allowOps- 允许操作的用户名列表。email- 机器人邮箱。username- 机器人用户名。repo- 仓库配置。org- 是否为组织仓库,设置为 true 时表示是组织仓库。name- 仓库名称。fork- fork 的仓库名称。message- 消息配置。success- 成功消息模板。format_error- 格式错误消息模板。permission_error- 权限错误消息模板。release_error- 发布错误消息模板。使用文档
使用 robot 时,需要遵循以下步骤:
.github目录gh-bot.yml文件。/sealos)在 GitHub 仓库的 issue 或 PR 中发表评论,以触发相应的操作。变更日志操作
之前的操作已经废弃,使用 https://github.com/labring/sealos/blob/d528d6be713b9b9cf92169e5822d354d29fffb9d/.github/workflows/release.yml#L72
发布操作
如果需要发布新版本,请在 issue 或 PR 中使用以下命令:
错误处理
根据配置文件中的消息模板,robot 会在执行操作过程中遇到错误时返回相应的提示消息。例如:
在遇到错误时,请根据提示信息进行相应的调整。
如何使用Action
版本支持:
支持release
SEALOS_TYPE: "/comment"# 评论触发example:
支持文本替换回复
SEALOS_TYPE: "issue_comment"# PR文本替换回复SEALOS_FILENAME: "README.md"# PR文本替换回复文件位置SEALOS_COMMENT: "/xxxx"# comment的内容SEALOS_REPLACE_TAG: "TAG"# 寻找标记,根据这个标记进行替换SEALOS_ISREPLY: "true"# 是否回复,根据当前的comment的内容追加issue自动创建
入参:
SEALOS_TYPE: "issue_renew"# issue自动创建,支持回复commentSEALOS_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上自动加上日期,day代表一天一个issue会关闭之前的issue,week以此类推SEALOS_ISSUE_REPO: "sealos/sealos" # issue创建的仓库SEALOS_COMMENT_BODY: "xxxx" # issue创建后的comment内容SEALOS_COMMENT_BODYFILE: "xxxx" # issue创建后的comment内容如果多可以写文件返回参数:
Roadmap