Kubernetes History Visualization
Перейти к файлу
nurland 207e913bd8
Update helm chart to use public Sloop image (#63)
2019-11-14 13:03:10 -08:00
helm/sloop Update helm chart to use public Sloop image (#63) 2019-11-14 13:03:10 -08:00
other Make architecture image smaller (#61) 2019-11-14 10:02:53 -08:00
pkg/sloop Fixed author and resource detail page (#59) 2019-11-14 12:49:21 -08:00
.dockerignore Add .git to .dockerignore (#46) 2019-10-16 17:32:10 -07:00
.gitignore Initial commit 2019-09-30 09:17:31 -07:00
.travis.yml Add travis ci support (#39) 2019-10-15 14:54:34 -07:00
CODE_OF_CONDUCT.md Initial commit 2019-09-30 09:17:31 -07:00
CONTRIBUTING.md Initial commit 2019-09-30 09:17:31 -07:00
Dockerfile Implement multi stage docker build (#26) 2019-10-10 16:09:05 -07:00
LICENSE.txt Initial commit 2019-09-30 09:17:31 -07:00
Makefile Update helm chart to use public Sloop image (#63) 2019-11-14 13:03:10 -08:00
README.md Make architecture image smaller (#61) 2019-11-14 10:02:53 -08:00
go.mod use gogen to get keyPredicateFn and valPredicteFn (#30) 2019-10-14 10:20:49 -07:00
go.sum bump go version in go mod and run go mod tidy (#14) 2019-10-08 09:00:54 -07:00
prometheus.yml Initial commit 2019-09-30 09:17:31 -07:00

README.md

Build Status Go Report Card

Sloop - Kubernetes History Visualization

Sloop monitors Kubernetes, recording histories of events and resource state changes and providing visualizations to aid in debugging past events.

Key features:

  1. Allows you to find and inspect resources that no longer exist (example: discover what host the pod from the previous deployment was using).
  2. Provides timeline displays that show rollouts of related resources in updates to Deployments, ReplicaSets, and StatefulSets.
  3. Helps debug transient and intermittent errors.
  4. Allows you to see changes over time in a Kubernetes application.
  5. Is a self-contained service with no dependencies on distributed storage.

Screenshots

Screenshot1

Architecture Overview

Architecture

Install

Sloop can be installed using any of these options:

Helm Chart

Users can install sloop by using helm chart now, for instructions refer helm readme

Precompiled Binaries

DockerHub images coming soon.

Build from Source

Building Sloop from source needs a working Go environment with version 1.13 or greater installed.

Clone the sloop repository and build using make:

mkdir -p $GOPATH/src/github.com/salesforce
cd $GOPATH/src/github.com/salesforce
git clone https://github.com/salesforce/sloop.git
cd sloop
make
$GOPATH/bin/sloop

When complete, you should have a running Sloop version accessing the current context from your kubeConfig. Just point your browser at http://localhost:8080/

Other makefile targets:

  • docker: Builds a Docker image.
  • cover: Runs unit tests with code coverage.
  • generate: Updates genny templates for typed table classes.
  • protobuf: Generates protobuf code-gen.

Local Docker Run

To run from Docker you need to host mount your kubeconfig:

make docker
docker run --rm -it -p 8080:8080 -v ~/.kube/:/kube/ -e KUBECONFIG=/kube/config sloop

In this mode, data is written to a memory-backed volume and is discarded after each run. To preserve the data, you can host-mount /data with something like -v /data/:/some_path_on_host/

Contributing

Refer to CONTRIBUTING.md
Join our Slack

License

BSD 3-Clause