An app that helps you monitor your Kubernetes cluster, debug critical deployments & gives recommendations for standard practices
Go to file
2019-01-15 14:14:16 +05:30
build Rename kubeops to botkube 2019-01-03 17:37:20 +05:30
cmd/botkube Rename kubeops to botkube 2019-01-03 17:37:20 +05:30
hack Add verify-gofmt, update-gofmt, verify-golint and verify-govet scripts 2018-12-31 11:09:58 +05:30
helm/botkube Add support for multiple clusters 2019-01-15 14:14:16 +05:30
pkg Add support for multiple clusters 2019-01-15 14:14:16 +05:30
vendor Add vendoring 2018-12-26 13:12:17 +05:30
.travis.yml Rename kubeops to botkube 2019-01-03 17:37:20 +05:30
config.yaml Add support for multiple clusters 2019-01-15 14:14:16 +05:30
Gopkg.lock Add vendoring 2018-12-26 13:12:17 +05:30
Gopkg.toml Fix typo and remove redundant comments 2018-12-31 11:48:13 +05:30
LICENSE Add LICENSE 2019-01-10 15:27:30 +05:30
README.md Rename kubeops to botkube 2019-01-03 17:37:20 +05:30

botkube

Build Status

A slack bot which watches your kubernetes clusters and notifies about resources life cycles, errors, events and provide recommendations about the best practices while creating resources. You can also ask botkube to execute kubectl commands on k8s cluster which helps debugging a application or cluster.

Building

build/docker.sh <docker-repo> <tag>

Creating slack bot

  • Create a bot with name botkube https://my.slack.com/services/new/bot
  • Set icon, name and copy API token (required to configure botkube)
  • Add the bot into a channel by inviting with @botkube in the message area

Configuration

Kubeops reads configurations from config.yaml file placed at CONFIG_PATH e.g https://github.com/infracloudio/botkube/config.yaml

Supported resources for configuration:

  • pods
  • nodes
  • services
  • namespaces
  • replicationcontrollers
  • persistentvolumes
  • persistentvolumeclaims
  • secrets
  • configmaps
  • deployments
  • daemonsets
  • replicasets
  • ingresses
  • jobs
  • roles
  • rolebindings
  • clusterroles
  • clusterrolebindings

Installing on kubernetes cluster

Using helm

git clone https://github.com/infracloudio/botkube.git
  • Update default botkubeconfig in helm/botkube/values.yaml to watch the resources you want.
  • Deploy botkube using helm install in your cluster.
helm install --name botkube --namespace botkube --set botkubeconfig.communications.slack.channel={SLACK_CHANNEL_NAME} --set botkubeconfig.communications.slack.token={SLACK_API_TOKEN_FOR_THE_BOT} helm/botkube/
  • Send @botkube help in the channel to see if botkube is responding.