A GitHub action for registering Events to PipeCD. This action makes it easier to use the Event watcher feature in a GitHub Actions workflow. For Event watcher, see: the documentation.

Required: gRPC address to the PipeCD api server.

Required: API key to which the READ_WRITE role is attached.

Required: The name of Event.

Required: The string value of event data.

Optional: The comma-separated list of labels for the event. Format: key=value,key2=value2

Optional:　Require pipectl >= v0.49.3. The comma-separated list of contexts for the event. Format: key=value,key2=value2

Optional: Require pipectl >= 0.51.0. The commit hash that triggers the event. This is required if you want to use PipeCD Deployment Trace feature.

Optional: Require pipectl >= 0.51.0. The URL of commit that triggers the event. This is required if you want to use PipeCD Deployment Trace feature.

Optional: The title of commit that triggers the event.

Optional: The message of commit that triggers the event.

Optional: The author of commit that triggers the event.

Optional: The timestamp of commit that triggers the event.

Optional: The version of pipectl command. Release versions: https://github.com/pipe-cd/pipecd/releases

At first, you need to create new secrets with the name PIPECD_API_ADDRESS and PIPECD_API_KEY. The value of PIPECD_API_ADDRESS must be in a format like "host:443" because the communication is done via gRPC.

name: "Register an event on PipeCD"
on:
  push:
    branches:
    - main
jobs:
  register-event:
    runs-on: ubuntu-latest
    steps:
    - uses: pipe-cd/actions-event-register@v1
      with:
        api-address: ${{ secrets.PIPECD_API_ADDRESS }}
        api-key: ${{ secrets.PIPECD_API_KEY }}
        event-name: image-update
        labels: app=foo,env=dev
        data: ${{ github.sha }}
        pipectl-version: v0.41.3

name: "Register an event on PipeCD"
on:
  push:
    branches:
    - main
jobs:
  register-event:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
      with:
        fetch-depth: 0
    - run: echo "TAG=`git describe --tags`" >> $GITHUB_ENV
    - uses: pipe-cd/actions-event-register@v1
      with:
        api-address: ${{ secrets.PIPECD_API_ADDRESS }}
        api-key: ${{ secrets.PIPECD_API_KEY }}
        event-name: image-update
        labels: app=foo,env=dev
        data: ${{ env.TAG }}
        pipectl-version: v0.41.3