Skip to content

oslabs-beta/K8Mate

Repository files navigation

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

About

The only Kubernetes tool you will need!

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •