Skip to content

Commit 1c53974

Browse files
committed
feat: add deploying and configuration docs
1 parent adbfca5 commit 1c53974

File tree

2 files changed

+36
-1
lines changed

2 files changed

+36
-1
lines changed

Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,4 @@ USER workshop-bot:workshop-bot
1717

1818
LABEL org.opencontainers.image.source = "https://github.com/ssps-kb/workshop-bot"
1919

20-
ENTRYPOINT ["/app/ssps-workshop-bot"]
20+
ENTRYPOINT ["/app/ssps-workshop-bot"]

README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,41 @@
22
This repository contains the source code of SSPŠ KB discord bot.
33

44
## Deploying
5+
This project is automatically built and deployed with docker, so you can simply run it with
6+
```shell
7+
docker run ghcr.io/ssps-kb/workshop-bot
8+
```
9+
if the pull and start was successful, you'll get `There is no Config.toml in current directory nor in /etc/workshop-bot`
10+
error. See [configuration](#configuration)
11+
12+
### Tags
13+
Here is a list of tags you can find in the registry, and it's description.
14+
15+
| Tag | Description |
16+
|---------|------------------------------------------------|
17+
| latest | The latest stable (tagged) release |
18+
| x.x.x | The specific version (stable) ie. 0.3.0 |
19+
| edge | Bleeding edge version, contents of main branch |
20+
| sha-xxx | Specific commit. ie. adbfca5 = sha-adbfca5 |
21+
22+
## Configuration
23+
Most of this project's configuration is self-explanatory if you ever set up a discord bot.
24+
The project looks in current directory for `Config.toml` and if there is no configuration it checks `/etc/workshop-bot`.
25+
If running in docker, you'll want to either add a volume to `/app/Config.toml` or even better add a whole folder to
26+
`/etc/workshop-bot`.
27+
28+
Instead of using names, the bot is using IDs to find channels.
29+
30+
### Discord token (discord_token)
31+
This is the only required value, it is used to authenticate with discord. NEVER SHARE IT WITH ANYONE.
32+
To get it create a bot on https://discord.com/developers. If you don't know how to do that, search "How to create a
33+
discord bot", it has been explained over thousand times.
34+
35+
### Workshop invite channel (workshop_invite_channel)
36+
This configuration option is basically useless. It's used to create and log an invite at the bot's startup.
37+
It's only used for the invite to look more professional.
38+
39+
### Guilds config
540
SOON<sup>TM</sup>
641

742
## License

0 commit comments

Comments
 (0)