Files
kops-arm64/README.rst
2016-12-16 23:41:58 +01:00

87 lines
2.7 KiB
ReStructuredText

===========================
Kubernetes Operational View
===========================
Goal: provide a common operational picture for multiple Kubernetes clusters.
* Render nodes and indicate their overall status ("Ready")
* Show node capacity and resource usage (CPU, memory)
* Render one "box" per CPU and fill up to sum of pod CPU requests
* Render vertical bar for total memory and fill up to sum of pod memory requests
* Render individual pods
* Indicate pod status by border line color (green: ready/running, yellow: pending, red: error etc)
* Show current CPU usage (gather from Heapster) by tinting ("hot" color: high CPU usage)
* System pods ("kube-system" namespace) should be grouped together
* Provide tooltip information for nodes and pods
What it is not:
* It's not a replacement for the `Kubernetes Dashboard`_. The Kubernetes Dashboard is a general purpose UI which allows managing applications.
* It's not a monitoring solution. Use your preferred monitoring system to alert on production issues.
* It's not a operation management tool. Kubernetes Operational View does not allow interacting with the actual cluster.
Usage
=====
You can run the app locally:
.. code-block:: bash
$ pip3 install -r requirements.txt
$ kubectl proxy &
$ ./app.py
Now direct your browser to http://localhost:8080
You can find example Kubernetes manifests for deployment in the ``deploy`` folder.
It should be as simple as:
.. code-block:: bash
$ kubectl apply -f deploy/deployment.yaml deploy/service.yaml
Afterwards you can open "kube-ops-view" via the kubectl proxy:
.. code-block:: bash
$ kubectl proxy
Now direct your browser to http://localhost:8001/api/v1/proxy/namespaces/default/services/kube-ops-view/
Supported Browsers
==================
The UI uses WebGL and ECMAScript 6 features.
The following browsers are known to work:
* Chrome/Chromium 53.0+
* Mozilla Firefox 49.0+
See the `ECMAScript 6 Compatibility Table`_ for details on supported browser versions.
License
=======
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see http://www.gnu.org/licenses/.
.. _Kubernetes Dashboard: https://github.com/kubernetes/dashboard
.. _ECMAScript 6 Compatibility Table: https://kangax.github.io/compat-table/es6/