ProxyWhirl DocsOperations
CI/CD Pipeline
GitHub Actions workflows, quality gates, and deployment stages for ProxyWhirl.
Canonical workflow definitions live in .github/workflows/. Local parity gate:
just quality-gatesPrimary Workflows
| Workflow | Trigger | Purpose |
|---|---|---|
ci.yml | push, PR | Lint, type check, tests, coverage, package build |
security.yml | schedule, push | Dependency and static analysis |
validate-sources.yml | cron, manual | Strict proxy source health |
release.yml | tag | PyPI publish and GitHub release |
cd.yml | manual | Deployment automation |
Typical Pipeline Stages
- Lint and format check (
just lint,just format-check) - Type check (
just type-check) - Fast tests and coverage (
just quality-gates) - Docker image build (release/CD paths)
- Staging deploy and smoke tests (CD paths)
- Production deploy with approval (CD paths)
Local Commands
just lint
just format-check
just type-check
just test-fast
just coverage
uv buildDeployment Strategy
- Staging: auto-deploy on main merges where CD is configured
- Production: manual approval or tagged release
- Rollback: use
deploy/scripts/blue-green-deploy.sh rollbackor redeploy prior artifact
See Release Process and Monitoring.