How lpabon/kubeup works
Main Components
a. Host System Layer:
• Libvirt/KVM virtualization platform
• Local Docker registry (if enabled)
• Kubeup container that runs Vagrant
b. Virtual Machine Layer:
• Kubernetes master node
• Three worker nodes
• Networking between nodes
c. Kubernetes Components:
• K3S (for v3.0.0+)
• Cilium (replacing kube-proxy)
• Longhorn storage system
Component Relationships
• Network connections between master and worker nodes
• Connection from VMs to local Docker registry via socat tunnel
• Control plane communications between master and nodes
Architectural Elements
• Rectangle for the host system (outer container)
• Rounded rectangles for VMs
• Hexagons for Kubernetes components
Implementation Details
Annotations showing:
• Ansible roles (common, master, nodes, longhorn)
• Network configurations (cilium.conf)
• Service configurations (docker-localhost.service)
• Storage configurations (Longhorn)
Workflow Indicators
• Initial provisioning flow (up.sh)
• Kubernetes cluster formation
• Container registry access paths
• Configuration file distribution
┌─ Host System ──────────────────────────────┐
• ┌─ kubeup container ─┐ ┌─ Docker Registry ┐│
• Vagrant │ │ - Local Images ││
• vagrant-libvirt│ └─────────────────┘││
• ┘ ││
• ┌─ Virtual Machines ────────────────────┐ ││
• ┌─ Master Node ─┐ ┌─ Worker Nodes ─┐ │ ││
• K3S │ │ - Node 1 │ │ ││
• Cilium │ │ - Node 2 │ │ ││
• Longhorn │ │ - Node 3 │ │ ││
• ┘ └───────────────┘ │ ││
• ┘ ││
• ┘
Important Considerations:
Configuration flows
• global_vars.yml application
• kubeconfig distribution
• Ansible role execution
Remember to maintain a balance between detail and clarity, focusing on the key components while providing enough information to understand the system's operation and interactions.