Repository navigation
v2.0.0
uFawkesPipe v2.0.0: first stable release
Every earlier release (v1.0.0-beta.1 through v1.17.1-beta.1) was a beta. v2.0.0 is the first release that
claims only what has been run, which is why the version jumps from 1.x beta to 2.0.0 instead of continuing as
1.18.0-beta.1.
What is verified
A real Woodpecker run of a generated pipeline, on the sample app paruff/python-fawkes-path
(a builder: cnb contract with stages.notify_obs enabled):
buildranpack build --publishand pushedparuff/python-fawkes-path:c316182to Docker Hub.notify-obssent the deployment event to uFawkesObs v1.0.1 and printedDORA event HTTP 201. Obs's log
shows"POST /event HTTP/1.1" 201 CreatedandProcessed event 7 (deployment).- The run is recorded in
docs/ai-sdlc/v2.0.0/plan.mdand issue #123.
Getting the first complete run through took six fixes in five pull requests (#270, #271, #272, #275, #276),
each found by a failed run on a real Woodpecker server and merged test-first.
Breaking changes for app repositories
builder: cnbgenerates a different pipeline. The oldbuildstep ranpackin an image that does
not contain it and could never have worked. It now runspack build --publishinbuildpacksio/pack
(pinned,-basevariant), logs in with theregistry_usernameandregistry_passwordsecrets, and pushes
<registry_username>/<repo>:<sha7>. No separatepushstep is generated forcnb;image_scanscans the
published tag.builder: dockeris unchanged.- Regenerate your
.woodpecker.ymlwithmake generate-pipeline. Older generated files useruns_on,
which Woodpecker 3 rejects. - New optional contract fields (defaults keep existing contracts valid):
stages.notify_obs.enabled
(defaultfalse) andstages.notify_obs.api_key(defaultfalse).
What the generated cnb pipeline needs
- Woodpecker repo Trusted: Volumes enabled (set by a server admin;
WOODPECKER_ADMIN), becausepack
needs the Docker socket. This is root-equivalent on the agent. - Secrets
registry_usernameandregistry_password, anddora_ingestion_urlfornotify-obs, allowed for the
pushandmanualevents. - Docker Hub is the only supported registry (GHCR is planned).
- Woodpecker server and agent are pinned at
v3.20.1(#277). Upgrading an existing server fromv3.15.0runs a one-way log-storage migration (introduced in Woodpecker v3.18.0): back up thewoodpecker_datavolume first (runbook:docs/ai-sdlc/nas-integration-env/runbook.md).
Known limitations
cnb.buildpacksandcnb.envare accepted but not passed topackyet.- The generated
deploystep, and this repo's ownnotify-obsstep, still use${VAR}for shell-time
variables, which Woodpecker pre-processes; they have not been exercised in a real run. - The generated
notify-obssends nofirst_commit_atorpr_merged_at, so lead time is not computed for apps
that use it.
See the full list of changes below.
2.0.0 (2026-11-19)
Added
- ci: main-ci-guard can judge main's HEAD, with a fallback (#266) (#274) (0e472e2)
- compose: configurable host ports for Woodpecker and Portainer (#253) (5223c85)
- generator: cnb build publishes a real image; optional notify-obs stage (#123) (#267) (cfbda5d)
- pipeline: build-image runs a real CNB build (#122) (#246) (30a727c)
- pipeline: DORA emission and pipeline-contract accuracy (#223) (#248) (97e5bcf)
- runner: host unit for the ufawkes-ci runner (#223) (#250) (ad2ba4a)
- runner: optional override to join the Obs network (#223) (#254) (4ed332b)
- runner: reach Docker through a filtering socket proxy (#223) (#251) (ae83236)
Fixed
- generator: reference the dora api key secret only when opted in (#123) (#272) (df67e08)
- pipeline: drop braces on shell variables, give pack a docker socket (#123) (#275) (43221a6)
- pipeline: pin pack 0.40.11-base, the first image with CA certs (#123) (#276) (03f33ff)
- pipeline: run pack from its -base image so Woodpecker has /bin/sh (#123) (#271) (303febe)
- pipeline: Woodpecker 3 when/status filters, cnb build only on main (#123) (#270) (dfa9f57)
Docs
- adr: ADR-006 build-image is a real CNB build (#122) (#244) (536bc87)
- build-image is no longer called a placeholder (#120) (#262) (368302d)
- consolidate planning docs under docs/ai-sdlc/v2.0.0 (#96) (#260) (b9f5496)
- merge the security-plane quickstart into QUICKSTART.md (#96) (#261) (7e664e3)
- plan: propose the NAS as the test and integration env (#249) (b85c818)
- plan: record the first NAS deploy and the real DORA run (#223) (#255) (4a1a67d)
- plan: record the real run of a generated pipeline against Obs v1.0.1 (#123) (#279) (4f65d07)
- plan: runbook to deploy Obs and Pipe on the NAS (#223) (#252) (8842531)