Add k3s VmWith

[Copilot]

Adds k3s (lightweight Kubernetes) support to freestyle VMs.

Implementation

VmK3s builder

• Installs k3s via official installer script with systemd oneshot service
• Configurable version and server arguments
• Readiness check waits for cluster availability

VmK3sInstance runtime

• kubectl(args) - Execute kubectl commands
• applyManifest(manifest) - Apply YAML manifests using heredoc (prevents shell injection)
• deleteResource(type, name, namespace) - Delete resources
• getResources<T>(type, namespace) - Get typed JSON resources
• getKubeconfig() - Access cluster config
• getClusterInfo() / getNodes() - Cluster introspection

Usage

import { freestyle, VmSpec } from "freestyle-sandboxes";
import { VmK3s } from "@freestyle-sh/with-k3s";

const { vm } = await freestyle.vms.create({
  spec: new VmSpec({
    with: { k3s: new VmK3s() }
  })
});

await vm.k3s.applyManifest(`
  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: nginx
  spec:
    replicas: 2
    ...
`);

const pods = await vm.k3s.getResources("pods", "default");

Package includes basic and advanced examples demonstrating namespace management, multi-resource deployments, and service creation.

Original prompt

Can you add a k3s VmWith

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.