Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/omrikiei/ktunnel
A cli that exposes your local resources to kubernetes
https://github.com/omrikiei/ktunnel
Last synced: 3 months ago
JSON representation
A cli that exposes your local resources to kubernetes
- Host: GitHub
- URL: https://github.com/omrikiei/ktunnel
- Owner: omrikiei
- License: gpl-3.0
- Created: 2019-09-25T14:41:20.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-10T08:08:23.000Z (8 months ago)
- Last Synced: 2024-03-10T09:25:03.210Z (8 months ago)
- Language: Go
- Homepage:
- Size: 11.5 MB
- Stars: 835
- Watchers: 10
- Forks: 61
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-repositories - omrikiei/ktunnel - A cli that exposes your local resources to kubernetes (Go)
- awesome-k8s-resources - Ktunnel - Ktunnel is a CLI tool that establishes a reverse tunnel between a kubernetes cluster and your local machine. (Tools and Libraries / Command Line Tools)
README
ktunnel
A CLI tool that establishes a reverse tunnel between a kubernetes cluster and your local machine
[]()
[](https://github.com/omrikiei/ktunnel/issues)
[](https://github.com/omrikiei/ktunnel/pulls)
[](https://www.gnu.org/licenses/gpl-3.0)
---
Expose your local resources to kubernetes
## 📝 Table of Contents
- [Installation](#installation)
- [About](#about)
- [Usage](#usage)
- [Documentation](./docs/index.md)
- [Authors](https://github.com/omrikiei/ktunnel/contributors)
## 🏁 Installation
| Distribution | Command / Link |
|-----------------------------------------------------|-----------------------------------------------------------------------------------------|
| Pre-built binaries for macOS, Linux, and Windows | [GitHub releases](https://github.com/omrikiei/ktunnel/releases) |
| Homebrew (macOS and Linux) | `brew tap omrikiei/ktunnel && brew install omrikiei/ktunnel/ktunnel` |
| [Krew](https://krew.sigs.k8s.io/) | `kubectl krew install tunnel` |
### Building from source
Clone the project
```
git clone https://github.com/omrikiei/ktunnel; cd ktunnel
```
Build the binary
```
CGO_ENABLED=0 go build -ldflags="-s -w"
```
You can them move it to your bin path
```
sudo mv ./ktunnel /usr/local/bin/ktunnel
```
Test the command
```
ktunnel -h
```
## 🧐 About
Ktunnel is a CLI tool that establishes a reverse tunnel between a kubernetes cluster and your local machine.
It lets you expose your machine as a service in the cluster or expose it to a specific deployment.
You can also use the client and server without the orchestration part.
*Although ktunnel is identified with kubernetes, it can also be used as a reverse tunnel on any other remote system*
Ktunnel was born out of the need to access my development host when running applications on kubernetes.
The aim of this project is to be a holistic solution to this specific problem (accessing the local machine from a kubernetes pod).
If you found this tool to be helpful on other scenarios, or have any suggesstions for new features - I would love to get in touch.
## 🎈 Usage
### Expose your local machine as a service in the cluster
This will allow pods in the cluster to access your local web app (listening on port 8000) via
http (i.e kubernetes applications can send requests to myapp:8000)
```bash
ktunnel expose myapp 80:8000
ktunnel expose myapp 80:8000 -r #deployment & service will be reused if exists or they will be created
```
### Inject to an existing deployment
This will currently only work for deployments with 1 replica - it will expose a listening port on the pod through a tunnel to your local machine
```bash
ktunnel inject deployment mydeployment 3306
```
### Star History
[](https://star-history.com/#omrikiei/ktunnel&Timeline)
Made with ❤️ in [Gedera](https://en.wikipedia.org/wiki/Gedera)!