{"id":20424933,"url":"https://github.com/stackzoo/k8s-local-cluster","last_synced_at":"2026-05-06T15:31:51.068Z","repository":{"id":144888281,"uuid":"613267082","full_name":"stackzoo/k8s-local-cluster","owner":"stackzoo","description":"Deploy a local multinode k8s cluster with vagrant and ansible 🔧 ☸️","archived":false,"fork":false,"pushed_at":"2023-03-13T09:29:01.000Z","size":13,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-01-15T15:08:27.344Z","etag":null,"topics":["ansible","development","kubernetes","vagrant"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stackzoo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-13T08:36:57.000Z","updated_at":"2023-04-13T09:45:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"00d01381-7370-487f-99d7-0f5b773fd403","html_url":"https://github.com/stackzoo/k8s-local-cluster","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackzoo%2Fk8s-local-cluster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackzoo%2Fk8s-local-cluster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackzoo%2Fk8s-local-cluster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackzoo%2Fk8s-local-cluster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stackzoo","download_url":"https://codeload.github.com/stackzoo/k8s-local-cluster/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241966977,"owners_count":20050324,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","development","kubernetes","vagrant"],"created_at":"2024-11-15T07:11:32.855Z","updated_at":"2026-05-06T15:31:51.034Z","avatar_url":"https://github.com/stackzoo.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# k8s-local-cluster\n[![ansible-lint](https://github.com/stackzoo/k8s-local-cluster/actions/workflows/ansible-lint.yml/badge.svg)](https://github.com/stackzoo/k8s-local-cluster/actions/workflows/ansible-lint.yml)\n\nDeploy a local multinode k8s cluster with vagrant and ansible 🔧 ☸️\n\n## Abstract\nThis repo allows you to create a local development cluster using `vagrant` and `ansible`.\n\u003cbr/\u003e\nSolutions like `KinD` and `Minikube` are excellent but often limited.\n\u003cbr/\u003e\nWith a cluster made up of several VMs it is possible to test a scenario that is closer to a production context.\n\n## Prerequisites\n- `ansible`\n- `vagrant`\n\n\n## Instructions\n\n### Define amount of nodes\nModify the following variable in Vagrantfile:\n```\nN = \u003cnumber of worker node here\u003e\n```\n\n\n### Spin up cluster\n```\n$ vagrant up\n```\n\n### Verify on master\n```\n$ vagrant ssh k8s-master\n$ kubectl get nodes\nNAME            STATUS   ROLES                  AGE           VERSION\nk8s-master      Ready    control-plane,master   5m6s          v1.26.0\nk8s-worker-1    Ready    \u003cnone\u003e                 2m59s         v1.26.0\nk8s-worker-2    Ready    \u003cnone\u003e                   68s         v1.26.0\n```\n\n## Useful Commands\n\n*vagrant status* — Get the current status of your VM\n\n*vangrant destroy* — Remove all traces of the virtual machine from your system\n\n*vagrant suspend* — Stop the machine and save its current state.\n\n*vagrant provision {vm-name}* — Manually execute ansible playbook against a VM.\n\n*vagrant halt* — Shut down the virtual machine.\n\n*vagrant box list* - List local vagrant box images\n\n*vagrant box remove {vagrant-box-image-name}* - Remove local vagrant box images\n\n*vagrant plugin list* - List local vagrant plugins\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackzoo%2Fk8s-local-cluster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstackzoo%2Fk8s-local-cluster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackzoo%2Fk8s-local-cluster/lists"}