FASD Bot

This is our Telegram bot, created with the goal of providing utilities and fun to the group.

Get Started

The bot runs on Docker.

Build the Docker image from the root of this repository:

$ docker build -t fasdbot:local .

💡 You can label it however you want for local development. If you change the label, make sure to reuse it in all other Docker commands.

Env vars

A set of environment variables are needed to run the bot. Copy .env-example into .env and fill in the values to your needs.

• TELEGRAM_TOKEN - Is the minimum required to run the bot. You can get an API Token from The BotFather.
• STICKER_COLLECTION_NAME - Neeeded only to manage a given sticker collection.
• STICKER_COLLECTION_OWNER_ID - Neeeded only to manage a given sticker collection.

Once you have your .env file properly set up, you can feed it to container when running it:

docker run -it --env-file=.env fasdbot:local

Your local bot should be up and running! You should be able message it directly on Telegram. To check if it's running properly, send it this message:

-fasd- healthcheck

Deployment

Docker image

Pushes to master automatically triggers a GitHub Action that will build the docker image and push it as fasdclub/telegram-bot:latest to Docker Hub.

Images are not currently versioned (they're all tagged as :latest) as there's not many changes in the bot currently. If the need ever comes, we shuold start using git tags to version-tag the builds automatically.

Running the container in Kubernetes@Okteto

Integration with Okteto is set via okteto-pipeline.yml and deploys should be automated from git pushes.