BotKube

For complete documentation visit www.botkube.io

A slack bot which keeps eye on your kubernetes resources and notifies about resources life cycles events, errors and warnings. It allows you to define and run certain checks on resouces specs. You can also ask BotKube to execute kubectl commands on k8s cluster which helps debugging an application or cluster.

Getting started

Install BotKube app to your slack workspace

Click the "Add to Slack" button provided to install BotKube slack application to your workspace. Once you authorized the application, you will be provided a BOT Access token. Kindly note down that token which will be required while deploying BotKube controller to your cluster

Add BotKube to a slack channel

After installing BotKube app to your slack workspace, you could see new bot user with name 'BotKube' create in your workspace. Add that bot to a slack channel you want to receive notification in. (You can add it by inviting using @BotKube message in a required channel)

Installing BotKube controller to your kubernetes cluster

Using helm

We will be using helm to install our k8s controller. Follow this guide to install helm if you don't have it installed already
Clone the BotKube github repository.

$ git clone https://github.com/infracloudio/botkube.git

Update default config in helm/botkube/values.yaml to watch the resources you want. (by default you will receive create, delete and error events for all the resources in all the namespaces.) If you are not interested in events about particular resource, just remove it's entry from the config file.
Deploy BotKube controller using helm install in your cluster.

$ helm install --name botkube --namespace botkube --set config.communications.slack.channel={SLACK_CHANNEL_NAME},config.communications.slack.token={SLACK_API_TOKEN_FOR_THE_BOT},config.settings.clustername={CLUSTER_NAME},config.settings.allowkubectl={ALLOW_KUBECTL} helm/botkube/

where,
SLACK_CHANNEL_NAME is the channel name where @BotKube is added
SLACK_API_TOKEN_FOR_THE_BOT is the Token you received after installing BotKube app to your slack workspace
CLUSTER_NAME is the cluster name set in the incoming messages
ALLOW_KUBECTL set true to allow kubectl command execution by BotKube on the cluster

Configuration syntax is explained here

Send @BotKube ping in the channel to see if BotKube is running and responding.

Using kubectl

Make sure that you have kubectl cli installed and have access to kubernetes cluster
Download deployment specs yaml

$ wget -q https://raw.githubusercontent.com/infracloudio/botkube/master/deploy-all-in-one.yaml

Open downloaded deploy-all-in-one.yaml and update the configuration. Set SLACK_CHANNEL, SLACK_API_TOKEN, clustername, allowkubectl and update the resource events configuration you want to receive notifications for in the configmap.

where,
SLACK_CHANNEL is the channel name where @BotKube is added
SLACK_API_TOKEN is the Token you received after installing BotKube app to your slack workspace
clustername is the cluster name set in the incoming messages
allowkubectl set true to allow kubectl command execution by BotKube on the cluster

Configuration syntax is explained here
Create botkube namespace and deploy resources

$ kubectl create ns botkube && kubectl create -f deploy-all-in-one.yaml -n botkube

Check pod status in botkube namespace. Once running, send @BotKube ping in the slack channel to confirm if BotKube is responding correctly.

Follow this for complete BotKube installation guide.

Visit www.botkube.io for Configuration, Usage and Examples.

4.5 KiB Raw Blame History