Files
lmxopcua/scripts/ci/README.md
T
Joseph Doherty 94926eb0d7
v2-ci / unit-tests (push) Has been cancelled
ci: fixture-backed integration workflow and guarded fleet E2E workflow (lmxopcua#757)
v2-integration.yml runs the Sql, Historian.SqlServer, Historian.QuestDb and OpcUaClient
integration projects against throwaway SQL Server/PostgreSQL/QuestDB/opc-plc containers
started by scripts/ci/integration-fixtures.sh, with a MIN_EXECUTED=440 floor. v2-e2e.yml is
manual/weekly, probes the shared fleet and skips cleanly when unreachable. v2-ci.yml is
functionally unchanged. Unverified on a hosted runner until first run.

Claude-Session: https://claude.ai/code/session_01GT67AEHd2Acv1YPwGfXEoV
2026-11-09 16:53:44 -05:00

5.0 KiB

Whole-solution CI

The v2-ci workflow restores, builds and tests in one job so the test step uses that job's Release binaries. Restore disables parallel package work; restore and build use at most two MSBuild workers. Testing uses one MSBuild worker, disables parallel target-framework runs and loads ci.runsettings: one VSTest process and two xUnit collection workers with conservative scheduling. Assemblies that disable parallelization keep that setting.

The workflow retains the E2E/LiveIntegration exclusions, includes SlowUnit, keeps Akka's test time factor at three, and requires at least 12,000 executed tests. Runner capacity and TRX files remain available for diagnosing failures. These limits reduce contention; they do not prove every timing failure has one cause. There are no automatic test retries or changed assertion deadlines.

Gitea 1.26 supports the repository-wide lmxopcua-v2-ci concurrency group. Only one run is active; an active run is not cancelled, but a newer pending run may supersede an older pending run. The group does not serialize other repositories using the same host.

Stall guards (#718): the job has timeout-minutes: 120 (healthy runs take about 60 minutes) and the test step passes --blame-hang --blame-hang-timeout 20m --blame-hang-dump-type none, so a test that stops making progress is killed and named in the log instead of leaving hours of silence (run 959 stalled 3h12m until the server reaper failed it).

To reproduce the bounded test leg after restore and Release build:

AKKA_TEST_TIMEFACTOR=3 dotnet test ZB.MOM.WW.OtOpcUa.slnx \
  --configuration Release --no-build -m:1 -p:TestTfmsInParallel=false \
  --settings scripts/ci/ci.runsettings \
  --filter "Category!=E2E&Category!=LiveIntegration" \
  --logger trx --results-directory artifacts/trx
MIN_EXECUTED=12000 bash scripts/ci/assert-not-all-skipped.sh artifacts/trx/*.trx

The guard uses the existing TRX Counters/@executed value for the aggregate floor. Its skipped diagnostic counts individual Results/UnitTestResult records whose outcome is NotExecuted, using the document's XML namespace. Some VSTest reports set summary notExecuted to zero even when these records are present. Skip records are counted per file, including repeated runs; they are not a count of unique test methods and do not affect the executed floor. For malformed XML, the diagnostic retains the old summary-counter fallback; this guard does not add XML validation to its existing gate policy.

Run the deterministic script fixtures without building or running the solution:

python3 scripts/ci/test-assert-not-all-skipped.py

Verified hosted baseline: Gitea run 975 completed successfully on 2026-10-13 for commit 76bdca90e94e814e06ef10b78271e2b492b2ba32 (merged by PR #711). Restore, Release build, README drift check, the serialized whole-solution test step, the 12,000-test floor and TRX upload all passed. The floor counted 14,630 executed tests across 62 TRX files. This baseline predates the individual skip-reporting correction; its printed zero skip diagnostic is not skip evidence.

Fixture-backed integration and guarded E2E workflows (#757)

Both are UNVERIFIED on a hosted Gitea runner until their first run; they were validated locally only (YAML parse, the exact dotnet test commands and fixture script against local throwaway containers). Neither touches v2-ci.yml; each has its own concurrency group (lmxopcua-v2-integration, lmxopcua-v2-e2e, cancel-in-progress: false) so a pending run of one cannot supersede a pending lmxopcua-v2-ci run.

  • v2-integration.yml (push to master, path-filtered PRs, manual; timeout-minutes: 60). integration-fixtures.sh up starts throwaway SQL Server 2022, PostgreSQL 17 (seeded from seed-pg.sql), QuestDB and opc-plc (otopcua-ci-*, non-default host ports), exports the env vars the fixtures read, and down removes them. It uses plain docker run, not services: (act_runner support is undocumented and Postgres needs a seed step); the only runner requirement is a docker daemon. Runs the Sql, Historian.SqlServer, Historian.QuestDb, OpcUaClient and OpcUaClient.Browser *.IntegrationTests with MIN_EXECUTED=440. Local run: 468 executed / 8 skipped (Oracle x2, the blackhole docker pause gate, one QuestDB stress test, 4 others), about 4.5 min of test time, QuestDB the longest (~3.3 min). Not covered (no pullable image or needs credentials): Modbus/S7/AB/FOCAS/TwinCAT sims, Mqtt, MTConnect, Oracle, Host real-infra mode.
  • v2-e2e.yml (manual + weekly cron only; timeout-minutes: 90). probe-e2e-fixtures.sh TCP-probes 10.100.0.35 ports 5020/1102/50000; if any is closed every later step is skipped and the run is green with a notice. Otherwise runs the Modbus, S7, OpcUaClient and OpcUaClient.Browser integration projects against the shared fleet with MIN_EXECUTED=35 (local: 42 executed / 38 skipped; Modbus skips the profiles that are not up). No test carries Category=E2E today, so the zero-match guard is this executed floor.