#使用 Git 操作触发

本指南展示了通过 Git 提供商事件触发 PAC 流水线的常用 Git 命令。

#测试 Push 触发

#基本 Push

修改文件并推送以触发流水线：

echo "test" >> test.txt
git add test.txt
git commit -m "Test push trigger"
git push origin main

#推送到指定分支

创建并推送到 feature 分支：

git checkout -b feature/new-feature
echo "feature code" >> feature.txt
git add feature.txt
git commit -m "Add new feature"
git push origin feature/new-feature

#空提交

无需代码变更即可触发流水线：

git commit --allow-empty -m "Trigger pipeline"
git push origin main

#测试合并请求触发

#创建合并请求

1. 创建 feature 分支：

   git checkout -b feature/test-mr
   echo "feature" >> feature.txt
   git add feature.txt
   git commit -m "Add feature for MR test"
   git push origin feature/test-mr

2. 通过您的 Git 提供商 UI 创建指向 main 分支的 Pull/Merge Request

#更新合并请求

推送更多提交以再次触发流水线：

echo "update" >> feature.txt
git add feature.txt
git commit -m "Update feature"
git push origin feature/test-mr

#强制推送合并请求

重写历史并强制推送：

git commit --amend --no-edit
git push --force-with-lease origin feature/test-mr

注意：使用 --force-with-lease 替代 --force，以防止覆盖他人的工作。

#使用评论命令

评论命令仅在合并请求（Pull Requests）中有效，普通提交或 push 事件无效。

#通过评论触发

1. 在 Git 提供商 UI 中打开您的 Pull/Merge Request

2. 添加包含命令的评论：

   /retest

或

/test

3. PAC 会检测该评论并触发对应流水线

#常用评论命令

注意：具体命令取决于您的流水线配置。您可以在 PipelineRun 文件的 on-comment 注解中定义命令。

#查看流水线状态

#查看 PipelineRuns

检查流水线是否被触发：

kubectl get pipelineruns -n <namespace>

#查看流水线日志

查看指定 PipelineRun 的日志：

tkn pipelinerun logs <pipelinerun-name> -n <namespace>

或实时跟踪日志：

tkn pipelinerun logs <pipelinerun-name> -n <namespace> -f

#查看最新 PipelineRun

获取最新的 PipelineRun：

kubectl get pipelineruns -n <namespace> --sort-by=.metadata.creationTimestamp | tail -1

#Git 操作故障排查

#检查当前分支

确认当前所在分支：

git branch --show-current

#查看最近一次提交

检查最近一次提交详情：

git log --oneline -1

#检查远程分支

确认远程是否存在该分支：

git branch -r | grep <branch-name>

#查看 Git 远程地址

查看配置的远程 URL：

git remote -v

#强制与远程同步

重置本地分支以匹配远程：

git fetch origin
git reset --hard origin/<branch-name>

警告：此操作会丢弃本地更改。

#后续步骤

• 维护流水线代码 - 学习如何定义流水线及配置事件触发
• 配置仓库 - 仓库设置指南
• 常见问题 - 故障排查指南