Quick Start

Create your first Kubernetes cluster in minutes

Prerequisites

Make sure you have installed:

  • VirtualBox 7.0+
  • Vagrant 2.4+
  • kubectl 1.32+

Create the Cluster

# Clone the repository
git clone https://github.com/gilmararaujo/k8s-provisioner.git
cd k8s-provisioner/vagrant

# Start the cluster
vagrant up

This will create:

  • 1 Storage VM (NFS Server)
  • 1 Control Plane node
  • 2 Worker nodes

Access the Cluster

# Copy kubeconfig
vagrant ssh controlplane -c 'sudo cat /etc/kubernetes/admin.conf' > ~/.kube/config-lab

# Use the config
export KUBECONFIG=~/.kube/config-lab

# Verify
kubectl get nodes

Expected output:

NAMESTATUSROLESAGEVERSIONcontrolplaneReadycontrol−plane10mv1.32.11node01Ready<none>8mv1.32.11node02Ready<none>6mv1.32.11NAME STATUS ROLES AGE VERSION controlplane Ready control-plane 10m v1.32.11 node01 Ready <none> 8m v1.32.11 node02 Ready <none> 6m v1.32.11

What’s Included

Your cluster comes pre-configured with:

ComponentDescription
CalicoCNI networking
MetalLBLoadBalancer for bare metal
IstioService mesh
Prometheus + GrafanaMonitoring
Loki + PromtailLogging
Metrics ServerResource metrics

Next Steps