Skip to main content
Version: Unreleased 🚧

Cloud Slack App

The Botkube Cloud Slack App uses Botkube Cloud services to manage channels and route executor commands. This allows multi-cluster support without a need to create a dedicated Slack application for each cluster. Events and alerts are sent directly from your cluster to your Slack workspace for reliable, fast notifications.

Prerequisites​

  • A Botkube Cloud account with active subscription.

    You can try out the Botkube Cloud Slack App for free by creating an account in the Botkube Cloud app and starting a free trial.

note

Once you downgrade your subscription to free, you will not be able to execute Botkube commands. However, you will still receive notifications from your clusters.

Create a Botkube Cloud Instance with Cloud Slack​

  1. Go to Botkube Cloud Web App and click on New Instance button.

    New Instance

  2. Fill in the Instance Display Name and click Next button.

    Instance Display Name

  3. Click Add platform dropdown, and select Slack option.

    Slack Platform Select

  4. In the popup, select Official Botkube Slack App option and click Select button.

    Official Slack App

  5. Click Add to Slack button to add Cloud Slack integration to your Slack workspace.

    Add to Slack

  6. Click Allow to grant permission for Botkube Cloud Slack app to access your Slack workspace.

    Cloud Slack Grant

  7. Provide the Slack app details as described follows and click Next button.

    • Connected Slack Workspace: Slack workspace that you granted permission in previous step.
    • Display Name: Display name of the Cloud Slack integration.
    • Channel: Slack channel where you can execute Botkube commands and receive notification.

    Cloud Slack Workspace

  8. Add plugins you want to enable in your Botkube instance and click Next button.

    Cloud Slack Plugins

  9. Include optional default aliases and default actions and click Create button to create Botkube Cloud instance.

Cloud Slack Create

  1. Follow the instructions in the summary page to deploy Botkube into your environment.

Cloud Slack Summary

Using Botkube Cloud Slack App​

You can start using Botkube Cloud Slack App by typing @Botkube cloud help in the Slack channel you configured in one of the previous steps.

Cloud Slack Command Help

Listing Cloud Instances​

You can list all the Botkube Cloud instances by typing @Botkube cloud list instances in the Slack channel or click the button List connected instances in the help command response. Besides the instance name, ID, and status in the list response, you can also click the Get details button to go to instance details on Botkube Cloud Dashboard.

Cloud Slack List Instances

Setting Default Cloud Instances​

Once a Botkube command is executed, it will be handled on target Kubernetes cluster specified with --cluster-name flag. However, this is an optional flag, where if you have not specified it, Botkube Cloud will select the first instance. However, you can also achieve setting default instance with command @Botkube cloud set default-instance {instance-id}.

Cloud Slack Set Default Instances

After this point, all of your commands will be executed on the default instance. Moreover, if you want to execute a command on all the target clusters, you can use --all-clusters flag.

Cloud Slack All Clusters

Clean up​

  1. Go to Botkube Cloud instances page and click Manage button of the instance you want to remove.

    Cloud Slack Instance Manage

  2. Click Delete instance button, type instance name in the popup and click Delete instance.

    caution

    Remember to execute the displayed command to completely remove Botkube and related resources from your cluster.

    Cloud Slack Instance Delete