{"id":20053604,"url":"https://github.com/lpabon/kubeup","last_synced_at":"2026-02-27T15:07:25.509Z","repository":{"id":23745229,"uuid":"99065548","full_name":"lpabon/kubeup","owner":"lpabon","description":"Simple Kubernetes cluster ","archived":false,"fork":false,"pushed_at":"2025-01-10T03:23:14.000Z","size":130,"stargazers_count":11,"open_issues_count":0,"forks_count":17,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-05T12:42:42.326Z","etag":null,"topics":["containers","docker","kubernetes","kubernetes-setup","kubeup","libvirt"],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lpabon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2017-08-02T02:56:54.000Z","updated_at":"2025-01-10T03:23:18.000Z","dependencies_parsed_at":"2024-11-13T12:29:32.870Z","dependency_job_id":"b803944d-c57b-490c-a339-7c5f2e094375","html_url":"https://github.com/lpabon/kubeup","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/lpabon/kubeup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lpabon%2Fkubeup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lpabon%2Fkubeup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lpabon%2Fkubeup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lpabon%2Fkubeup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lpabon","download_url":"https://codeload.github.com/lpabon/kubeup/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lpabon%2Fkubeup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29901265,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T14:46:13.553Z","status":"ssl_error","status_checked_at":"2026-02-27T14:46:10.522Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["containers","docker","kubernetes","kubernetes-setup","kubeup","libvirt"],"created_at":"2024-11-13T12:27:54.092Z","updated_at":"2026-02-27T15:07:25.494Z","avatar_url":"https://github.com/lpabon.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kubeup\nSimple Kubernetes cluster creator based on\n[kubeadm](http://kubernetes.io/docs/admin/kubeadm/) for libvirt (Linux).\nDefault setup is a single master with three nodes\n\n## Kubernetes Versions Supported\n\n`master` branch contains support for the last three verions of Kubernetes.\n\n### Git Tags\n\n* Tag `v3.0.0+` uses K3S+Cilium and no kube-proxy\n* Tag `v2.0.0+` supports up to Kubernetes 1.25\n* Tag `v1.0.0` supports up to Kubernetes 1.23\n\n## Requirements\n\nInstall qemu-kvm, libvirt\n\n### Ubuntu\n\n```\nsudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils\n```\n\n### Fedora\n\n```\nsudo dnf -y install qemu-kvm libvirt\n```\n\n### CentOS 7\n\n* Run the following:\n\n```\nsudo yum install epel-release\nsudo yum install qemu libvirt qemu-kvm\n```\n\n# Usage\n\n## Install vagrant\n\nRun this command to create your `~/.vagrantd` directory:\n\n```\nvagrant version\n```\n\n## Add your user to libvirt group\n```\nsudo usermod -a -G libvirt $(whoami)\n```\n\nThis will allow the *up.sh* script to run without *sudo* later on.\n\nYou may also need to restart libvirtd to pick up the change.\n\n```\nsudo systemctl restart libvirtd.service\n```\n\n## Create global_vars.yml\n\nIf you have not already done so, create `global_vars.yml`:\n\n```\n$ cp global_vars.yml.tmpl global_vars.yml\n```\n\nEdit `global_vars.yml` accordingly, then to create the cluster, type:\n\n```\n$ ./up.sh\n```\n\nThe Kubernetes configuration is then copied from the master node to the host and can be used as follows:\n\n```\n$ kubectl --kubeconfig=kubeconfig-k8s1.conf get nodes\nNAME                  STATUS   ROLES    AGE     VERSION\nlpabon-k8s-1-master   Ready    master   8m12s   v1.19.5\nlpabon-k8s-1-node0    Ready    \u003cnone\u003e   7m44s   v1.19.5\nlpabon-k8s-1-node1    Ready    \u003cnone\u003e   7m44s   v1.19.5\nlpabon-k8s-1-node2    Ready    \u003cnone\u003e   7m45s   v1.19.5\n```\n\n### kubeup script\n\nKubeup uses a container to run `vagrant` and `vagrant-libvirt`. For convenience\na script called `kubeup` has been provided.\n\nUse this script to prefix all your vagrant commands. For example:\n\n```\n$ ./kubeup vagrant ssh lpabon-k8s-1-node0\n```\n\n# Using a local Docker registry\nIt may be necessary to setup your own registry for your images. Not only\nwill this keep your images private, but it will also make it accessible\nby Kubernetes faster, since the images are pulled over a local host network.\n\nFollow the instructions in [Deploying a local registry\nserver](https://distribution.github.io/distribution/#basic-commands)\nto deploy your docker registry on your host machine.  This registry can only be\naccessed over localhost. CRI clients running in the Kubernetes VMs will not\nbe able to access the registry directly. For this reason, kubeup sets up a\ntunnel service from each VM to the registry running on the host. This service\nuses `socat` to allow the docker client to access your custom registry without\nHTTPS.\n\nSet the following variables in `global_vars.yml`:\n\n```yaml\ndocker_localregistry: true\ndocker_localregistry_host: \u003chost ip address running docker registry\u003e\ndocker_localregistry_port: \u003cport of docker registry\u003e\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flpabon%2Fkubeup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flpabon%2Fkubeup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flpabon%2Fkubeup/lists"}