张翔
123 lines
4.3 KiB
Python
123 lines
4.3 KiB
Python
#!/usr/bin/env python3
|
||
"""
|
||
Woodpecker CI 自动触发诊断工具
|
||
排查 CI 无法自动触发的可能原因
|
||
"""
|
||
|
||
import yaml
|
||
from pathlib import Path
|
||
|
||
|
||
def diagnose_auto_trigger(config_path):
|
||
"""诊断自动触发问题"""
|
||
|
||
with open(config_path, 'r', encoding='utf-8') as f:
|
||
config = yaml.safe_load(f)
|
||
|
||
print("="*70)
|
||
print("Woodpecker CI 自动触发诊断")
|
||
print("="*70)
|
||
|
||
print("\n🔍 可能导致 CI 无法自动触发的原因:")
|
||
print("-"*70)
|
||
|
||
reasons = [
|
||
{
|
||
"原因": "1. Webhook 未配置或配置错误",
|
||
"检查": "Git 仓库设置 → Webhooks → 确认有指向 Woodpecker CI 的 Webhook",
|
||
"解决": "添加 Webhook，URL 格式: http://woodpecker-server/hook"
|
||
},
|
||
{
|
||
"原因": "2. Woodpecker CI 仓库未激活",
|
||
"检查": "Woodpecker CI Web 界面 → 确认仓库已激活",
|
||
"解决": "在 Woodpecker CI 中激活仓库"
|
||
},
|
||
{
|
||
"原因": "3. 分支保护或限制",
|
||
"检查": "Woodpecker CI 仓库设置 → 查看 'Trusted' 和 'Protected' 设置",
|
||
"解决": "取消分支保护或添加受信任的分支"
|
||
},
|
||
{
|
||
"原因": "4. 配置文件语法错误",
|
||
"检查": "使用 yamllint 或在线 YAML 验证器检查配置文件",
|
||
"解决": "修复 YAML 语法错误"
|
||
},
|
||
{
|
||
"原因": "5. when 条件过于严格",
|
||
"检查": "检查配置文件中的 when 条件",
|
||
"解决": "确保 when 条件包含正确的分支和事件"
|
||
},
|
||
{
|
||
"原因": "6. Woodpecker CI 全局配置限制",
|
||
"检查": "检查 Woodpecker CI 的全局配置文件",
|
||
"解决": "修改全局配置，允许自动触发"
|
||
},
|
||
{
|
||
"原因": "7. Git 仓库权限问题",
|
||
"检查": "确认 Woodpecker CI 有访问仓库的权限",
|
||
"解决": "重新授权 Woodpecker CI 访问仓库"
|
||
},
|
||
{
|
||
"原因": "8. 提交信息包含跳过关键词",
|
||
"检查": "检查提交信息是否包含 [skip ci], [ci skip] 等",
|
||
"解决": "避免在提交信息中使用跳过关键词"
|
||
}
|
||
]
|
||
|
||
for i, reason in enumerate(reasons, 1):
|
||
print(f"\n{reason['原因']}")
|
||
print(f" 检查: {reason['检查']}")
|
||
print(f" 解决: {reason['解决']}")
|
||
|
||
# 检查配置文件中的 when 条件
|
||
print("\n\n📋 当前配置的 when 条件:")
|
||
print("-"*70)
|
||
|
||
for step_name, step_config in config.get('steps', {}).items():
|
||
if not isinstance(step_config, dict):
|
||
continue
|
||
|
||
when = step_config.get('when', {})
|
||
if not when:
|
||
continue
|
||
|
||
if isinstance(when, dict):
|
||
events = when.get('event', [])
|
||
branches = when.get('branch', [])
|
||
if events or branches:
|
||
print(f"\n步骤: {step_name}")
|
||
if events:
|
||
print(f" 事件: {events}")
|
||
if branches:
|
||
print(f" 分支: {branches}")
|
||
elif isinstance(when, list):
|
||
print(f"\n步骤: {step_name}")
|
||
for condition in when:
|
||
if isinstance(condition, dict):
|
||
events = condition.get('event', [])
|
||
branches = condition.get('branch', [])
|
||
if events:
|
||
print(f" 事件: {events}")
|
||
if branches:
|
||
print(f" 分支: {branches}")
|
||
|
||
print("\n\n💡 快速排查步骤:")
|
||
print("="*70)
|
||
print("1. 访问 Git 仓库设置 → Webhooks")
|
||
print(" - 确认有 Woodpecker CI 的 Webhook")
|
||
print(" - 查看 'Recent Deliveries' 是否有发送记录")
|
||
print("\n2. 访问 Woodpecker CI Web 界面")
|
||
print(" - 确认仓库已激活")
|
||
print(" - 检查仓库设置中的 'Trusted' 选项")
|
||
print("\n3. 查看提交记录")
|
||
print(" - 确认提交信息不包含 [skip ci] 等关键词")
|
||
print("\n4. 手动触发测试")
|
||
print(" - 在 Woodpecker CI 中手动触发 Pipeline")
|
||
print(" - 观察是否能够正常执行")
|
||
|
||
print("\n" + "="*70)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
diagnose_auto_trigger(".woodpecker.yml")
|