Files
ZitPlane/docs/P05-CI-03.md
T

5.0 KiB

P05-CI-03 — Backend-only Gitea CI Acceptance

Date: 2026-11-22 Approved baseline: 485755800504a7dea6e4c303e6b39ec9cc610b54 Status: Backend-only Gitea Run #86 SUCCESS — all scoped gates including cleanup CI-verified.

Objective and user-visible effect

Verify the existing official ZITADEL v4.20.4 + PostgreSQL + prebuilt Login V2 + Traefik local development stack in an isolated Gitea Actions runner. This is NOT an application feature release or an authentication redesign. It does not start the app on your PC, configure public domains, modify credentials/users, or deploy anything.

How to launch the backend-only workflow

In Gitea vibtools/ZitPlane, open Actions → ZitPlane P05-CI-03 Backend Acceptance → Run workflow → main. Only one manual workflow_dispatch is authorized for this phase. The new workflow is .gitea/workflows/p05-backend-acceptance.yml; prior Account and Login V2 build suites are deliberately not rerun.

The runner needs its registered ubuntu-latest label, a functional Docker daemon/socket, Docker Compose v2 with support for !reset, access to pinned image registries and enough storage/time for four images. Do not run it on shared hosts with existing zitplane-backend-dev-internal network or an identical CI Compose project name.

Required verification

  1. Git checkout / Docker Engine / Compose preflight; refuse existing named network, project containers, or named volumes.
  2. Generate fresh disposable local secrets in ignored .env. Merge the read-only P02 Compose with tests/ci/compose.portless.override.yaml; inspect effective proxy config to ensure no host port publishing, including TCP 8080.
  3. Start and wait for PostgreSQL, ZITADEL API, prebuilt Login V2 and Traefik. Confirm first three healthy and proxy running.
  4. Write synthetic marker in disposable Postgres postgres database; restart Postgres; check marker survives after health recovery.
  5. From a disposable probe container within the CI-owned Docker network, check /debug/ready, exact local issuer http://localhost:8080, OIDC discovery endpoint URLs and a nonempty JWKS. Run malformed issuer/JWKS negative fixtures.
  6. In a separate always-run step, stop only CI-owned Compose project, remove its disposable volumes, then check that no CI network/container/volume remains. Report any cleanup failure instead of claiming success.

Expected markers: ZITPLANE_CI_PORTLESS_CONFIG_PASS, ZITPLANE_FOUR_SERVICES_READY_PASS, ZITPLANE_POSTGRES_RESTART_PERSISTENCE_PASS, ZITPLANE_OIDC_NEGATIVE_CONTRACTS_PASS, ZITPLANE_BACKEND_OIDC_READY_DISCOVERY_JWKS_PASS, ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS.

Backend-only acceptance is confirmed for Run #86, with each check and the always-run cleanup step executed successfully. Do not extend this result to real login/MFA or production deployment.

Out of scope / known boundaries

Account Portal real authenticated login/callback and protected positive session; ZITADEL Admin Console human login, MFA, passkey, global SSO logout; Moderate dependency remediation (18 Login records plus 1 Account affected package); production ZITADEL, Coolify, DNS, TLS, backups and user data. Existing P02 developer Compose, Login V2 source and Account Portal must remain unchanged.

Actual acceptance ledger

CI VERIFIED — SUCCESS: Gitea Run #86, tested 03fb58954dec886128a4011b6121754cbcdd79ff, manual workflow_dispatch on main, started 2026-11-22 13:47:58 UTC, concluded SUCCESS 13:48:56 UTC. Job #184 and all four steps SUCCESS: Git prerequisite, checkout, isolated backend acceptance and always-cleanup.

Actual PASS markers: ZITPLANE_DOCKER_DAEMON_PREFLIGHT_PASS; 3/3 P02 focused tests; ZITPLANE_CI_PORTLESS_CONFIG_PASS; ZITPLANE_FOUR_SERVICES_READY_PASS (PostgreSQL, ZITADEL API, Login V2, Traefik running/healthy); ZITPLANE_POSTGRES_RESTART_PERSISTENCE_PASS (synthetic row remains after database restart); ZITPLANE_OIDC_NEGATIVE_CONTRACTS_PASS; ZITPLANE_BACKEND_READY_PASS; ZITPLANE_OIDC_DISCOVERY_PASS (issuer http://localhost:8080); ZITPLANE_OIDC_JWKS_PASS; ZITPLANE_BACKEND_ACCEPTANCE_CHECKS_PASS; ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS (network, containers and volumes removed).

Acceptance verdict: P05-CI-03 backend-only disposable CI acceptance PASS. The original host port 8080 collision no longer occurred; proxy was verified portless and healthy. No real authenticated Account Portal session, Admin Console human login, OAuth callback, MFA/passkey or global logout E2E was tested. The previously triaged 18 Moderate Login advisory records and 1 Moderate Account package remain OPEN. Production deployment and the developer PC were untouched. Exactly one backend-only CI run executed; Account/Login build suites were not rerun. Final docs-only commit is not a retested SHA; the tested source SHA is 03fb589.

Developer details: project/CI-ARCHITECTURE.md. Pre-change plan and final log: notes/P05-CI-03.md.