HOWTO – Bootstrap Jenkins Docker Agent on Control Node¶
Extend the Jenkins control plane with a reproducible bootstrap agent that runs workload off the controller. This HOWTO provisions a labelled Docker agent on the control node using JCasC (node definition) and an inbound agent container that can execute the platform toolchain through the host Docker runtime.
The result is a governed bridge between “controller is online” and the steady-state runtime where builds execute on RKE2 pod agents.
What this covers:
- Create the ctrl-docker agent node via JCasC (no UI click-ops).
- Run an inbound agent container with Docker CLI + Compose v2 and predictable labels.
- Prove workload executes off-controller while keeping controller executors at 0.