https://github.com/flexoid/mergentle-reminder
Bot that periodically checks configured GitLab projects and groups for opened merge requests, then sends a summary list of merge requests to review to the configured Slack channel.
https://github.com/flexoid/mergentle-reminder
gitlab reminder-bot slack
Last synced: 13 days ago
JSON representation
Bot that periodically checks configured GitLab projects and groups for opened merge requests, then sends a summary list of merge requests to review to the configured Slack channel.
- Host: GitHub
- URL: https://github.com/flexoid/mergentle-reminder
- Owner: flexoid
- License: apache-2.0
- Created: 2023-03-31T17:39:00.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-06T19:25:08.000Z (3 months ago)
- Last Synced: 2025-03-31T03:07:20.580Z (about 1 month ago)
- Topics: gitlab, reminder-bot, slack
- Language: Go
- Homepage:
- Size: 344 KB
- Stars: 16
- Watchers: 3
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mergentle Reminder
Mergentle Reminder is a Slack bot that periodically checks configured GitLab projects and groups for opened merge requests, then sends a summary list of merge requests to review to the configured Slack channel.
The name "Mergentle Reminder" is a playful combination of the words "merge" and "gentle." The name emphasizes the purpose of the project, which is to gently remind the team to review open merge requests.
## Features
- Sends a summary list of merge requests to a Slack channel.
- Supports GitLab projects and groups.
- Filters out draft merge requests.
- Retrieves approvers and additional merge request information.
- Configurable with a YAML file or environment variables.
## Screenshot
## Configuration
You can configure the Mergentle Reminder bot using a `config.yaml` file or by setting the environment variables.
Example config can be found in `config.yaml.example`.
In addition to the config.yaml file, the following environment variables can be set:
- `GITLAB_URL`: The URL of your GitLab instance (defaults to https://gitlab.com).
- `GITLAB_TOKEN`: Your GitLab personal access token.
- `SLACK_WEBHOOK_URL`: The webhook URL for the Slack channel where the bot will send messages.
- `PROJECTS`: A comma-separated list of GitLab project IDs to check for merge requests.
- `GROUPS`: A comma-separated list of GitLab group IDs to check for merge requests.
- `CONFIG_PATH` (optional): The path to the config.yaml configuration file. Defaults to config.yaml.
Environment variables take precedence over the config.yaml file.
## Building and Running the Application
### Locally
Build the application:
```sh
go build
```
Run the application:
```sh
GITLAB_TOKEN= SLACK_WEBHOOK_URL= ./mergentle-reminder
```
### Using Docker
Build the Docker image:
```sh
docker build -t your-dockerhub-username/mergentle-reminder:latest .
```
Run the Docker container:
```sh
docker run -e GITLAB_TOKEN= -e SLACK_WEBHOOK_URL= -v $(pwd)/config.yaml:/config/config.yaml your-dockerhub-username/mergentle-reminder:latest
```
### Deploying to Kubernetes
Create a configmap for the config.yaml file:
```sh
kubectl -n mergentle-reminder create configmap mergentle-reminder-config --from-file=config.yaml
```
Create a secret for the GitLab API token and Slack webhook URL:
```sh
kubectl -n mergentle-reminder create secret generic mergentle-reminder-secrets --from-literal=gitlab-token= --from-literal=slack-webhook-url=
```
Edit `schedule` in `k8s/cronjob.yaml` to specify the desired schedule. Set to run every hour by default.
See the [CronJob documentation](https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/) for more information.
Apply the Kubernetes manifests:
```sh
kubectl apply -f k8s/
```
The application will now run as a CronJob in your Kubernetes cluster, periodically sending reminders to the configured Slack channel.
It is possible to create a new job manually for testing purposes:
```sh
kubectl -n mergentle-reminder create job --from=cronjob/mergentle-reminder test-job
kubectl -n mergentle-reminder delete jobs/test-job
```