Configuring event watcher

This page describes how to configure piped to enable event watcher.

To enable EventWatcher, you have to configure your piped at first.

Grant write permission

The SSH key used by Piped must be a key with write-access because piped needs to commit and push to your git repository when any incoming event matches.

Specify Git repositories to be observed

Piped watches events only for the Git repositories specified in the gitRepos list. You need to add all repositories you want to enable Eventwatcher.

apiVersion: pipecd.dev/v1beta1
kind: Piped
spec:
  eventWatcher:
    gitRepos:
      - repoId: repo-1
      - repoId: repo-2
      - repoId: repo-3

[optional] Specify Eventwatcher files Piped will use

NOTE: This way is valid only for defining events using .pipe/.

If multiple Pipeds handle a single repository, you can prevent conflicts by splitting into the multiple EventWatcher files and setting includes/excludes to specify the files that should be monitored by this Piped.

Say for instance, if you only want the Piped to use the Eventwatcher files under .pipe/dev/:

apiVersion: pipecd.dev/v1beta1
kind: Piped
spec:
  eventWatcher:
    gitRepos:
      - repoId: repo-1
        commitMessage: Update values by Event watcher
        includes:
          - dev/*.yaml

excludes is prioritized if both includes and excludes are given.

The full list of configurable fields are here.

[optional] Settings for git user

By default, every git commit uses piped as a username and pipecd.dev@gmail.com as an email. You can change it with the git field.

apiVersion: pipecd.dev/v1beta1
kind: Piped
spec:
  git:
    username: foo
    email: foo@example.com

Last modified September 24, 2024: Generate v0.49.x docs (#5222) (909fd76a)