Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lukepatrick/brigade-gitlab-gateway
Send GitLab events into a Brigade pipeline
https://github.com/lukepatrick/brigade-gitlab-gateway
Last synced: 2 months ago
JSON representation
Send GitLab events into a Brigade pipeline
- Host: GitHub
- URL: https://github.com/lukepatrick/brigade-gitlab-gateway
- Owner: lukepatrick
- License: mit
- Created: 2018-02-15T19:09:08.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-11-18T21:58:48.000Z (about 5 years ago)
- Last Synced: 2024-08-03T10:01:47.882Z (6 months ago)
- Language: Go
- Size: 58.6 KB
- Stars: 16
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-AI-kubernetes - GitLab events
README
# Brigade GitLab Gateway
Send [GitLab events](https://gitlab.com/help/user/project/integrations/webhooks) into a [Brigade](https://github.com/Azure/brigade) pipeline.
This is a Brigade gateway that listens to GitLab webhooks event stream and triggers events inside of Brigade.
## Prerequisites
1. Have a running [Kubernetes](https://kubernetes.io/docs/setup/) environment
2. Setup [Helm](https://github.com/kubernetes/helm)
3. Setup [Brigade](https://github.com/Azure/brigade) core
## Install
### From File
Clone Brigade GitLab Gateway and change directory
```bash
$ git clone https://github.com/lukepatrick/brigade-gitlab-gateway
$ cd brigade-gitlab-gateway
```
Helm install brigade-gitlab-gateway
> note name and namespace can be customized.
```bash
$ helm install --name gl-gw ./charts/brigade-gitlab-gateway
```
### From Repo
Add this project as a helm repo
```bash
$ helm repo add glgw https://lukepatrick.github.io/brigade-gitlab-gateway
$ helm install -n gl-gw glgw/brigade-gitlab-gateway
```
## Building from Source
You must have the Go toolchain, make, and dep installed. For Docker support, you will need to have Docker installed as well.
See more at [Brigade Developers Guide](https://github.com/Azure/brigade/blob/master/docs/topics/developers.md)
From there:
```bash
$ make build
```
To build a Docker image
```bash
$ make docker-build
```
## Compatibility
| GitLab Gateway | Brigade Core |
|----------------|--------------|
| v0.10.0 | v0.10.0 |
| v0.1.0 | v0.9.0 (and previous)|
## GitLab Integration
The Default URL for the GitLab Gateway is at `:7446/events/gitlab/`. In your GitLab project, go to Settings -> Integrations. Depending on how you set up
your Kubernetes and the GitLab Gateway will determine your externally accessable host/IP/Port. Out of the box the gateway sets up as LoadBalancer; use the host/Cluster IP and check the GitLab Gateway Kubernetes Service for the external port (something like 30001).
Enter that IP/Port and URL at the Webhook Integration URL. The Secret Token will be the same string used in the Brigade Project *values.yaml* `sharedSecret` property.
Check the boxes for the Trigger events to publish from the GitLab instance. SSL is optional.
## [Scripting Guide](docs/scripting.md)
tl;dr: GitLab Gateway produces 8 events: `push`, `tag`, `issue`, `comment`, `mergerequest`, `wikipage`, `pipeline`, `build`.
# Contributing
This project welcomes contributions and suggestions.
# License
MIT