This action allows you to post GitHub build notifications to Keybase Chat channels, teams, and DMs. It sends messages via the opensentinel API, using your token value.

1. Using the Action
2. Parameters
3. What about other GitHub events?
4. Filtering Notifications
5. Versioning
6. How to get help
7. License

NOTE: The marvinpinto/action-keybase-notifications repository is an automatically generated mirror of the marvinpinto/actions monorepo containing this and other actions. Please file issues and pull requests over there.

You will need an opensentinel automation API token in order to use this action. Create an account and go through the Keybase setup information. This action utilizes a Generic Webhook token.

For reference, opensentinel automation wbhook URLs for Keybase look something like:

https://automations.opensentinel.com/webhook?token=<OSL_TOKEN>

name: "CI Tests"

on:
  push:

jobs:
  ci:
    runs-on: "ubuntu-latest"
    steps:
      # ...
      - name: "Build & test"
        run: |
          echo "done!"

      # Add the notification step as the last one
      - uses: "marvinpinto/action-keybase-notifications@latest"
        if: always()
        with:
          job_status: ${{ job.status }}
          opensentinel_token: ${{ secrets.OSL_TOKEN }}
          on_success: "never"
          on_failure: "always"

This will send you a Keybase chat notification whenever a CI build fails but not when it passes (if you wanted to reduce channel noise). The if: always() stanza above ensures that the notification step runs no matter what.

on:
  push:
    tags:
      - "v*"

jobs:
  ci:
    runs-on: "ubuntu-latest"
    steps:
      # ...
      - name: "Build & test"
        run: |
          echo "done!"

      - name: "Deploy to production"
        run: |
          echo "+1"

      - uses: "marvinpinto/action-keybase-notifications@latest"
        if: always()
        with:
          job_status: ${{ job.status }}
          job_name: "Production Release"
          opensentinel_token: ${{ secrets.OSL_TOKEN }}

This will send you a notification message to let you know if the production release was successful or not.

• Parameters denoted with ** are required.

The opensentinel system itself handles other GitHub events directly. This action is primarily geared toward sending build + other ad-hoc messages.

This action will do its hardest to NOT fail the build as a result of a processing error (network/permissions/etc).

If you're still interested in receiving Keybase notifications for other GitHub events (push, pull_request, etc), set up a GitHub Notification webhook with opensentinel and add that to your repository.

You can cut down on chat noise by applying filters to events that trigger this action. For example, you can send a Keybase build notification only when someone pushes to the master branch.

on:
  push:
    branches:
      - master

Read through the GitHub documentation for advanced examples.

Every commit that lands on master for this project triggers an automatic build as well as a tagged release called latest. If you don't wish to live on the bleeding edge you may use a stable release instead. See releases for the available versions.

- uses: "marvinpinto/action-keybase-notifications@<VERSION>"

The main README for this project has a bunch of information related to debugging & submitting issues. opensentinel help is available through a few support channels and if you're still stuck, try and get a hold of me on keybase and I will do my best to help you out.

The source code for this project is released under the MIT License. This project is not associated with Keybase or GitHub.