Skip to content

Runbook – Bootstrap Jenkins Docker Agent on Control Node

Extend the Jenkins control plane with a reproducible bootstrap agent that runs workload off the controller during the transition period before RKE2 pod agents are available.

The full Academy runbook includes: - Hardened mode guidance (no Script Console, node managed via JCasC). - Secret handling patterns (Vault/AKV) and rotation guidance. - Evidence capture and troubleshooting for restarts, secrets, and connectivity.

What this covers:

  • Create the ctrl-docker node via JCasC (no UI click-ops) or manage it explicitly.
  • Run an inbound agent container with Docker CLI + Compose v2 via host socket.
  • Verify Jenkins shows the node online and can schedule a labelled pipeline.

Open the full Academy Runbook