Skip to content

Add guide for running NILRT in containers#102

Merged
amstewart merged 1 commit into
ni:mainfrom
Shreejit-03:main
Jun 26, 2026
Merged

Add guide for running NILRT in containers#102
amstewart merged 1 commit into
ni:mainfrom
Shreejit-03:main

Conversation

@Shreejit-03

@Shreejit-03 Shreejit-03 commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Changes

Adds a new tutorial page documenting how to build and run NILRT as an OCI/Docker container image, and links it into the Tutorials toctree.

The page covers:

  • The nilrt-runmode-container (full) and nilrt-slim-container (minimal) image variants.
  • A warning that containers share the host kernel, not the NILRT PREEMPT_RT kernel, so real-time determinism is lost — containers are for development/test/CI, not a production hardware replacement.
  • Prerequisites, building, and running (macvlan network setup and the docker helper scripts).
  • Installing LabVIEW RT and the VeriStand engine via opkg.
  • Configurable run options (network, storage, memory, CPU) and supported host OSes.

Justification

AB#3739195.

Add docs/source/nilrt_containers/nilrt_containers.rst, a tutorial for
building and running NILRT as an OCI/Docker container image, and link
it into the Tutorials toctree in index.rst.

The guide covers an overview of the runmode and slim container variants
and their intended use, the loss of real-time determinism when running
on the host kernel, why driver installation is not sensible in a
container, prerequisites for building and running, building the images
and loading the artifacts, creating the macvlan network and launching
containers with the docker/ helper scripts, installing LabVIEW RT and
the VeriStand engine via opkg, configurable run options (network,
storage, memory, CPU, etc.), and supported host operating systems.

Signed-off-by: Shreejit C <shreejit.c@emerson.com>
@Shreejit-03 Shreejit-03 requested a review from jpautler as a code owner June 25, 2026 18:56
@Shreejit-03 Shreejit-03 requested a review from chaitu236 June 25, 2026 18:56
@amstewart amstewart merged commit 0b006c0 into ni:main Jun 26, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants