@smallcase/cdk8s-botkube v0.0.0
CDK8S BotKube
cdk8s-botkube is an open-source construct library for cdk8s to deploy a configurable instance of BotKube to your Kubernetes cluster. BotKube is a messaging bot for monitoring and debugging Kubernetes clusters.
You provide the configuration for BotKube, our construct library does the rest of the magic.
Installation
Install using NPM:
npm install @smallcase/cdk8s-botkubeUsing yarn
yarn add @smallcase/cdk8s-botkubeConfiguration Helper
| Property | Type | Default | Description |
|---|---|---|---|
| secretName | string | botkube-communication-secret | Your BotKube communication secret name (Read below to see how to define your secret) |
| configMapData | string | ./configmap.yaml | YAML formatted string defining your BotKube monitoring config (Read below to see how to define your config) |
| replicas | number | 1 | Number of pod replicas for deployment |
| nodeSelector | { key: string: string } | {} | Node selectors for the BotKube deployment |
| tolerations | k8s.Toleration[] | [] | Tolerations for the BotKube deployment |
Setting Up Secrets:
Since the communication configuration contains sensitive information like webhook and application tokens we recommend you deploy the configuration as a secret.
Template:
apiVersion: v1
kind: Secret
metadata:
name: botkube-communication-secret
labels:
app: botkube
type: Opaque
stringData:
comm_config.yaml: |
...Fill in the communication secret as per your requirements, have a look at BotKube's official documentation here to get an idea of the syntax.
Setting Up the Resource Config
You can customize alerts from BotKube as per your needs by tweaking its config. You can leave this field empty and a default config will be added, or you can specify a custom YAML config. See resource config syntax here.
Using the construct
Import the library in your CDK8s project and pass the necessary parameters to the construct.
Example:
new BotKube(this, 'botkube-default', {
secretName: 'my-secret-name',
configMapData: 'Foo',
replicas: 2
});2 years ago