{"id":18469586,"url":"https://github.com/kubero-dev/kubero-cli","last_synced_at":"2025-04-08T10:32:48.942Z","repository":{"id":63245283,"uuid":"557130271","full_name":"kubero-dev/kubero-cli","owner":"kubero-dev","description":"A CLI for kubero ","archived":false,"fork":false,"pushed_at":"2024-10-16T06:30:39.000Z","size":398,"stargazers_count":13,"open_issues_count":2,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-17T22:28:01.076Z","etag":null,"topics":["cli","heroku","kubernetes","paas"],"latest_commit_sha":null,"homepage":"https://www.kubero.dev","language":"Go","has_issues":false,"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/kubero-dev.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":"2022-10-25T06:06:27.000Z","updated_at":"2024-10-16T06:30:43.000Z","dependencies_parsed_at":"2023-12-12T12:27:25.521Z","dependency_job_id":"384487e8-3c97-4524-9515-cc36663005b3","html_url":"https://github.com/kubero-dev/kubero-cli","commit_stats":null,"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubero-dev%2Fkubero-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubero-dev%2Fkubero-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubero-dev%2Fkubero-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubero-dev%2Fkubero-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubero-dev","download_url":"https://codeload.github.com/kubero-dev/kubero-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247824277,"owners_count":21002242,"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":["cli","heroku","kubernetes","paas"],"created_at":"2024-11-06T10:10:59.158Z","updated_at":"2025-04-08T10:32:48.929Z","avatar_url":"https://github.com/kubero-dev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kubero-cli\n\n![Version](https://img.shields.io/github/v/release/kubero-dev/kubero-cli)\n![Build Status](https://img.shields.io/github/actions/workflow/status/kubero-dev/kubero-cli/build.yml?branch=main)\n![License](https://img.shields.io/github/license/kubero-dev/kubero-cli)\n\nA powerful and user-friendly Command Line Interface (CLI) for [Kubero](https://github.com/kubero-dev/kubero), the simplest Platform as a Service (PaaS) for Kubernetes.\n\n\u003e **Note:** Please report any issues in the [main repository](https://github.com/kubero-dev/kubero).\n\n---\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n   - [Supported Platforms](#supported-platforms)\n   - [1. Shortcut Installation](#1-shortcut-installation)\n   - [2. Homebrew Installation](#2-homebrew-installation)\n   - [3. Build from Source](#3-build-from-source)\n- [Supported Providers](#supported-providers)\n- [Usage](#usage)\n   - [Command Overview](#command-overview)\n- [Provider Credentials](#provider-credentials)\n   - [Scaleway](#scaleway)\n   - [Linode](#linode)\n   - [DigitalOcean](#digitalocean)\n   - [Google GKE](#google-gke)\n- [Development Guide](#development-guide)\n- [Contributing](#contributing)\n- [License](#license)\n- [Acknowledgments](#acknowledgments)\n\n---\n\n## Features\n\n- **Easy Cluster Deployment:** Quickly create Kubernetes clusters on supported providers.\n- **App Management:** Simplify application deployment and management.\n- **Pipeline Integration:** Seamlessly integrate CI/CD pipelines.\n- **User-Friendly Commands:** Intuitive CLI commands for efficient workflows.\n- **Dashboard Access:** Easy access to the Kubero dashboard for monitoring.\n\n---\n\n## Installation\n\n### Supported Platforms\n\n- **macOS**\n- **Linux**\n\n### 1. Shortcut Installation\n\nInstall Kubero CLI with a single command:\n\n```shell\ncurl -fsSL get.kubero.dev | bash\n```\n\n### 2. Homebrew Installation\n\nIf Homebrew is not installed, install it first:\n\n```shell\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n```\n\nInstall Kubero CLI via Homebrew:\n\n```shell\nbrew tap kubero-dev/kubero\nbrew install kubero-cli\n```\n\n### 3. Build from Source\n\nFor advanced use cases, build and package the binary manually.\n\n#### Requirements\n\n- [Git](https://git-scm.com/downloads)\n- [Go](https://go.dev/doc/install)\n- [UPX](https://github.com/upx/upx/releases/)\n\n#### Steps\n\n1. **Clone the Repository:**\n\n   ```shell\n   git clone https://github.com/kubero-dev/kubero-cli.git\n   ```\n\n2. **Navigate to the Project Directory:**\n\n   ```shell\n   cd kubero-cli\n   ```\n\n3. **Create a Version Tag (Optional):**\n\n   ```shell\n   git tag -a v1.0 -m \"Version 1.0\"\n   ```\n\n4. **Build and Package the Binary:**\n\n   ```shell\n   cd cmd\n   go build -ldflags \"-s -w -X main.version=$(git describe --tags --abbrev=0) -X main.commit=$(git rev-parse --short HEAD) -X main.date=$(date +%Y-%m-%d)\" -trimpath -o kubero-cli\n   upx kubero-cli\n   mv kubero-cli ../kubero\n   cd ..\n   ```\n\n5. **Move the Binary to Your PATH:**\n\n   ```shell\n   sudo mv kubero /usr/local/bin/\n   ```\n\n6. **Reload Shell Configuration:**\n\n   ```shell\n   source \"$HOME/.$(basename ${SHELL})rc\"\n   ```\n\n7. **Verify Installation:**\n\n   ```shell\n   kubero version\n   ```\n\n8. **Check for Updates:** (Optional)\n\n   ```shell\n   kubero version check\n   ```\n\n---\n\n## Supported Providers\n\nKubero CLI currently supports the following cloud providers:\n\n- **Scaleway**\n- **Linode**\n- **DigitalOcean**\n- **Google GKE**\n- **Kind** (local clusters)\n\n### Coming Soon\n\n- **Vultr**\n- **Oracle Cloud OCI/OKE**\n- **Exoscale**\n- **Swissflow**\n\n---\n\n## Usage\n\n### Command Overview\n\n```plaintext\nkubero\n├── install                # Create a Kubernetes cluster and install Kubero with all required components\n├── list                   # List all running clusters\n├── login                  # Log in to Kubero and save credentials\n├── logout                 # Log out from Kubero and remove saved credentials\n├── create                 # Create new app and pipeline configurations\n│   ├── app\n│   └── pipeline\n├── up                     # Deploy apps and pipelines\n│   ├── app\n│   └── pipeline\n├── down                   # Remove apps and pipelines\n│   ├── app\n│   └── pipeline\n├── fetch                  # Sync configurations to local files\n│   ├── app\n│   └── pipeline\n├── dashboard              # Open the Kubero dashboard\n├── tunnel                 # Open a tunnel to a NAT-ed cluster\n├── instance               # Manage Kubero instances\n│   ├── create             # Create an instance configuration\n│   ├── delete             # Delete an instance configuration\n│   └── select             # Select an active instance\n├── config                 # View available configurations\n│   ├── addons             # List addons\n│   ├── buildpacks         # List buildpacks\n│   └── podsizes           # List pod size configurations\n└── help                   # Display help for commands\n```\n\n---\n\n## Provider Credentials\n\nSet the appropriate environment variables for your cloud provider before using Kubero CLI.\n\n### Scaleway\n\n```shell\nexport SCALEWAY_ACCESS_TOKEN=your_access_token\nexport SCALEWAY_PROJECT_ID=your_project_id\nexport SCALEWAY_ORGANIZATION_ID=your_organization_id\n```\n\n### Linode\n\n```shell\nexport LINODE_ACCESS_TOKEN=your_access_token\n```\n\n### DigitalOcean\n\n```shell\nexport DIGITALOCEAN_ACCESS_TOKEN=your_access_token\n```\n\n### Google GKE\n\n```shell\nexport GOOGLE_API_KEY=your_api_key\n```\n\n---\n\n## Development Guide\n\n### Enable Development Mode\n\nTo enable development mode for testing and debugging, create a `VERSION` file:\n\n```shell\necho \"dev\" \u003e cmd/kuberoCli/VERSION\n```\n\n---\n\n## Contributing\n\nWe welcome contributions from the community! Please check out our [Contributing Guidelines](https://github.com/kubero-dev/kubero/blob/main/CONTRIBUTING.md) for more information.\n\n---\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n## Acknowledgments\n\n- **[Kubero](https://github.com/kubero-dev/kubero):** The simplest PaaS for Kubernetes.\n- **[Go](https://golang.org/):** The programming language used for development.\n- **Community Contributors:** Thank you to all who have contributed to this project.\n\n---\n\nThank you for using **kubero-cli**! If you have suggestions or encounter issues, please open an issue in the [main repository](https://github.com/kubero-dev/kubero).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubero-dev%2Fkubero-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubero-dev%2Fkubero-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubero-dev%2Fkubero-cli/lists"}