使用 Git 操作触发
适用于普通用户
本指南提供通过 Git 操作触发 PAC pipeline 的 Git 命令示例。
本指南展示了常用于通过 Git 提供方事件触发 PAC pipeline 的 Git 命令。
PAC 触发的工作原理
PAC 使用来自 Git 提供方(如 GitHub 或 GitLab)的 webhook 来检测事件:
- Webhook 配置:当你创建 Repository CR 时,PAC 会自动在你的 Git 提供方中配置一个 webhook
- 事件检测:当事件发生时(push、pull request、评论),Git 提供方会向 PAC controller 发送 webhook
- Pipeline 匹配:PAC controller 会根据你的 PipelineRun 文件中的注解匹配该事件
- Pipeline 执行:如果找到匹配项,PAC 会在你的集群中创建一个 PipelineRun
有关 pipeline 定义和事件注解的更多详情,请参见 在 Git 中定义 PipelineRun。
目录
测试 Push 触发基本 PushPush 到特定分支空提交测试 Merge Request 触发创建 Merge Request更新 Merge Request对 Merge Request 执行 Force Push使用评论命令通过评论触发常见评论命令检查 Pipeline 状态查看 PipelineRun查看 Pipeline 日志检查最新的 PipelineRunGit 操作故障排查检查当前分支验证最新提交检查远程分支查看 Git 远程仓库与远程仓库强制同步下一步测试 Push 触发
基本 Push
进行更改并 push 以触发 pipeline:
Push 到特定分支
创建并 push 到功能分支:
空提交
在没有代码更改的情况下触发 pipeline:
测试 Merge Request 触发
创建 Merge Request
-
创建一个功能分支:
-
通过 Git 提供方 UI 创建一个目标为
main分支的 Pull/Merge Request
更新 Merge Request
push 更多提交以再次触发 pipeline:
对 Merge Request 执行 Force Push
重写历史并执行 force push:
注意:请使用 --force-with-lease 而不是 --force,以防止覆盖他人的工作。
使用评论命令
评论命令仅适用于 Merge Requests(Pull Requests),不适用于普通提交或 push 事件。
通过评论触发
-
在 Git 提供方 UI 中打开你的 Pull/Merge Request
-
添加包含以下命令的评论:
或
- PAC 会检测该评论并触发相应的 pipeline
常见评论命令
注意:具体命令取决于你的 pipeline 配置。你可以在 PipelineRun 文件中的 on-comment 注解里定义命令。
检查 Pipeline 状态
查看 PipelineRun
检查 pipeline 是否已触发:
查看 Pipeline 日志
查看特定 PipelineRun 的日志:
或者实时跟踪日志:
检查最新的 PipelineRun
获取最新的 PipelineRun:
Git 操作故障排查
检查当前分支
确认你位于正确的分支上:
验证最新提交
检查最新提交的详细信息:
检查远程分支
确认远程仓库中存在该分支:
查看 Git 远程仓库
检查已配置的远程 URL:
与远程仓库强制同步
将本地分支重置为与远程一致:
警告:这将丢弃本地更改。
下一步
- 在 Git 中定义 PipelineRun - 了解如何定义 pipeline 并配置事件触发器
- 指南 - 仓库设置步骤说明
- 常见问题 - 故障排查指南