-
Notifications
You must be signed in to change notification settings - Fork 21
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* created v1.14.0 folder and updated cofig files * version and release notes update * version sidebar update * fixed the review comments * fixed the review comments
- Loading branch information
Showing
101 changed files
with
11,277 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file added
BIN
+29.1 KB
images/images/version-1.4.0/key-features/support-for-private-clusters.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+96.9 KB
images/images/version-1.4.0/monitor/slack-add-incoming-webhook-integration.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+91.8 KB
images/images/version-1.4.0/monitoring-events/bot-user-oauth-token.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+48.8 KB
images/images/version-1.4.0/monitoring-events/botkube-app-in-slack.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+60.9 KB
images/images/version-1.4.0/monitoring-events/copy-app-level-token.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+56.1 KB
images/images/version-1.4.0/monitoring-events/generate-app-level-token.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+82.6 KB
images/images/version-1.4.0/monitoring-events/kubeslice-controller-events.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+83.3 KB
images/images/version-1.4.0/monitoring-events/kubeslice-worker-events.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+138 KB
images/images/version-1.4.0/use-cases/configure-mongodb/add-access-list-entry.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+57.6 KB
images/images/version-1.4.0/use-cases/configure-mongodb/api-access-list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+118 KB
images/images/version-1.4.0/use-cases/configure-mongodb/app-definition.png
Oops, something went wrong.
Binary file added
BIN
+164 KB
images/images/version-1.4.0/use-cases/configure-mongodb/create-api-key.png
Oops, something went wrong.
Binary file added
BIN
+161 KB
images/images/version-1.4.0/use-cases/configure-mongodb/host-mapping.png
Oops, something went wrong.
Binary file added
BIN
+111 KB
images/images/version-1.4.0/use-cases/configure-mongodb/ops-access-manager.png
Oops, something went wrong.
Binary file added
BIN
+189 KB
images/images/version-1.4.0/use-cases/configure-mongodb/ops-deployment.png
Oops, something went wrong.
Binary file added
BIN
+160 KB
images/images/version-1.4.0/use-cases/configure-mongodb/ops-manager-db.png
Oops, something went wrong.
Binary file added
BIN
+78.2 KB
images/images/version-1.4.0/use-cases/configure-mongodb/ops-manager-ui.png
Oops, something went wrong.
Binary file added
BIN
+69 KB
images/images/version-1.4.0/use-cases/configure-mongodb/ops-organizations.png
Oops, something went wrong.
Binary file added
BIN
+86.9 KB
images/images/version-1.4.0/use-cases/configure-mongodb/organization-settings.png
Oops, something went wrong.
Oops, something went wrong.
Binary file added
BIN
+228 KB
images/images/version-1.4.0/use-cases/configure-mongodb/replicaset-deployment.png
Oops, something went wrong.
Binary file added
BIN
+55.3 KB
...mages/version-1.4.0/use-cases/configure-mongodb/replicaset-outside-clusters.png
Oops, something went wrong.
Binary file added
BIN
+69.9 KB
...images/version-1.4.0/use-cases/configure-mongodb/replicaset-within-clusters.png
Oops, something went wrong.
Binary file added
BIN
+141 KB
images/images/version-1.4.0/use-cases/configure-mongodb/save-api-key-info.png
Oops, something went wrong.
Binary file added
BIN
+118 KB
images/images/version1.3.0/use-cases/configure-mongodb/app-definition.png
Oops, something went wrong.
210 changes: 210 additions & 0 deletions
210
versioned_docs/version-1.4.0/add-ons/add-ons-slack-events.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,210 @@ | ||
# Slack Event Monitoring | ||
In this topic, you discover the step-by-step process of creating a vibrant Slack app | ||
and seamlessly integrating both kube-state-metrics (KSM) events and KubeSlice events into | ||
a dynamic Slack channel. Unleash the power of real-time updates and vibrant notifications, | ||
making your Slack workspace a hub of insightful information. Let's dive in and explore | ||
this exciting integration journey! | ||
|
||
## Create an App | ||
|
||
Create an app using the Slack API in your workspace. | ||
|
||
To create an app: | ||
|
||
1. Open the [Slack API](https://api.slack.com/apps) console. | ||
|
||
2. Click the **Create an App** button. | ||
|
||
 | ||
|
||
3. Select **From an app manifest** to configure your app scopes and settings. | ||
|
||
 | ||
|
||
4. Select a workspace where you want to create an app and click **Next**. | ||
|
||
 | ||
|
||
5. In the **Enter app manifest below** section, click on the **YAML** tab and enter the following manifest: | ||
|
||
```yaml | ||
display_information: | ||
name: Botkube | ||
description: Botkube | ||
background_color: "#a653a6" | ||
features: | ||
bot_user: | ||
display_name: Botkube | ||
always_online: false | ||
oauth_config: | ||
scopes: | ||
bot: | ||
- channels:read | ||
- app_mentions:read | ||
- chat:write | ||
- files:write | ||
- users:read # Remote configuration only: Used to get Real Name for audit reporting | ||
settings: | ||
event_subscriptions: | ||
bot_events: | ||
- app_mention | ||
interactivity: | ||
is_enabled: true | ||
org_deploy_enabled: false | ||
socket_mode_enabled: true | ||
token_rotation_enabled: false | ||
``` | ||
6. Click **Next**. | ||
7. In the **Review summary & create your app** section, review the details and click **Create**. | ||
 | ||
## Install an App | ||
Once you have successfully created your app, you will be directed to an application details page that provides you with the option to install the app in your desired workspace. | ||
To install an app to your workspace: | ||
1. Go to **Settings** > **Basic Information** on the left sidebar. | ||
2. In the **Building Apps for Slack** section, under **Install your app**, click the **Install to workspace** button. | ||
3. Click **Allow** to finish the installation. | ||
## Get an OAuth Token | ||
During the configuration process of botkube in Slack, it is essential to provide the OAuth token for authentication purposes. This token serves as a secure credential that verifies the identity of the botkube integration and enables seamless communication between Slack and botkube. | ||
To get an oauth token for your workspace: | ||
1. Go to **Features** > **OAuth & Permissions** on the left sidebar. | ||
2. Copy the **Bot User OAuth Token** and save the token for later use while deploying the | ||
**kubeslice-botkube** bundle on the controller and worker clusters. | ||
 | ||
## Get an App-Level Token | ||
To establish a web socket connection with Slack App using Socket Mode, you need an | ||
App-Level token. This token is specifically required to facilitate the communication and interaction between your Slack App and the web socket, ensuring a smooth and uninterrupted connection. | ||
To get an app-level token: | ||
1. Go to **Settings** > **Basic Information** on the left sidebar. | ||
2. Click the **Generate Token and Scopes** button. | ||
 | ||
3. In the **Generate an app-level token** section, enter a token name. For example, `botkube` is a token name. | ||
|
||
 | ||
|
||
4. Click **Add Scope** and select **connections:write scope**. | ||
|
||
5. Click **Generate**. | ||
|
||
6. Review the details and click **Done**. Copy the app-level token for later use while deploying the | ||
**kubeslice-botkube** bundle on the controller and worker clusters. | ||
|
||
## Create Slack Channel for Events | ||
|
||
Once you have successfully installed the Botkube application, you will notice a new bot user named `botkube` added to your workspace. | ||
|
||
Next, proceed to create **two channels** within your workspace to receive KSM and KubeSlice events. Save the channel names for later use. | ||
|
||
 | ||
|
||
To receive notifications in a specific Slack channel, you need to add the Botkube bot. This can be done by inviting the **@Botkube** user to the desired channel. | ||
|
||
 | ||
|
||
|
||
|
||
## Deploy the kubeslice-botkube Bundle | ||
|
||
To deploy the **kubeslice-botkube** bundle: | ||
|
||
1. Switch the context to controller cluster. | ||
|
||
``` | ||
kubectx <cluster_name> | ||
``` | ||
2. Add the **kubeslice-botkube** repo using the following command: | ||
``` | ||
helm repo add kubeslice/botkube | ||
``` | ||
3. Use the following command to create the `botkube` namespace on the controller and worker clusters. | ||
``` | ||
kubectl create ns botkube | ||
``` | ||
4. Use the following command to deploy the **kubeslice-botkube** bundle on the **controller cluster**: | ||
:::note | ||
Replace the `ksm_channel_name`, `kubeslice_event_channel_name`, `cluster_name`, `app_token`, and `bot_token` in the command below with your values. | ||
::: | ||
``` | ||
helm install kubeslice-botkube kubeslice/botkube --set "sources.k8s-controller-events.botkube/kubernetes.enabled=true" --namespace botkube \ | ||
--set communications.default-group.socketSlack.enabled=true \ | ||
--set communications.default-group.socketSlack.channels.default.name=<ksm_channel_name> \ | ||
--set communications.default-group.socketSlack.channels.kubeslice.name=<kubeslice_event_channel_name> \ | ||
--set communications.default-group.socketSlack.appToken=<app_token> \ | ||
--set communications.default-group.socketSlack.botToken=<bot_token> \ | ||
--set settings.clusterName=<cluster_name> \ | ||
--set 'executors.k8s-default-tools.botkube/kubectl.enabled'=true \ | ||
--set 'executors.k8s-default-tools.botkube/helm.enabled'=true | ||
``` | ||
5. Switch the context to worker cluster(s). | ||
``` | ||
kubectx <cluster_name> | ||
``` | ||
6. Use the following command to deploy the **kubeslice-botkube** bundle on each of the **worker cluster(s)**: | ||
:::note | ||
Replace the `ksm_channel_name`, `kubeslice_event_channel_name`, `cluster_name`, `app_token`, and `bot_token` in the command below with your values. | ||
::: | ||
``` | ||
helm install kubeslice-botkube kubeslice/botkube --set "sources.k8s-worker-events.botkube/kubernetes.enabled=true" --namespace botkube \ | ||
--set communications.default-group.socketSlack.enabled=true \ | ||
--set communications.default-group.socketSlack.channels.default.name=<ksm_channel_name> \ | ||
--set communications.default-group.socketSlack.channels.kubeslice.name=<kubeslice_event_channel_name> \ | ||
--set communications.default-group.socketSlack.appToken=<app_token> \ | ||
--set communications.default-group.socketSlack.botToken=<bot_token> \ | ||
--set settings.clusterName=<cluster_name> \ | ||
--set 'executors.k8s-default-tools.botkube/kubectl.enabled'=true \ | ||
--set 'executors.k8s-default-tools.botkube/helm.enabled'=true | ||
``` | ||
### Slack KSM Events | ||
After deploying the charts in the workspace, you will start receiving notifications. The KSM events received in the Slack channel are depicted in the figures below: | ||
 | ||
### Slack KubeSlice Events | ||
#### Controller Events | ||
The Slack channel displays the KubeSlice events for the controller cluster, as depicted in the following figure. | ||
 | ||
#### Worker Events | ||
The Slack channel displays the KubeSlice events for the worker cluster, as depicted in the following figure. | ||
 |
Oops, something went wrong.