nikola
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# CI Observer Dashboard Context
|
||
|
||
> Superseded by: `ci-observer-handover/contexts/CI_OBSERVER_CONTEXT_LATEST_2026-02-11.md`
|
||
> Use the newer file for current production/runtime state.
|
||
|
||
## Why this exists
|
||
- Need a read-only, always-on CI status wall for CTO/DevOps.
|
||
- Must not affect existing CI/CD pipelines or protected branches.
|
||
- Quick POC required using local infra and GitHub Actions metadata.
|
||
|
||
## What we built
|
||
- Standalone dashboard service that polls GitHub Actions and renders a live view.
|
||
- Runs on the runner VM as a Docker container.
|
||
- Uses a classic GitHub PAT (read-only scopes) to read workflow runs.
|
||
|
||
## Current behavior
|
||
- Polls GitHub Actions workflow runs every `REFRESH_SECONDS` (default 5s).
|
||
- Shows last 10 runs by updated time.
|
||
- Status colors:
|
||
- green = pass
|
||
- orange = partial (cancelled/skipped/etc.)
|
||
- red = fail
|
||
- blue = running/info
|
||
- Cards show run number, workflow, branch, start time, duration, and a link to the run.
|
||
- UI tuned for 23–24" monitor: 5 cards per row.
|
||
|
||
## Repo and runtime
|
||
- Repo: `Wolkabout/ci-observer-dashboard`
|
||
- Deploy path on runner VM: `/webapps/ci-observer-dashboard`
|
||
- Default port: `8088`
|
||
- URL: `http://10.1.50.20:8088`
|
||
|
||
## How to run (POC)
|
||
```
|
||
cd /webapps/ci-observer-dashboard
|
||
cp .env.example .env
|
||
# set GITHUB_TOKEN, GH_REPOS, GH_WORKFLOWS, REFRESH_SECONDS
|
||
docker compose up -d --build
|
||
```
|
||
|
||
## Current config (example)
|
||
```
|
||
GH_REPOS=Wolkabout/IoT-Platform-Core
|
||
GH_WORKFLOWS=unit-tests.yml
|
||
REFRESH_SECONDS=5
|
||
```
|
||
|
||
## Notes for future Codex sessions
|
||
- This is read-only and independent of CI pipelines.
|
||
- To add more repos/workflows, extend `GH_REPOS` and `GH_WORKFLOWS` (comma-separated).
|
||
- AI summary integration (Ollama) is planned but not implemented yet.
|