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.
Features
Development
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:
Clone the repository, login to GitHub packages and install the required dependencies:
git clone git@github.com: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 14122
:
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:
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
Release
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 Makefile
:
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.AppImage
: AppImagekubenav-<TAG>-linux.tar.gz
: Archive containing the kubenav app for Linuxkubenav-<TAG>-mac.dmg
: Apple Disk Imagekubenav-<TAG>-mac.tar.gz
: Archive containing the kubenav app file for macOSkubenav-<TAG>-win.exe
: NSIS installerkubenav-<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.
from Hacker News https://ift.tt/2RD79qW
No comments:
Post a Comment
Note: Only a member of this blog may post a comment.