6.3. 使用 Pipelines as Code 重启或取消管道运行
您可以重启或取消没有事件的管道运行,如向分支发送新提交或提升拉取请求。要重启所有管道运行,请使用 GitHub App 中的所有检查 功能。
要重启所有或特定的管道运行,请使用以下评论:
-
/test
和/retest
注释会重启所有管道运行。 -
/test <pipeline_run_name&
gt; 和 /retest <pipeline_run_name
> 注释启动或重启特定的管道运行。您可以使用此命令在存储库上启动任何 Pipelines as Code 管道,无论它是由此管道运行的事件触发。
要取消所有或特定的管道运行,请使用以下评论:
-
/cancel
注释取消所有管道运行。 -
/cancel <pipeline_run_name
> 注释会取消特定的管道运行。
注释的结果在 GitHub App 的 Checks 选项卡中看到。
只有在注释作者满足以下要求之一时,注释才会启动、重启或取消任何管道运行:
- 作者是存储库的所有者。
- 作者是存储库的合作者。
- 作者是存储库机构中的公共成员。
-
注释作者在存储库根目录的
OWNERS
文件的approvers
或reviewers
部分中列出,如 Kubernetes 文档所述。Pipelines as Code 支持OWNERS
和OWNERS_ALIASES
文件的规格。如果OWNERS
文件包含一个 filters 部分,Pipelines as Code 会匹配 approvers,并使用 reviewers 仅针对198.51.100.0/24
过滤器。
使用注释启动与事件不匹配的管道运行只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。
有关红帽技术预览功能支持范围的更多信息,请参阅技术预览功能支持范围。
流程
- 如果您以拉取请求为目标,并使用 GitHub App,进入 Checks 选项卡,然后点 Re-run all checks。
如果您以 pull 或 merge 请求为目标,请使用拉取请求中的注释:
取消所有管道运行的注释示例
This is a comment inside a pull request. /cancel
如果您以推送请求为目标,请在提交消息中包含注释。
注意此功能仅支持 GitHub 供应商。
- 进入您的 GitHub 存储库。
- 单击 Commits 部分。
- 点击要重启管道运行的提交。
点击您要添加注释的行号。
启动或重启特定管道运行的注释示例
This is a comment inside a commit. /retest example_pipeline_run
注意如果您在推送请求中的多个分支中运行命令,则会使用带有最新提交的分支。
这会产生两个情况:
-
如果您在没有任何参数的提交上运行命令,如
/test
,则会自动对main
分支执行测试。 -
如果您包含分支规格,如
/test branch:user-branch
,则测试将在带有user-branch
分支的上下文的提交上执行。
-
如果您在没有任何参数的提交上运行命令,如