{"id":19741042,"url":"https://github.com/xtigyro/kindadm","last_synced_at":"2025-04-30T05:33:55.236Z","repository":{"id":38841265,"uuid":"217720173","full_name":"Xtigyro/kindadm","owner":"Xtigyro","description":"Create and administer a local one or multi-node Kubernetes cluster(s) preset for development with simple commands.","archived":false,"fork":false,"pushed_at":"2024-04-02T17:15:16.000Z","size":253,"stargazers_count":28,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-04-02T18:29:41.909Z","etag":null,"topics":["container-registry","deploy","helm","helmfile","ingress-nginx","kind","kubernetes","kubernetes-cluster","kubernetes-dashboard","local","metallb","metrics-server","multi-node-kubernetes","weave-scope"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Xtigyro.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}},"created_at":"2019-10-26T14:23:54.000Z","updated_at":"2024-04-02T18:29:48.442Z","dependencies_parsed_at":"2024-04-02T18:29:46.602Z","dependency_job_id":"6e655e2a-b4cd-490e-b43c-c1940586e91b","html_url":"https://github.com/Xtigyro/kindadm","commit_stats":null,"previous_names":[],"tags_count":85,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xtigyro%2Fkindadm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xtigyro%2Fkindadm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xtigyro%2Fkindadm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xtigyro%2Fkindadm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xtigyro","download_url":"https://codeload.github.com/Xtigyro/kindadm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224200392,"owners_count":17272434,"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":["container-registry","deploy","helm","helmfile","ingress-nginx","kind","kubernetes","kubernetes-cluster","kubernetes-dashboard","local","metallb","metrics-server","multi-node-kubernetes","weave-scope"],"created_at":"2024-11-12T01:24:28.446Z","updated_at":"2024-11-12T01:24:28.987Z","avatar_url":"https://github.com/Xtigyro.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kindadm\n\nCreate and administer a local one or multi-node Kubernetes cluster(s) in Docker container(s) with properly configured [Helm](https://github.com/helm/helm), [Ingress Controller](https://github.com/kubernetes/ingress-nginx), [MetalLB](https://github.com/metallb/metallb), [Metrics Server](https://github.com/kubernetes-sigs/metrics-server), and [Kubernetes Dashboard](https://github.com/kubernetes/dashboard) with simple interactive commands.\n\nSupported Opt-In Software: [Docker Container Registry](https://docs.docker.com/registry/), and [Weave Scope](https://www.weave.works/oss/scope/).\n\n## Quick Start\n\nTo create a local one or multi-node Kubernetes (K8s) cluster(s) - please run:\n\n```bash\n## extra args are optional.\n#\nkindadm --nodes=[1-99] --k8s_ver=1.[x].[x] --helm_ver=[2/3].[x].[x]\n```\n\nTo purge interactively any created cluster(s):\n\n```bash\nkindadm --purge\n```\n\n## Helper Menu\n\n```console\n# kindadm -h\n\nUsage:\n    --all-labelled,-al      Set labels on all K8s nodes.\n    --all-tainted,-at       Set taints on all K8s nodes. A different label can be defined.\n    --create-registry,-cr   Create local container registry for K8s cluster(s).\n    --half-labelled,-hl     Set labels on half K8s nodes.\n    --half-tainted,-ht      Set taints on half K8s nodes. A different label can be defined.\n    --helm_ver,-hv          Set Helm version to be installed.\n    --k8s_ver,-v            Set K8s version to be deployed.\n    --list-oa,-loa          List supported optional app(s).\n    --nodes,-n              Set number of K8s nodes to be created.\n    --opt-apps,-oa          Deploy supported optional app(s).\n    --purge,-p              Purge interactively any existing cluster(s) and related resources.\n    --sys_wide,-sw          Install prerequisites system-wide.\n    --help,-h               Prints this message.\nExample:\n    kindadm -n=2 -v=1.19.1 -hl='nodeType=devops' -ht -oa=weave-scope -cr -hv=2 -sw\n```\n\n### Opt-In Components\n\n- [Docker Container Registry](https://docs.docker.com/registry/).\n\n### Opt-In Apps\n\n- [Weave Scope](https://www.weave.works/oss/scope/).\n\n### Access Deployed Services\n\n#### Kubernetes Dashboard\n\nTo access Kubernetes Dashboard from your local workstation, you must create a secure channel to your Kubernetes cluster. Run the following command:\n\n```bash\nkubectl proxy\n```\n\nNow you can access the dashboard at:\n\n[`http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:https/proxy/`](\nhttp://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:https/proxy/).\n\n#### Weave Scope\n\nTo access Weave Scope (if deployed) from your local workstation, run the following command:\n\n```bash\nkubectl port-forward -n weave svc/weave-scope-weave-scope 80\n```\n\nNow you can access the Weave Scope Frontend at:\n\n[`http://localhost:80`](http://localhost:80).\n\n## Prerequisites\n\nBy default `kindadm` does the following:\n\n- Checks and advises (no install) on the system-wide prerequisites:\n\n1. Linux Docker Container Runtime.\n\n- Checks and installs in a self-contained `.cache` dir:\n\n1. `kubectl` binary.\n2. `helm` binary.\n3. Helm plugins: `helm-diff`.\n4. `helmfile` binary.\n5. `kind` binary.\n\nWith `--sys_wide` flag the aforementioned binaries will be installed system-wide (in `/usr/local/bin` dir).\n\n\u003e **NOTE**: Changes are applied only if needed.\n\n## Credits\n\nMy name is [Miroslav Hadzhiev](https://www.linkedin.com/in/mehadzhiev/) - a Cloud \u0026 DevOps Engineer located in Sofia, Bulgaria. I'm glad that you liked my automation.\n\n## License\n\nGNU General Public License v2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxtigyro%2Fkindadm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxtigyro%2Fkindadm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxtigyro%2Fkindadm/lists"}