Butane-Slack-Hubot

This is a Butane template for setting up Hubot for Slack on a Fedora CoreOS VM. It uses a Jinja2 template and some variables to allow you to customize it for your needs. You can render it easily with Bupy. Just customize the butanevars.yaml file and run Bupy to process it.

bupy template slack-hubot.bu.j2 butanevars.yaml --show

Create Classic Slack App

Stolen from this issue: slackapi/hubot-slack#584 (comment)

Setup a Classic App

* Create a classic app from https://api.slack.com/apps?new_classic_app=1

* Go to **Features** > **OAuth & Permissions** > **Scopes**

  * Click "Add an OAuth Scope"
  * Search "bot" and choose it

* Go to **Features** > **App Home**

  * Click "Add Legacy Bot User"
  * Input "Display Name" and "Default username"
  * Click "Add"

* Go to **Settings** > **Install App**

  * Click "Install App to Workspace"
  * Complete the OAuth flow

Customize butanevars.yaml

You will need to customize the butanevars.yaml file with at least the following things:

1. At least add your SSH key to the core user. Add a ssh user for yourself if you want.
2. Set system hostname and domainname.
3. Set updates timezone and what days, start time, and length you want for updates.
4. Enable Blazon for systemd alerting. You will need a Slack webhook URL for this to work.
5. Enable restic backups for /opt/hubot/redis if running Redis locally.
6. Configure Hubot. You will need to use the Slack bot token from the Classic App you just setup. If you want YouTube support you will need to setup a Google Developer Console token You also can set up Hubot to use an external redis instance if you want.
7. If you want to customize the Hubot container, see the container/ directory.

Launch Server

DigitalOcean

https://docs.fedoraproject.org/en-US/fedora-coreos/provisioning-digitalocean/

# Upload custom image
doctl compute image create my-fcos-image --region nyc3 --image-url https://builds.coreos.fedoraproject.org/prod/streams/stable/builds/36.20220806.3.0/x86_64/fedora-coreos-36.20220806.3.0-digitalocean.x86_64.qcow2.gz

# Wait for image creation to finish
while ! doctl compute image list-user | grep my-fcos-image; do sleep 5; done

# Add your SSH key
doctl compute ssh-key create my-key --public-key "$(cat ~/.ssh/id_rsa.pub)"

# Launch the server
DO_IMAGE_ID=$(doctl compute image list-user | grep my-fcos-image | cut -f1 -d ' ')
DO_KEY_ID=$(doctl compute ssh-key list | grep my-key | cut -f1 -d ' ')
doctl compute droplet create my-fcos-droplet --image "${DO_IMAGE_ID}" --region nyc3 --size s-1vcpu-1gb --user-data-file <(bupy template slack-hubot.bu.j2 butanevars.yaml) --ssh-keys "${DO_KEY_ID}" --wait

License

MIT License

Copyright (c) 2022 QuickVM

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.