Struct K3dManager 

pub struct K3dManager { /* private fields */ }

Manages the lifecycle of a k3d Kubernetes cluster for a devrig project.

Implementations

impl K3dManager

pub fn new( slug: &str, config: &ClusterConfig, state_dir: &Path, network_name: &str, config_dir: &Path, ) -> Self

Create a new K3dManager for the given project slug and cluster configuration.

pub async fn create_cluster(&self) -> Result<()>

Create the k3d cluster if it does not already exist (idempotent).

pub async fn delete_cluster(&self) -> Result<()>

Delete the k3d cluster and remove the local kubeconfig file if it exists.

pub async fn cluster_exists(&self) -> Result<bool>

Check whether the k3d cluster already exists.

pub async fn write_kubeconfig(&self) -> Result<()>

Write the cluster kubeconfig to the local state directory.

After writing, checks whether the kubeconfig contains an unresolved API server port (:0) — this happens when --api-port 127.0.0.1:0 is used and k3d doesn’t resolve the actual port. If detected, the actual port is discovered from the k3d serverlb Docker container and the kubeconfig is rewritten with the correct port.

pub async fn kubectl(&self, args: &[&str]) -> Result<String>

Run kubectl with the cluster kubeconfig, returning stdout on success.

pub fn cluster_name(&self) -> &str

Return the cluster name.

pub fn kubeconfig_path(&self) -> &Path

Return the path to the kubeconfig file.

pub fn network_name(&self) -> &str

Return the Docker network name the cluster is attached to.

pub fn slug(&self) -> &str

Return the project slug.