Skip to content

v2.0.0

Choose a tag to compare

@paruff paruff released this 19 Nov 18:29
e363b59

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):

  • build ran pack build --publish and pushed paruff/python-fawkes-path:c316182 to Docker Hub.
  • notify-obs sent the deployment event to uFawkesObs v1.0.1 and printed DORA event HTTP 201. Obs's log
    shows "POST /event HTTP/1.1" 201 Created and Processed event 7 (deployment).
  • The run is recorded in docs/ai-sdlc/v2.0.0/plan.md and 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: cnb generates a different pipeline. The old build step ran pack in an image that does
    not contain it and could never have worked. It now runs pack build --publish in buildpacksio/pack
    (pinned, -base variant), logs in with the registry_username and registry_password secrets, and pushes
    <registry_username>/<repo>:<sha7>. No separate push step is generated for cnb; image_scan scans the
    published tag. builder: docker is unchanged.
  • Regenerate your .woodpecker.yml with make generate-pipeline. Older generated files use runs_on,
    which Woodpecker 3 rejects.
  • New optional contract fields (defaults keep existing contracts valid): stages.notify_obs.enabled
    (default false) and stages.notify_obs.api_key (default false).

What the generated cnb pipeline needs

  • Woodpecker repo Trusted: Volumes enabled (set by a server admin; WOODPECKER_ADMIN), because pack
    needs the Docker socket. This is root-equivalent on the agent.
  • Secrets registry_username and registry_password, and dora_ingestion_url for notify-obs, allowed for the
    push and manual events.
  • 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 from v3.15.0 runs a one-way log-storage migration (introduced in Woodpecker v3.18.0): back up the woodpecker_data volume first (runbook: docs/ai-sdlc/nas-integration-env/runbook.md).

Known limitations

  • cnb.buildpacks and cnb.env are accepted but not passed to pack yet.
  • The generated deploy step, and this repo's own notify-obs step, still use ${VAR} for shell-time
    variables, which Woodpecker pre-processes; they have not been exercised in a real run.
  • The generated notify-obs sends no first_commit_at or pr_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)

Chores

  • compose: update woodpecker server and agent to v3.20.1 (#277) (#278) (5b88322)
  • devcontainer: update fawkes-space to 2.2.0 (#245) (d1e413a)
  • release: cut v2.0.0 as the first stable release (#120) (#263) (c3e1727)