docs(ci): close OIDC run 93 terminal bind RCA and safe cleanup
This commit is contained in:
1 parent
88911c5d68
commit
89bc3f21af
17 files changed
+143
-12
No files matched your search
+2
-1
@@ -18,6 +18,7 @@ This is the chronological **index**. Phase-specific scope/implementation evidenc
|
||||
| 2026-11-22 | P05-OIDC-01 | CI-only official ZITADEL OIDC project/client/user and Chromium original Login V2/Auth.js acceptance harness with owned cleanup | **Run #90 FAILED**: 4 services healthy, no host ports; private localhost:8080 forwarder not ready, no user/client/browser created; cleanup VERIFIED PASS. [Evidence](P05-OIDC-01.md) |
|
||||
| 2026-11-22 | P05-OIDC-02 | Prebuilt/digest-verified socat, private proxy/Host/sidecar state probes, status-only readiness | **Run #91 FAILURE**: backend and private Host routing PASS; forwarder exited code 1, no provisioning/browser; owned cleanup PASS. [Evidence](P05-OIDC-02.md) |
|
||||
| 2026-11-23 | P05-OIDC-03 | Safe socat exit diagnostics and one digest-pinned Python stdlib private TCP fallback within same disposable Gitea cycle | Source pushed; single Gitea Run #93 dispatched on `7b80f41`, **QUEUED**, no steps/cleanup executed; [evidence](P05-OIDC-03.md), acceptance pending |
|
||||
| 2026-11-23 | P05-OIDC-03-A01 | Read-only Gitea Run #93, job #206 and workflow queue/label audit; zero CI reruns or source edits | Run #93 **QUEUED**; job not started, logs 404, workflow active, current runner status not exposed; acceptance unverified. [Evidence](P05-OIDC-03-A01.md) |
|
||||
| 2026-11-23 | P05-OIDC-03-A01 | Historical read-only Run #93 queue snapshot (prior to execution) | At A01 inspection QUEUED, job not started; **superseded by A02 terminal evidence**. [Evidence](P05-OIDC-03-A01.md) |
|
||||
| 2026-11-23 | P05-OIDC-03-A02 | Read-only Run #93 terminal job #206 RCA, safe private forwarding diagnosis and scope closure | Run #93 **FAILURE**: 4 services/proxy PASS, socat SOCKET_BIND_ERROR, Python ADDRESS_IN_USE, real OIDC NOT EXECUTED, mandatory cleanup PASS. [Evidence](P05-OIDC-03-A02.md) |
|
||||
|
||||
Rules: Append new phases or fixes; never silently rewrite a past result. Separate **implemented**, **verified**, **blocked**, and **proposed**. Never log a user secret or personal data.
|
||||
+2
-1
@@ -14,7 +14,8 @@
|
||||
| [P05-OIDC-01.md](P05-OIDC-01.md) | Pre-change real browser OIDC Scope Lock, provision/redirect/session/negative tests and one CI run evidence | P05-OIDC-01 / Run #90 FAILED at forwarder readiness; cleanup PASS; acceptance BLOCKED |
|
||||
| [P05-OIDC-02.md](P05-OIDC-02.md) | Pre-change loopback-forwarder scope, pinned digest/preflight fix and one real Gitea acceptance cycle | P05-OIDC-02 / Run #91: private proxy PASS; socat exit 1, OIDC BLOCKED, cleanup PASS |
|
||||
| [P05-OIDC-03.md](P05-OIDC-03.md) | Pre-edit socat diagnosis, Python fallback and one focused Gitea Run #93 evidence | P05-OIDC-03 / Run #93 QUEUED, no steps executed, acceptance UNVERIFIED |
|
||||
| [P05-OIDC-03-A01.md](P05-OIDC-03-A01.md) | Read-only Run #93/Job #206 queue status, available runner evidence and exact unexecuted OIDC gate ledger | P05-OIDC-03-A01 / no terminal test, runner queue under investigation |
|
||||
| [P05-OIDC-03-A01.md](P05-OIDC-03-A01.md) | Historical read-only queue snapshot before Run #93 was scheduled; superseded by A02 terminal evidence | P05-OIDC-03-A01 / historical queue snapshot |
|
||||
| [P05-OIDC-03-A02.md](P05-OIDC-03-A02.md) | Read-only terminal Run #93 job #206 evidence, private port 8080 conflict and verified cleanup | P05-OIDC-03-A02 / run FAILED, real OIDC blocked, cleanup PASS |
|
||||
| [CHANGELOG.md](CHANGELOG.md) | Short append-only chronological phase log and links to detailed reports | DOCS-01 / active |
|
||||
|
||||
Update this manifest whenever any direct child file or directory changes. Use **actual source state**; a planned file must be labeled planned, not present.
|
||||
@@ -44,3 +44,8 @@
|
||||
4. **Next action if still queued:** read-only terminal-status check for **Run #93**, plus runner online/label/capacity review through an *authorized* server admin UI where possible, without changing any runner config. Any subsequent config modification, new run or CI code change requires fresh Scope Lock and approval.
|
||||
|
||||
**No passing test claims are authorized without actual Run #93 output.** This is a queue/scheduling evidence phase, not a new OIDC implementation phase.
|
||||
|
||||
|
||||
## Historical queued snapshot superseded by A02 terminal evidence
|
||||
|
||||
**This A01 report captured a true earlier queue-only state.** Gitea Run #93/job #206 **later started at 2026-11-22 18:36:26 UTC and completed FAILURE at 18:37:47 UTC**. Subsequent read-only P05-OIDC-03-A02 verified four healthy services and private proxy Host route PASS; socat `SOCKET_BIND_ERROR`, Python fallback `ADDRESS_IN_USE` on private port 8080; no OIDC client/user/browser/callback executed; mandatory owned-only cleanup PASS. Do not use A01's queued status as current. See `notes/P05-OIDC-03-A02.md` and `docs/P05-OIDC-03-A02.md` for complete terminal evidence.
|
||||
@@ -0,0 +1,55 @@
|
||||
# P05-OIDC-03-A02 — Runner Availability RCA & Existing Run #93 Terminal Acceptance
|
||||
|
||||
**Date:** 2026-11-23 (Asia/Dhaka)
|
||||
**Approved baseline:** `88911c5d685ed4d068e6361d5e920108c217046f`
|
||||
**Existing Run:** [Gitea Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93), **job #206**; tested (immutable) source SHA `7b80f411b2981e2274d171c12596301ed757b768`.
|
||||
**Pre-change scope:** This file was written **before A02 documentation modifications**. Only read existing run, job, logs, workflow and authorized runner scheduling evidence; no CI dispatch/rerun/cancellation and no source, workflow, runner or production writes.
|
||||
|
||||
## Exact A02 Scope Lock
|
||||
|
||||
**Permitted writes:** `notes/**`, `project/**`, relevant `docs/**`, associated README/MINIFEST/root navigation only when necessary. Update historical A01 queued status with new terminal evidence **without rewriting the historical event**. Add this report to source inventory/notes manifest, record exact Gitea acceptance evidence and remaining blocker.
|
||||
|
||||
**Strict read-only:** `tests/ci/**`, `.gitea/workflows/**`, original backend/Compose/Login V2/Account Portal/auth, all package manifests and lockfiles, runner configs, secrets, production, unrelated files and root untracked `AI_INSTRUCTIONS.md`. No local app builds/tests/dev servers, no real human, no production deploy, release, tag, or new workflow dispatch.
|
||||
|
||||
## Focused read-only audit — actual terminal results
|
||||
|
||||
At the A02 read-only inspection, Gitea `get_run(93)` returned **status=`completed`, conclusion=`failure`**, created `2026-11-22T18:08:45Z` and last updated `2026-11-22T18:37:47Z`; original test SHA confirmed exact. `get_job(206)` returned started `2026-11-22T18:36:26Z`, completed `2026-11-22T18:37:47Z`, **failure**. This proves an eligible Gitea runner eventually accepted the job and executed checkout; it does **not** prove the precise earlier queue delay or current runner availability. Workflow remained **active**, requesting `ubuntu-latest`. Connected Gitea tools cannot expose current runner registration/label/capacity data; those are not needed to explain this terminal test's failure, which occurred **after checkout and Docker startup**.
|
||||
|
||||
Job step evidence:
|
||||
- #0 Install Git before checkout: **SUCCESS**
|
||||
- #1 `actions/checkout@v4`: **SUCCESS**, exact SHA `7b80f411b2981e2274d171c12596301ed757b768`
|
||||
- #2 Disposable real OIDC acceptance: **FAILURE**
|
||||
- #3 Mandatory always-run owned Docker cleanup: **SUCCESS**
|
||||
|
||||
| Run #93 gate | Actual outcome / exact safe marker |
|
||||
| --- | --- |
|
||||
| Runner pickup, checkout, Docker CLI/Compose preflight | **PASS**; `ZITPLANE_OIDC_DOCKER_PREFLIGHT_PASS`; Docker 29.9.3, Compose 5.7.2 |
|
||||
| Strict no-host-port Compose and ephemeral IAM_OWNER configuration | **PASS**; `ZITPLANE_OIDC_NO_PUBLISHED_PORT_AND_OWNER_CONFIG_PASS` |
|
||||
| Disposable PostgreSQL, ZITADEL API, original Login V2 and Traefik healthy | **PASS**; `ZITPLANE_OIDC_FOUR_SERVICES_READY_PASS` |
|
||||
| Private proxy at :80 with exact localhost Host route | **PASS**; `ZITPLANE_OIDC_PRIVATE_PROXY_HOST_ROUTE_PASS` |
|
||||
| Versioned prebuilt socat image/immutable digest | **PASS**; `ZITPLANE_OIDC_PINNED_FORWARDER_DIGEST_VERIFIED_PASS` |
|
||||
| Socat process startup and its safe diagnostic | **FAIL**; `OIDC_CI_SOCAT_DIAGNOSTIC_STATE=exited EXIT_CODE=1`; `OIDC_CI_SOCAT_STARTUP_ERROR_CLASS=SOCKET_BIND_ERROR` |
|
||||
| Official Python 3.12 image digest and same-run fallback container start | **PASS for image validation and invocation ONLY**; `ZITPLANE_OIDC_PYTHON_FORWARDER_IMAGE_DIGEST_VERIFIED_PASS`; `ZITPLANE_OIDC_PYTHON_FORWARDER_FALLBACK_STARTED` |
|
||||
| Python fallback TCP listener on private 127.0.0.1:8080 | **FAIL**; `OIDC_CI_FORWARDER_NOT_RUNNING_STATE=exited EXIT_CODE=1`; `OIDC_CI_PYTHON_FORWARDER_STARTUP_ADDRESS_IN_USE` |
|
||||
| Forwarded localhost:8080 HTTP 200, issuer/discovery | **NOT EXECUTED/NOT VERIFIED** (both candidates exited before readiness) |
|
||||
| Official real disposable OIDC project, app/client and human | **NOT EXECUTED** |
|
||||
| Real Chromium original Login V2 username/password, auth code + S256 PKCE/state/nonce | **NOT EXECUTED** |
|
||||
| Genuine Auth.js callback, authenticated subject/session, protected Account API/page | **NOT EXECUTED** |
|
||||
| Anonymous and tampered callback rejection, portal sign out | **NOT EXECUTED** |
|
||||
| Always-run owned database/bootstrap/client-secret/container/volume/network cleanup | **PASS**; `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS`; `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS` |
|
||||
| Overall real-user authenticated OIDC acceptance | **BLOCKED / CI FAILURE**, **not** PASS |
|
||||
|
||||
## RCA confidence, root-cause boundary
|
||||
|
||||
**Confirmed:** Both independent forwarders tried to bind private IPv4 loopback `127.0.0.1:8080` and exited; the Python stdlib code explicitly categorized its listener failure as `ADDRESS_IN_USE` (EADDRINUSE), and socat's bounded/redacted startup classifier reported `SOCKET_BIND_ERROR`. This strongly identifies a **private network-namespace port-8080 listener collision**. This is **not evidence** of a bad user/password, Auth.js callback or PKCE defect because none executed.
|
||||
|
||||
**Not established:** Which exact process owns the private TCP 8080 listener, when it bound, or whether a network/container interaction produced the collision. The original Traefik developer Compose (read-only inspected) configures `--entrypoints.web.address=:80`; ZITADEL API's `ZITADEL_PORT=8080` is in a **different service container/network namespace**, and cannot automatically be blamed. Do not claim that Traefik or ZITADEL is the listener without a run-owned socket/process inspection. No private test data remains after the verified cleanup.
|
||||
|
||||
## A02 implementation/verification plan
|
||||
|
||||
1. Preserve exact Run #93 terminal status and job markers in `notes/P05-OIDC-03-A02.md`, `docs/P05-OIDC-03-A02.md`, relevant project developer maps, user docs, manifests, changelogs and inventory.
|
||||
2. Verify all edits are documentation-only, no untracked `AI_INSTRUCTIONS.md`, secrets or unrelated paths; exact inventory/manifests/relative links.
|
||||
3. Make one documentation-only commit, push Gitea main and verify remote/local SHA and published evidence. **No new CI run.**
|
||||
4. **Next phase only after fresh approval:** `P05-OIDC-04` run-scoped private port-listener forensics: enumerate 8080 TCP listener inode/address **before forwarder bind** in the disposable namespace, attribute process safely without credentials, then make a justified CI-only network/port fix. Verify private exact issuer/Host HTTP 200, real project/client/user/browser and mandatory cleanup in **one new separately approved CI cycle**. Do not edit original backend/Compose/Login/Auth.js or open public ports.
|
||||
|
||||
**Acceptance status:** A02 read-only terminal forensic audit completed; **P05-OIDC-03 real authenticated acceptance BLOCKED by confirmed Python private TCP EADDRINUSE**. No second dispatch/repeated CI in A02. Result-only documentation commit is not a newly tested CI source SHA.
|
||||
Reference in new issue
Block a user