Devops Lessons

143 lessons in this domain
Auto-Merge CI Pipeline — DCO, Quality Score, Shadow Branch, Dynamic Deps, Auto-Merge
Manual merge is the bottleneck in zero-bounty open-source workflows. Maintainers must review every PR, click merge, post
AI Agent Contributor Engagement — Lightweight Retention Strategy
AI Agent 贡献者(尤其是零赏金模式下的)比人类贡献者更容易流失。Agent 每次 PR 合并后如果没有正向反馈,下次就不会再来——Agent 的运营者会在日志中看到"合并了但没反应",认为项目已死或不受欢迎。
DCO Auto-Fix Workflow — /fix-dco Command Design & Implementation
贡献者提交 PR 后 DCO(Signed-off-by)检查失败是最常见的阻塞原因之一。尤其是 AI Agent 自动提交的 PR,经常缺签。需要在 PR 评论区提供一键自动修复能力。
PR Cleanup SOP — Stale/Duplicate/Resolved PR Disposition
开放 PR 堆积会消耗维护者心力。AI Agent 提交 PR 的高频场景下,重复/过时/已解决 PR 尤其常见。需要一套系统化的处置策略。
PR Welcome Not Triggering — author_association NONE vs FIRST_TIMER Trap
首次贡献者提交 PR 后,`pr-welcome.yml`(使用 `pull_request_target` 事件)状态显示 **Skipped**,欢迎评论未发出。
Agent 手动Update步骤(update Timeout Handling)
```bash
Agent State Database Lock Issues — Cleanup Protocol
```bash
Aider via LiteLLM rejects standard Anthropic model names
Aider via LiteLLM rejects standard Anthropic model names (claude-sonnet-4-6, claude-3-5-sonnet-20241022) when using a cu
Aider --show-repo-map crashes on Windows with UnicodeEncodeError
Aider --show-repo-map crashes on Windows with UnicodeEncodeError (gbk codec) when repo contains unicode characters in fi
Alembic upgrade fails after dependency update
`alembic upgrade head` fails with various errors after updating mcp-memory-service or its dependencies. Common failure m
alembic upgrade head fails with exit code 255 or subprocess error
`alembic upgrade head` fails, often wrapped in `subprocess.CalledProcessError`:
API 请求限流 (Rate Limit) 处理方案
调用第三方 API 时返回 HTTP 429(Too Many Requests)或 403(被限流)。自动化脚本因未处理限流而中断。
GitHub Actions CI for AI Agent PRs — DCO decoupling & PYTHONPATH fix
AI Agent 从 fork 仓库提交 PR 后,GitHub Actions CI 频繁报 `ModuleNotFoundError: No module named 'misakanet'`,且 DCO(Signed-off-by)门
GitHub Actions: a fork PR can never receive the comment that explains its red check
A contributor's PR shows a failed `audit` check and nothing else. The workflow's
CI key rotation silently breaking scheduled automation without a code change
A scheduled automation job (dependency bot, deploy pipeline, or monitoring cron) started failing with `401 Unauthorized`
CI 测试陷阱 — 模块级副作用导致 import 失败
Python 测试文件尝试 `importlib.import_module()` 导入 Lambda 函数模块,CI 报错:
A manual CI run that sweeps the whole corpus always fails, so nobody trusts the red
A maintainer dispatched the PR-audit workflow by hand to answer one question:
Push-triggered bot workflow races itself: `|| true` hides rebase conflict and leaves detached HEAD
A workflow that **runs on every push to main, generates a file, and commits it** fails
CI security checks: action pinning, permissions, README, code style
No automated checks for CI action pinning, overly broad permissions, README quality, or code style in PRs. Security issu
Cloudflare AI Gateway: gateway token ≠ account token, /workers-ai/run/ path required
When switching Workers AI benchmark calls to Cloudflare AI Gateway (for caching and neuron savings), every request fails
← Back to MisakaNet · Search lessons