openmaic/.project-docs/30-worklog/tasks/20260818-onnx-cuda-postinstall-a7c4.md

Task: Stabilize ONNX Runtime Docker install

Identity

• Task ID: 20260818-onnx-cuda-postinstall-a7c4
• Mode: Feature
• Branch: main
• Worktree: D:\Datas\OthersProjects\openmaic
• Base commit: 22dd55625f
• Owner: developer
• Status: Ready for integration

Scope

• Record and verify the CPU ACK Docker fix for the onnxruntime-node postinstall failure reported by Jenkins.
• Keep CUDA provider download opt-in; do not claim a GPU image is supported without a CUDA-capable runner and a verified NuGet/proxy path.

Intent And Constraints

• Linux/x64 onnxruntime-node@1.23.2 assumes CUDA 12 when no install mode is provided and rejects the Jenkins proxy's HTTP 302 response from NuGet.
• The CPU runtime and binding are bundled in the npm package, so the ACK image should skip the unnecessary CUDA provider download.
• Preserve pnpm install --frozen-lockfile; avoid unrelated application changes.

Outcome

• OpenMAIC/Dockerfile in base commit 22dd556 sets ONNXRUNTIME_NODE_INSTALL=skip before the dependency-stage install.
• CUDA installation remains an explicit cuda12 build-arg override and is documented as requiring a CUDA-capable runner; it is outside this acceptance scope.
• The lockfile correction is in e1a0a14, and the adopted .project-docs/ tree is tracked in 469f72b.

Verification

• The upstream install script exited 0 with ONNXRUNTIME_NODE_INSTALL=skip.
• Bundled Linux and Windows CPU runtime binding files were present.
• git diff --check passed.
• check_project_docs.py passed.
• Local Linux Docker validation is unavailable because the Docker Desktop Linux engine pipe is not running; Jenkins must perform the end-to-end build.
• Final read-only reviewer returned PASS.

Follow-ups

• Push e1a0a14, 469f72b, and 22dd556 from an authenticated terminal, then rerun the Jenkins CPU image build.
• If GPU deployment is required, provide a CUDA-capable runner image and verify the ONNXRUNTIME_NODE_INSTALL=cuda12 path against the organization's NuGet proxy before enabling it.

Promotion Candidates

• None recorded.