back to listing index

hjacobs/kube-ops-view

[web search]
Original source (github.com)
Tags: kubernetes
Clipped on: 2019-07-09

Skip to content
Kubernetes Operational View - read-only system dashboard for multiple K8s clusters https://kubernetes-operational-view.r…
Branch: master
New pull request
Clone or download
Image (Asset 3/7) alt= app #229 Scale clusters properly (#230) last month deploy use v1 API version for RBAC last month docs fix oauth + github example 4 months ago examples draw unassigned pods 3 years ago kube_ops_view Added missing http-headers (#232) last month tests #96 move error handling into update loop 3 years ago .dockerignore update Docker base images (#212) 4 months ago .gitattributes Fix a problem regarding EOL on macOS (#202) 5 months ago .gitignore Update dependencies (#163) last year .travis.yml update dependencies (#185) 7 months ago Dockerfile update Docker base images (#212) 4 months ago LICENSE add license 3 years ago MANIFEST.in #90 configure tox 3 years ago Makefile update Docker base images (#212) 4 months ago Pipfile use Flask Dance instead of deprecated flask-oauthlib 4 months ago Pipfile.lock update deps last month README.rst add badge for docker pulls 4 months ago kube-ops-view-logo.png #127 add logo 2 years ago kube-ops-view-logo.svg #127 add logo 2 years ago pipenv-install.py update dependencies (#185) 7 months ago screenshot.png update screenshot 3 years ago setup.py add version 3 years ago tox.ini update dependencies (#185) 7 months ago

README.rst

Kubernetes Operational View

Image (Asset 4/7) alt=Usage

Running Locally

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

Installation

You can find example Kubernetes manifests for deployment in the deploy folder. 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:

$ 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.

Development

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

Building

The provided Makefile will generate a Docker image by default:

$ make

Multiple Clusters

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.

Configuration

The following environment variables are supported:

AUTHORIZE_URL
Optional OAuth 2 authorization endpoint URL for protecting the UI.
ACCESS_TOKEN_URL
Optional token endpoint URL for the OAuth 2 Authorization Code Grant flow.
SCOPE
Optional scope specifies level of access that the application is requesting.
CLUSTERS
Comma separated list of Kubernetes API server URLs. It defaults to http://localhost:8001/ (default endpoint of kubectl proxy).
CLUSTER_REGISTRY_URL
URL to cluster registry returning list of Kubernetes clusters.
CREDENTIALS_DIR
Directory to read (OAuth) credentials from --- these credentials are only used for non-localhost cluster URLs.
DEBUG
Set to "true" for local development to reload code changes.
KUBECONFIG_PATH
Path to kubeconfig file to use for cluster access.
KUBECONFIG_CONTEXTS
Comma separated list of contexts to use when reading the kubeconfig file from KUBECONFIG_PATH.
MOCK
Set to "true" to mock Kubernetes cluster data.
QUERY_INTERVAL
Interval in seconds for querying clusters (default: 5). Each cluster will at most queried once per configured interval.
REDIS_URL
Optional Redis server to use for pub/sub events and job locking when running more than one replica. Example: redis://my-redis:6379
SERVER_PORT
HTTP port to listen on. It defaults to 8080.

Supported Browsers

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.

Contributing

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".

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/.