{"id":21657277,"url":"https://github.com/zcubbs/zrun","last_synced_at":"2025-06-15T13:02:28.967Z","repository":{"id":160884346,"uuid":"609695768","full_name":"zcubbs/zrun","owner":"zcubbs","description":"zrun is a comprehensive command-line interface (CLI) that provides a range of functionalities from installing k3s, managing Helm Deployments \u0026 Argocd applications to Git operations and more...","archived":false,"fork":false,"pushed_at":"2023-10-30T15:41:57.000Z","size":1181,"stargazers_count":5,"open_issues_count":9,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T22:12:47.104Z","etag":null,"topics":["argocd","cert-manager","docker","go","helm","k3s","k8s","kubernetes","traefik"],"latest_commit_sha":null,"homepage":"","language":"Go","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/zcubbs.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}},"created_at":"2023-03-05T00:15:19.000Z","updated_at":"2023-08-28T13:28:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"2d77f4d4-e68e-4435-b4c6-559837cbd608","html_url":"https://github.com/zcubbs/zrun","commit_stats":null,"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcubbs%2Fzrun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcubbs%2Fzrun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcubbs%2Fzrun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcubbs%2Fzrun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zcubbs","download_url":"https://codeload.github.com/zcubbs/zrun/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248487684,"owners_count":21112190,"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":["argocd","cert-manager","docker","go","helm","k3s","k8s","kubernetes","traefik"],"created_at":"2024-11-25T09:20:23.825Z","updated_at":"2025-04-11T22:13:05.054Z","avatar_url":"https://github.com/zcubbs.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zrun\n\n[![lint](https://github.com/zcubbs/zrun/actions/workflows/lint.yml/badge.svg)](https://github.com/zcubbs/zrun/actions/workflows/lint.yml)\n[![release](https://github.com/zcubbs/zrun/actions/workflows/release.yml/badge.svg)](https://github.com/zcubbs/zrun/actions/workflows/release.yml)\n[![vulnerability-scan](https://github.com/zcubbs/zrun/actions/workflows/vulnerability-scan.yml/badge.svg)](https://github.com/zcubbs/zrun/actions/workflows/vulnerability-scan.yml)\n\n---\n\u003cp align=\"center\"\u003e\n  _ _ . .  . _ .  . . _  _ .\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"550\" src=\"docs/img/zrun_dark.jpg\"\u003e\n\u003c/p\u003e\n\n---\n\n**zrun** is a comprehensive command-line interface (CLI) that provides a range of functionalities from installing k3s, managing Helm Deployments \u0026 Argocd applications to Git operations and more...\n\n## Install\n\n```bash\ncurl -sfL https://raw.githubusercontent.com/zcubbs/zrun/main/scripts/install/install.sh | bash\n```\n\n---\n\n## Demo\n\n![](docs/img/demo.gif)\n\n## Available Commands\n\n- `about` - Print the info about ZRun\n- `argo` - ArgoCD Commands\n- `awx` - AWX Management Commands\n- `certmanager` - cert-manager Commands\n- `completion` - Generate the autocompletion script for the specified shell\n- `config` - List CLI configuration\n- `git` - Git Helper Commands\n- `hello` - Used for test purposes\n- `helm` - Helm Application Deployment/Control Commands\n- `help` - Help about any command\n- `info` - A palette that contains system info commands\n- `k3s` - K3s management commands\n- `k8s` - Kubernetes Management Commands\n- `k9s` - Run K9s\n- `os` - OS Helper Commands\n- `traefik` - traefik Commands\n- `upgrade` - Used to upgrade ZRun to the latest version\n- `vault` - Vault Helper Commands\n- `version` - Print the version number of ZRun\n\n### Global Flags\n\n- `-h, --help` - Help for this command\n- `-v, --verbose` - Verbose output\n\n### Sub-Commands \n\n- `k3s` - K3s management commands\n  - **Usage**: `k3s [flags]` or `k3s [command]`\n  - **Available Sub-Commands**:\n    - `install` - Install k3s\n    - `uninstall` - Uninstall k3s\n\n- `argo` - ArgoCD Commands\n  - **Usage**: `argo [flags]` or `argo [command]`\n  - **Available Sub-Commands**:\n    - `add-application` - Manage ArgoCD Applications\n    - `add-project` - Add project to ArgoCD\n    - `add-repository` - Add repository to ArgoCD\n    - `install` - Install argo-cd Chart\n  - **Flags**:\n    - `-n, --namespace string` - Namespace (default \"argo-cd\")\n\n- `certmanager` - cert-manager Commands\n  - **Usage**: `certmanager [flags]` or `certmanager [command]`\n  - **Available Sub-Commands**:\n    - `install` - Install cert-manager Chart\n    - `issuer` - Setup cert-manager issuer\n\n- `traefik` - traefik Commands\n  - **Usage**: `traefik [flags]` or `traefik [command]`\n  - **Available Sub-Commands**:\n    - `ingressroute` - Create IngressRoute\n    - `install` - Install traefik Chart\n\n- `helm` - Helm Application Deployment/Control Commands\n  - **Usage**: `helm [flags]` or `helm [command]`\n  - **Available Sub-Commands**:\n    - `install-chart` - List all helm releases\n    - `install-helm` - Install helm CLI\n    - `list` - List all helm releases\n    - `uninstall-chart` - List all helm releases\n\n## Contributing\n\nIf you want to contribute to this project, please read the [contributing guidelines](CONTRIBUTING.md).\n\n### Pre-requisites\n\n- [Go](https://go.dev/doc/install) 1.20 or later\n- Docker: (depending on OS)\n  - [Docker](https://docs.docker.com/get-docker/) 20.10 or later\n  - [Docker Compose](https://docs.docker.com/compose/install/) 1.29 or later\n  - [Rancher Desktop](https://rancherdesktop.io/) 0.6.0 or later\n- [GNU Make](https://www.gnu.org/software/make/) 4.3 or later\n- [GNU Bash](https://www.gnu.org/software/bash/) 5.1 or later\n- [GoSec](https://github.com/securego/gosec)\n  - `go install github.com/securego/gosec/v2/cmd/gosec@latest`\n- [golangci-lint](https://golangci-lint.run/usage/install/) 1.42 or later \n  - `go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest`\n- [Cobra CLI](https://github.com/spf13/cobra-cli) 1.2 or later\n  - `go install github.com/spf13/cobra-cli@latest`\n- Virtual Machines:\n  - Windows\n    - [VirtualBox](https://www.virtualbox.org/wiki/Downloads) 6.1 or later\n    - [Vagrant](https://www.vagrantup.com/downloads) 2.2 or later\n  - MacOS\n    - [Lima](https://github.com/lima-vm/lima) 0.6.0 or later\n    - [nerdctl](https://github.com/containerd/nerdctl) 0.12.0 or later\n\n### Tooling\n\n#### Lint\n```bash\nmake lint\n```\n\n#### Test\n```bash\nmake test\n```\n\n#### Cobra\nExtending the command line:\n```bash\ncobra-cli add \u003ccommand\u003e\n```\n\n#### Vagrant\nSpin up a local Ubuntu VM (with a builtin zrun binary for testing:\n\n```bash\nmake vssh\n```\n\n---\n## License\n\n[Apache 2.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzcubbs%2Fzrun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzcubbs%2Fzrun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzcubbs%2Fzrun/lists"}