Vagrant Box Packaging for Kubernetes

Vagrant Box Packaging for Kubernetes.

This Vagrant Box provides Libvirt and VirtualBox image for running a Certified Kubernetes environment in single node all-in-one mode.

Supported Boxes and Respective Packer Template Links

• alvistack/kubernetes-1.30
  • packer/kubernetes-1.30-libvirt/packer.json
  • packer/kubernetes-1.30-virtualbox/packer.json
• alvistack/kubernetes-1.29
  • packer/kubernetes-1.29-libvirt/packer.json
  • packer/kubernetes-1.29-virtualbox/packer.json
• alvistack/kubernetes-1.28
  • packer/kubernetes-1.28-libvirt/packer.json
  • packer/kubernetes-1.28-virtualbox/packer.json
• alvistack/kubernetes-1.27
  • packer/kubernetes-1.27-libvirt/packer.json
  • packer/kubernetes-1.27-virtualbox/packer.json

Overview

• Packaging with Packer
• Minimal Vagrant base box implementation
• Support QEMU Guest Agent
• Support VirtualBox Guest Additions
• Support Vagrant synced folder with rsync
• Support Vagrant provisioner with Ansible
• Standardize disk partition with GPT
• Standardize file system mount with UUID
• Standardize network interface with eth0

Quick Start

Once you have Vagrant and VirtaulBox installed, run the following commands under your project directory:

# Initialize Vagrant
cat > Vagrantfile <<-EOF
Vagrant.configure('2') do |config|
  config.vm.hostname = 'kubernetes-1.30'
  config.vm.box = 'alvistack/kubernetes-1.30'

  config.vm.provider :libvirt do |libvirt|
    libvirt.cpu_mode = 'host-passthrough'
    libvirt.cpus = 2
    libvirt.disk_bus = 'virtio'
    libvirt.disk_driver :cache => 'writeback'
    libvirt.driver = 'kvm'
    libvirt.memory = 8192
    libvirt.memorybacking :access, :mode => 'shared'
    libvirt.nested = true
    libvirt.nic_model_type = 'virtio'
    libvirt.storage :file, bus: 'virtio', cache: 'writeback'
    libvirt.video_type = 'virtio'
  end

  config.vm.provider :virtualbox do |virtualbox|
    config.vm.disk :disk, name: 'sdb', size: '10GB'
    virtualbox.cpus = 2
    virtualbox.customize ['modifyvm', :id, '--cpu-profile', 'host']
    virtualbox.customize ['modifyvm', :id, '--nested-hw-virt', 'on']
    virtualbox.memory = 8192
  end
end
EOF

# Start the virtual machine
export VAGRANT_EXPERIMENTAL='1'
vagrant up

# SSH into this machine
vagrant ssh

# Terminate the virtual machine
vagrant destroy --force

Molecule

You could also run our Molecule test cases if you have Vagrant and Libvirt installed, e.g.

# Run Molecule on Kubernetes 1.30
molecule converge -s kubernetes-1.30-libvirt

Please refer to .gitlab-ci.yml for more information on running Molecule.

Versioning

YYYYMMDD.Y.Z

Release tags could be find from GitHub Release of this repository. Thus using these tags will ensure you are running the most up to date stable version of this image.

YYYYMMDD.0.0

Version tags ended with .0.0 are rolling release rebuild by GitLab pipeline in weekly basis. Thus using these tags will ensure you are running the latest packages provided by the base image project.

License

• Code released under Apache License 2.0
• Docs released under CC BY 4.0

Author Information

• Wong Hoi Sing Edison
  • https://twitter.com/hswong3i
  • https://github.com/hswong3i