{"id":28,"date":"2026-03-24T10:05:51","date_gmt":"2026-03-24T10:05:51","guid":{"rendered":"https:\/\/blog.ngocha.biz\/?p=28"},"modified":"2026-03-24T10:05:51","modified_gmt":"2026-03-24T10:05:51","slug":"how-to-setup-kubernetes-cluster-on-vagrant-vms","status":"publish","type":"post","link":"https:\/\/blog.ngocha.biz\/?p=28","title":{"rendered":"How to Setup Kubernetes Cluster on Vagrant VMs"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

In this Kubernetes tutorial<\/a>, I have covered the step-by-step guide to set up the Kubernetes cluster on Vagrant. It is a multinode kubernetes setup using kubeadm<\/a>.<\/p>\n\n\n\n

Vagrant is a great utility to set up Virtual machines on your local workstation. I pretty much use Vagrant for most of my testing and learning purposes. If you are new to Vagrant, see my beginners vagrant guide<\/a><\/p>\n\n\n\n

This guide primarily focuses on the Kubernetes automated setup using Vagrantfile and shell scripts.<\/p>\n\n\n\n

Automated Kubernetes Cluster Setup on Vagrant<\/h2>\n\n\n\n

I have written a basic Vagrantfile and scripts so that anyone can understand and make changes as per their requirements.<\/p>\n\n\n\n

Here is the summary of the setup.<\/p>\n\n\n\n

    \n
  1. A single vagrant up command will create three VMs and configures all essential kubernetes components and configuration using Kubeadm.<\/li>\n\n\n\n
  2. Calico Network Plugin, Metrics server, and Kubernetes dashboard get installed as part of the setup.<\/li>\n\n\n\n
  3. The kubeconfig file gets added to all the nodes in the cluster so that you can execute kubectl commands from any node.<\/li>\n\n\n\n
  4. The kubeconfig file and the kubernetes dashboard access token get added to the configs folder where you have the Vagrantfile. You can use the kubeconfig file to connect the cluster from your workstation.<\/li>\n\n\n\n
  5. You can shut down the VMs when not in use and start them again whenever needed. All the cluster configurations remain intact without any issues. The nodes get connected automatically to the master during the startup.<\/li>\n\n\n\n
  6. You can delete all the VMs in one command and recreate the setup with a\u00a0vagrant up<\/code>\u00a0command any time you need.<\/li>\n<\/ol>\n\n\n\n

    Here is a high-level overview of the setup.<\/p>\n\n\n\n

    \"\"\/<\/a><\/figure>\n\n\n\n

    CKA\/CKAD\/CKS Certification Practice Environment<\/h2>\n\n\n\n

    If you are preparing for any of the Kubernetes certifications, you need a cluster to practice all the exam scenarios.<\/p>\n\n\n\n

    You can use these Vagrant scripts to set up your local practice environment.<\/p>\n\n\n\n

    Specifically, for CKA Certification<\/a>, you can expect Kubeadm-related exam questions like bootstrapping and upgrading the kubernetes cluster using kubeadm. You can check out the following guides.<\/p>\n\n\n\n

      \n
    1. Kubernetes cluster bootstrapping using Kubeadm<\/a><\/li>\n\n\n\n
    2. Upgrading Kubernetes cluster using kubeadm<\/a><\/li>\n<\/ol>\n\n\n\n

      The setup script deploys the latest version<\/strong> of kubernetes that is required for Kubernetes certification exams.<\/p>\n\n\n\n

      \ud83d\udca1<\/p>\n\n\n\n

      Important Note<\/strong>: If you are preparing for CKA\/CKAD\/CKS certification, make use of the CKA\/CKAD\/CKS Voucher Codes<\/a> before the price increases.<\/p>\n\n\n\n

      Kubernetes-Kubeadm Vagrant Github Repository<\/h2>\n\n\n\n

      The Kubeadm Vagrantfile and scripts are hosted on the Vagrant Kubernetes Github repository<\/a>.<\/p>\n\n\n\n

      Clone the repository to follow along with the guide.<\/p>\n\n\n\n

      git clone https:\/\/github.com\/techiescamp\/vagrant-kubeadm-kubernetes<\/code><\/pre>\n\n\n\n
      Prerequisite For MAC Users<\/h3>\n\n\n\n
      If you have upgraded MAC to OS Monterey<\/strong>, you might face issues with Vagrant for creating private networks. This means Vagrant won’t be able to create a network other than the 198 series.<\/p>\n\n\n\n
      To resolve the issue, one \/etc\/vbox\/networks.conf<\/code> and add the following.<\/p>\n\n\n\n
      * 0.0.0.0\/0 ::\/0<\/code><\/pre>\n\n\n\n
      Setup Kubernetes Cluster on Vagrant<\/h2>\n\n\n\n
      Note: <\/strong>You need a minimum of 16 Gig RAM workstation to run this setup without any issues.<\/p>\n\n\n\n
      Follow the steps given below to spin up the cluster and validate all the Kubernetes cluster configurations.<\/a><\/p>\n\n\n\n
      Step 1: <\/strong>To create the cluster, first cd into the cloned directory.<\/p>\n\n\n\n
      cd vagrant-kubeadm-kubernetes<\/code><\/pre>\n\n\n\n
      Step 2:<\/strong> Execute the vagrant command. It will spin up three nodes. One control plane (master) and two worker nodes. Kubernetes installation and configuration happen through the shell script present in the scripts folder.<\/p>\n\n\n\n
      vagrant up<\/code><\/pre>\n\n\n\n
      Note:<\/strong> If you are running it for the first time, Vagrant will first download the ubuntu box mentioned in the Vagrantfile. This is a one-time download.<\/p>\n\n\n\n
      Step 3: Lo<\/strong>g in to the master node to verify the cluster configurations.<\/p>\n\n\n\n
      vagrant ssh controlplane<\/code><\/pre>\n\n\n\n
      Step 4:<\/strong> List all the cluster nodes to ensure the worker nodes are connected to the master and in a ready state.<\/p>\n\n\n\n
      kubectl top nodes<\/code><\/pre>\n\n\n\n
      You should see the output as shown below.<\/p>\n\n\n\n
      \"kubeadm<\/a><\/figure>\n\n\n\n
      Step 5: <\/strong>List all the pods in kube-system<\/code> namespace and ensure it is in a running state.<\/p>\n\n\n\n
      kubectl get po -n kube-system<\/code><\/pre>\n\n\n\n
      \"kubeadm<\/a><\/figure>\n\n\n\n
      Step 6: <\/strong>Deploy a sample Nginx app and see if you can access it over the nodePort.<\/p>\n\n\n\n
      kubectl apply -f https:\/\/raw.githubusercontent.com\/scriptcamp\/kubeadm-scripts\/main\/manifests\/sample-app.yaml<\/code><\/pre>\n\n\n\n
      You should be able to access Nginx on any of the node’s IPs on port 32000<\/code>. For example, http:\/\/10.0.0.11:32000<\/code><\/p>\n\n\n\n
      \"kubeadm<\/a><\/figure>\n\n\n\n
      That’s it! You can start deploying and testing other applications.<\/p>\n\n\n\n
      To shut down the Kubernetes VMs, execute the halt command.<\/p>\n\n\n\n
      vagrant halt<\/code><\/pre>\n\n\n\n
      Whenever you need the cluster, just execute the following.<\/p>\n\n\n\n
      vagrant up<\/code><\/pre>\n\n\n\n
      To destroy the VMs,<\/p>\n\n\n\n
      vagrant destroy<\/code><\/pre>\n\n\n\n
      Note:<\/strong> If you want applications to persist data on each cluster or pod restart, make sure you use the persistent volume type “local” attached to a nodeSelector.<\/p>\n\n\n\n
      Access Kubernetes Cluster From Workstation Terminal<\/h2>\n\n\n\n
      Once Vagrant execution is successful, you will see a configs folder with a few files (config, join.sh, and token)<\/strong> inside the cloned repo. These are generated during the run time.<\/p>\n\n\n\n
      Copy the config file to your $HOME\/.kube<\/code> folder if you want to interact with the cluster from your workstation terminal. You should have kubectl installed on your workstation.<\/p>\n\n\n\n
      For example, I did the following on my Mac keeping vagrant-kubeadm-kubernetes<\/code> folder as the current directory.<\/p>\n\n\n\n
      mkdir -p $HOME\/.kube\ncp configs\/config $HOME\/.kube<\/code><\/pre>\n\n\n\n
      Alternatively, you can set a Kubeconfig env variable as shown below. Make sure you execute the command from the vagrant-kubeadm-kubernetes<\/code> folder where you have the Vagrantfile<\/code>.<\/p>\n\n\n\n
      export KUBECONFIG=$(PWD)\/configs\/config<\/code><\/pre>\n\n\n\n
      Once you copy the kubeconfig (config) file to your local $HOME\/.kube<\/code> directory you can run the kubectl command against the cluster<\/p>\n\n\n\n
      Verify the config by listing the cluster nodes.<\/p>\n\n\n\n
      kubectl get nodes<\/code><\/pre>\n\n\n\n
      To access the kubernetes dashboard, run kubectl proxy to access the Kubernetes dashboard.<\/p>\n\n\n\n
      kubectl proxy<\/code><\/pre>\n\n\n\n
      The token<\/code> file inside the configs folder contains the sign-in token for the kubernetes dashboard. If you want to use the kubernetes dashboard, use the token and log in from the following URL<\/p>\n\n\n\n
      http://localhost:8001\/api\/v1\/namespaces\/kubernetes-dashboard\/services\/https:kubernetes-dashboard:\/proxy\/#\/login<\/code><\/pre>\n\n\n\n
      \"Vagrant<\/a><\/figure>\n\n\n\n
      Kubeadm Vagrantfile & Scripts Explanation<\/h2>\n\n\n\n
      Here is the file tree for the Vagrant repo.<\/p>\n\n\n\n
      \u251c\u2500\u2500 Vagrantfile\n\u251c\u2500\u2500 configs\n\u2502   \u251c\u2500\u2500 config\n\u2502   \u251c\u2500\u2500 join.sh\n\u2502   \u2514\u2500\u2500 token\n\u2514\u2500\u2500 scripts\n    \u251c\u2500\u2500 common.sh\n    \u251c\u2500\u2500 master.sh\n    \u2514\u2500\u2500 node.sh<\/code><\/pre>\n\n\n\n
      The configs folder and files get generated only after the first run.<\/p>\n\n\n\n
      As I explained earlier, the config file contains the config, token, and join.sh file.<\/p>\n\n\n\n
      In the previous section, I have already explained config<\/code> and token<\/code>. The join.sh<\/code> file has the worker node join command with the token created during kubeadm master node initialization.<\/p>\n\n\n\n
      Since all the nodes share the folder containing the Vagrantfile, the worker nodes can read the join.sh<\/code> file and join the master automatically during the first run. It is a one-time task.<\/p>\n\n\n\n
      If you log in to any node and access the \/vagrant<\/code> folder, you will see Vagrantfile and scripts as it is shared between the VMs.<\/p>\n\n\n\n
      Let’s have a look at the Vagrantfile<\/p>\n\n\n\n
      NUM_WORKER_NODES=2\nIP_NW=\"10.0.0.\"\nIP_START=10\n\nVagrant.configure(\"2\") do |config|\n  config.vm.provision \"shell\", env: {\"IP_NW\" => IP_NW, \"IP_START\" => IP_START}, inline: <<-SHELL\n      apt-get update -y\n      echo \"$IP_NW$((IP_START)) master-node\" >> \/etc\/hosts\n      echo \"$IP_NW$((IP_START+1)) worker-node01\" >> \/etc\/hosts\n      echo \"$IP_NW$((IP_START+2)) worker-node02\" >> \/etc\/hosts\n  SHELL\n\n  config.vm.box = \"bento\/ubuntu-22.04\"\n  config.vm.box_check_update = true\n\n  config.vm.define \"master\" do |master|\n    # master.vm.box = \"bento\/ubuntu-18.04\"\n    master.vm.hostname = \"master-node\"\n    master.vm.network \"private_network\", ip: IP_NW + \"#{IP_START}\"\n    master.vm.provider \"virtualbox\" do |vb|\n        vb.memory = 4048\n        vb.cpus = 2\n    end\n    master.vm.provision \"shell\", path: \"scripts\/common.sh\"\n    master.vm.provision \"shell\", path: \"scripts\/master.sh\"\n  end\n\n  (1..NUM_WORKER_NODES).each do |i|\n\n  config.vm.define \"node0#{i}\" do |node|\n    node.vm.hostname = \"worker-node0#{i}\"\n    node.vm.network \"private_network\", ip: IP_NW + \"#{IP_START + i}\"\n    node.vm.provider \"virtualbox\" do |vb|\n        vb.memory = 2048\n        vb.cpus = 1\n    end\n    node.vm.provision \"shell\", path: \"scripts\/common.sh\"\n    node.vm.provision \"shell\", path: \"scripts\/node.sh\"\n  end\n\n  end\nend <\/code><\/pre>\n\n\n\n
      As you can see, I have added the following IPs for nodes, and it is added to the host’s file entry of all the nodes with its hostname with a common shell block that gets executed on all the VMs.<\/p>\n\n\n\n
        \n
      1. 10.0.0.10 (master)<\/li>\n\n\n\n
      2. 10.0.0.11 (node01)<\/li>\n\n\n\n
      3. 10.0.0.11 (node02)<\/li>\n<\/ol>\n\n\n\n
        Also, the worker node block is in a loop. So if you want more than two worker nodes or have only one worker node, you need to replace 2<\/code> with the desired number in the loop declaration in the NUM_WORKER_NODES<\/code> variable. If you add more nodes, ensure you add the IP to the host’s file entry.<\/p>\n\n\n\n
        For example, for 3 worker nodes, you need to have,<\/p>\n\n\n\n
        NUM_WORKER_NODES=3<\/code><\/pre>\n\n\n\n
        master.sh, node.sh and common.sh Scripts<\/h3>\n\n\n\n
        The three shell scripts get called as provisioners<\/code> during the Vagrant run to configure the cluster.<\/p>\n\n\n\n
          \n
        1. common.sh<\/strong>: – A self-explanatory list of commands which configures and installs specific version of cri-o runtime, kubeadm, kubectl, and kubelet on all the nodes. Also, disables swap.<\/li>\n\n\n\n
        2. master.sh<\/strong>: – contains commands to initialize master, install the calico plugin, metrics server, and kubernetes dashboard. Also, copies the\u00a0kube-config, join.sh, and token<\/strong>\u00a0files to the configs directory.<\/li>\n\n\n\n
        3. node.sh:-\u00a0<\/strong>reads the join.sh command from the configs shared folder and join the master node. Also, copied the kubeconfig file to\u00a0\/home\/vagrant\/.kube<\/code>\u00a0location to execute kubectl commands.<\/li>\n<\/ol>\n\n\n\n
          common.sh<\/code> installs kubernetes version 1.20.6-00<\/code> to have the same cluster version for CKA\/CKAD and CKS preparation. If you would like the latest version, remove the version number from the command.<\/p>\n\n\n\n
          Video Documentation For Vagrant Setup<\/h2>\n\n\n\n
          I have documented the whole process in a YouTube video. Check out the video if you want to see the live setup.<\/p>\n\n\n\n
          Note<\/strong>: You might see a version change in the video as I update the document with latest versions. However, the process remains the same. Ensure you use the latest scripts from the Github repo.<\/p>\n\n\n\n
          \nhttps:\/\/youtube.com\/watch?v=m5q7JEihdU4%3Ffeature%3Doembed\n<\/div><\/figure>\n\n\n\n
          Conclusion<\/h2>\n\n\n\n
          It is good to have a Local kubernetes cluster setup that you can spin up and tear down whenever you need without spending much time.<\/p>\n\n\n\n
          To set up the kubernetes cluster on Vagrant, all you have to do is, clone the repo and run the vagrant up<\/code><\/strong> command.<\/p>\n\n\n\n
          Moreover, if you are a DevOps engineer<\/a> and work on the Kubernetes cluster, you can have a production-like setup locally for development and testing.<\/p>\n\n\n\n
          If you want to have a simple single-node Kubernetes setup, you can try minikube. Here is a minikube tutorial for beginners<\/a>.<\/p>\n\n\n\n
          You can add more tools and utilities like helm<\/a>, ingress controller<\/a>, Prometheus<\/a>, etc to the existing script and customize it as per your requirements.<\/p>\n\n\n\n
          Please feel free to contribute to the repo with enhancements!<\/p>\n","protected":false},"excerpt":{"rendered":"
          In this Kubernetes tutorial, I have covered the step-by-step guide to set up the Kubernetes cluster on Vagrant. It is a multinode kubernetes setup using kubeadm. Vagrant is a great utility to set up Virtual machines on your local workstation. I pretty much use Vagrant for most of my testing and learning purposes. If you are new […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-28","post","type-post","status-publish","format-standard","hentry","category-devops"],"_links":{"self":[{"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=\/wp\/v2\/posts\/28","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=28"}],"version-history":[{"count":1,"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=\/wp\/v2\/posts\/28\/revisions"}],"predecessor-version":[{"id":31,"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=\/wp\/v2\/posts\/28\/revisions\/31"}],"wp:attachment":[{"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=28"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=28"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.ngocha.biz\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=28"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}