71 lines
2.3 KiB
Markdown
71 lines
2.3 KiB
Markdown
# Using Webhooks Instead of Polling
|
|
|
|
By default, Fleet utilizes polling (default: 15 seconds) to pull from a Git repo.However, this can be configured to utilize a webhook instead.Fleet currently supports Github,
|
|
GitLab, Bitbucket, Bitbucket Server and Gogs.
|
|
|
|
### 1. Configure the webhook service. Fleet uses a gitjob service to handle webhook requests. Create an ingress that points to the gitjob service.
|
|
|
|
```yaml
|
|
apiVersion: networking.k8s.io/v1
|
|
kind: Ingress
|
|
metadata:
|
|
name: webhook-ingress
|
|
namespace: cattle-fleet-system
|
|
spec:
|
|
rules:
|
|
- host: your.domain.com
|
|
http:
|
|
paths:
|
|
- path: /
|
|
pathType: Prefix
|
|
backend:
|
|
service:
|
|
name: gitjob
|
|
port:
|
|
number: 80
|
|
```
|
|
|
|
:::info
|
|
|
|
You can configure [TLS](https://kubernetes.io/docs/concepts/services-networking/ingress/#tls) on ingress.
|
|
|
|
:::
|
|
|
|
### 2. Go to your webhook provider and configure the webhook callback url. Here is a Github example.
|
|
|
|
|
|
|
|
Configuring a secret is optional. This is used to validate the webhook payload as the payload should not be trusted by default.
|
|
If your webhook server is publicly accessible to the Internet, then it is recommended to configure the secret. If you do configure the
|
|
secret, follow step 3.
|
|
|
|
:::note
|
|
|
|
only application/json is supported due to the limitation of webhook library.
|
|
|
|
:::
|
|
|
|
:::caution
|
|
|
|
If you configured the webhook the polling interval will be automatically adjusted to 1 hour.
|
|
|
|
:::
|
|
|
|
### 3. (Optional) Configure webhook secret. The secret is for validating webhook payload. Make sure to put it in a k8s secret called `gitjob-webhook` in `cattle-fleet-system`.
|
|
|
|
| Provider | K8s Secret Key |
|
|
|-----------------| ---------------------------------|
|
|
| GitHub | `github` |
|
|
| GitLab | `gitlab` |
|
|
| BitBucket | `bitbucket` |
|
|
| BitBucketServer | `bitbucket-server` |
|
|
| Gogs | `gogs` |
|
|
|
|
For example, to create a secret containing a GitHub secret to validate the webhook payload, run:
|
|
|
|
```shell
|
|
kubectl create secret generic gitjob-webhook -n cattle-fleet-system --from-literal=github=webhooksecretvalue
|
|
```
|
|
|
|
### 4. Go to your git provider and test the connection. You should get a HTTP response code.
|