Skip to content

Latest commit

 

History

History
127 lines (105 loc) · 8.1 KB

README.md

File metadata and controls

127 lines (105 loc) · 8.1 KB

Welcome to K8 Mate - v1.0.0

Welcome to K8 Mate, a light-weight, easy-to-use Kubernetes management and observability tool.

Features
Dashboard for key metrics monitoring via Prometheus API
Real-time alerts for resource usage, pod outages, restarts, and other structural changes
K8 cluster visualization tool via React Flow to manage and cluster architecture
Built-in Terminal view to manage your cluster, nodes, pods, and services

Getting Started

IMPORTANT -- Requirements to Use K8 Mate

✅ Active Kubernetes cluster spun up
✅ Kubectl configured on local machine
✅ Prometheus installed on your K8 cluster
✅ Grafana installed on your K8 cluster
✅ An active database for your team in PostgresQL (only supported at this time)

How to Run the App

  1. Install npm dependencies npm install in the root, front-end, and backend directories, for a total of 3 times.
  2. Expose port 9090 to the Prometheus API kubectl port-forward svc/prometheus-node-port-service 9090:9090
  3. Expose port 3000 to the Grafana service node kubectl port-forward svc/grafana-node-port-service 3000:80
  4. Run the development server npm run dev from the root directory
  5. Connect your DB in the settings tab! Setup is already provided in our backend directory to interact with your DB.
  6. All done!

Feature Highlights

Reports Alerts
dashboard-showcase alerts-showcase
K8 Visualization In-App Terminal
K8 Dashboard K8 Terminal

Want to Contribute?

Our goal is to continue to evolve K8 Mate, expanding features while maintaing its ease-of-use. We're grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving K8 Mate.

  • Fork the project.
  • Create and work off of your feature branch.
  • Create a pull request with a detailed description of your changes from your feature branch to dev branch.
  • Please let us know when PR submission is done. Once the changes are reviewed and approved, we will merge your code into the main repository.

Follow our dev READme to learn more

Meet the team

Owners GitHub LinkedIn
Jonathan Si GitHub LinkedIn
Aaron Thien GitHub LinkedIn
Richard To GitHub LinkedIn
Stephen Sinco GitHub LinkedIn