gitlab-runner: Add suspend/resume support to the Kubernetes executor

Implement suspend/resume for the Kubernetes executor using PVC + overlayfs to preserve the full container rootfs across pod deletion. See kubernetes.md in the blueprint.

  • Mount a PVC as the overlay upper layer so the entire writable filesystem (system packages, global installs, working directory) survives pod deletion.
  • On suspend: retain the PVC, delete the pod, emit the PVC name and namespace in the environment key.
  • On resume: create a new pod mounting the same PVC as the overlay upper layer, skip git source fetching.
  • Requires CAP_SYS_ADMIN for the overlay mount inside the container. Kubernetes user namespaces (hostUsers: false) scope this capability to the pod's user namespace, preventing host-level escalation.
  • Works on any Kubernetes cluster with runc. gVisor support blocked on upstream fix for in-container overlay mount (google/gvisor#4768, fix in flight at google/gvisor#12982).
Edited by Vishal Tak