kubenav is the navigator for your Kubernetes clusters right in your pocket. kubenav is a mobile and desktop app to help you manage Kubernetes clusters and stay up to date on whats going on in your clusters.
kubenav is a mobile and desktop app to help you manage Kubernetes clusters. The app provides an overview of all your workloads and resources running in your clusters, including the current status. The details view of your workloads contains all the necessary logs and events to debug your clusters in case of problems. You can also edit and delete resources within the app.
The app is developed using Ionic Framework and Capacitor. The most parts of the app are implemented using React functional component and TypeScript. So we can achieve nearly 100% code sharing between the mobile and desktop implementation.
- Available for mobile and desktop: kubenav is available for mobile and desktop with nearly 100% code sharing.
- Manage Workloads: Manage workloads like Deployments, Pods and StatefulSets in your Kubernetes cluster.
- View your resources: Get an overview of other resources like Services, ConfigMaps, Persistent Volumes, Secrets and Role Bindings.
- CRD support: Out of the box support for Custom Resource Definitions.
- Filter: Filter the resource overview by the selected Namespace.
- Debugging: Automatic detection of problems with your Workloads. Get all corresponding events and logs.
- Edit YAML files: Edit and save your YAML files right from the app.
- Delete resources: Delete resources which are not needed anymore.
- Resource usage: Get the resource usage of your nodes, pods and containers.
- Manage multiple clusters: Add multiple clusters via
kubenav requires Node v8.6.0 or later, and NPM version 5.6.0 or later (which is usually automatically installed with the required version of Node). If you have Node and NPM installedm, install Ionic CLI:
npm install -g ionic
Clone the repository, login to GitHub packages and install the required dependencies:
git clone firstname.lastname@example.org:kubenav/kubenav.git cd kubenav npm login --registry=https://npm.pkg.github.com npm install
To use kubenav in you browser you need to start the development server. The server listening on port
npm run server
Now you can start the app and open localhost:8100 in your browser:
You must build the kubenav project at least once before running on any native platform:
Every time you perform a build (e.g.
ionic build) that changes your web directory (default:
build), you'll need to copy those changes down to your native projects:
npx cap sync
The native iOS and Android projects are opened in their standard IDEs (Xcode and Android Studio, respectively). Use the IDEs to run kubenav:
npx cap open ios npx cap open android npx cap open electron
You can also run the native iOS or Android app with live reloading:
ionic capacitor run android -l --address=0.0.0.0 ionic capacitor run ios -l --address=0.0.0.0
Every new release is created from the
master branch. To create a new release the
version field in the
package.json file must be updated and a new tag must be set. This process is automated via
make release-patch make release-minor make release-major
When the tag is pushed the changelog will be generated via GitHub Action and saved to the CHANGELOG.md file. When the changelog was generated a new GitHub release can be created with the following naming scheme and the changelog for the current tag as description:
Version <TAG> (yyyy-mm-dd)
After the the release was created another GitHub Action is executed to create the Electron app for macOS, Linux and Windows via electron-builder. These files are added to the corresponding release. The following formats are available:
kubenav-<TAG>-linux.tar.gz: Archive containing the kubenav app for Linux
kubenav-<TAG>-mac.dmg: Apple Disk Image
kubenav-<TAG>-mac.tar.gz: Archive containing the kubenav app file for macOS
kubenav-<TAG>-win.exe: NSIS installer
kubenav-<TAG>-win.tar.gz: Archive containing the kubenav app for Windows
The native iOS and Android app is built manually and submitted to the App Store and Google Play. To prepare the app run the following commands:
export REACT_APP_VERSION= ionic build npx cap sync npx cap open ios npx cap open android
In the standard IDE for iOS and Android run a clean build and follow the steps to publish the app.