Kubernetes Operational View
You can run the app locally with
kubectl proxy against your running cluster:
$ kubectl proxy &
$ docker run -it --net=host hjacobs/kube-ops-view
If you are using Docker for Mac, this needs to be slightly different in order to navigate the VM/container inception:
$ kubectl proxy --accept-hosts '.*' &
$ docker run -it -p 8080:8080 -e CLUSTERS=http://docker.for.mac.localhost:8001 hjacobs/kube-ops-view
Now direct your browser to http://localhost:8080
You can also try the UI with the integrated mock mode. This does not require any Kubernetes cluster access:
$ docker run -it -p 8080:8080 hjacobs/kube-ops-view --mock
You can find example Kubernetes manifests for deployment in the
It should be as simple as:
$ kubectl apply -f deploy # apply all manifests from the folder
Afterwards you can open "kube-ops-view" via the kubectl proxy:
Now direct your browser to http://localhost:8001/api/v1/namespaces/default/services/kube-ops-view/proxy/
Kubernetes Operational View is also available as a Helm Chart.
The app can be started in "mock mode" to work on UI features without running any Kubernetes cluster:
$ pipenv install && pipenv shell
$ (cd app && npm start &) # watch and compile JS bundle
$ python3 -m kube_ops_view --mock --debug
Makefile will generate a Docker image by default:
Multiple clusters are supported by passing a list of API servers, reading a kubeconfig file or pointing to an HTTP Cluster Registry endpoint.
See the documentation on multiple clusters for details.
The following environment variables are supported:
- Optional OAuth 2 authorization endpoint URL for protecting the UI.
- Optional token endpoint URL for the OAuth 2 Authorization Code Grant flow.
- Optional scope specifies level of access that the application is requesting.
- Comma separated list of Kubernetes API server URLs. It defaults to
http://localhost:8001/ (default endpoint of
- URL to cluster registry returning list of Kubernetes clusters.
- Directory to read (OAuth) credentials from --- these credentials are only used for non-localhost cluster URLs.
- Set to "true" for local development to reload code changes.
- Path to kubeconfig file to use for cluster access.
- Comma separated list of contexts to use when reading the kubeconfig file from
- Set to "true" to mock Kubernetes cluster data.
- Interval in seconds for querying clusters (default: 5). Each cluster will at most queried once per configured interval.
- Optional Redis server to use for pub/sub events and job locking when running more than one replica. Example:
- HTTP port to listen on. It defaults to
The UI uses WebGL, ECMAScript 6, and EventSource 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.
Easiest way to contribute is to provide feedback! We would love to hear what you like and what you think is missing.
Create an issue or ping try_except_ on Twitter.
PRs are welcome. Please also have a look at issues labeled with "help wanted".
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/.