Skip to content

Commit

Permalink
chore(docs): update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
timhooker committed Aug 3, 2022
1 parent e0ebaf0 commit ac8ddd3
Showing 1 changed file with 11 additions and 4 deletions.
15 changes: 11 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,36 +4,43 @@ Github Action for build notifications

### Parameters:

Required Parameters:
- **slackbot_secret:** - Slackbot app secret - This is a org level github secret `PICO_THE_BUILDER_SLACKBOT_SECRET`. Ask platform if it's not in your repo

- **slackbot_token:** - slackbot app oath token - This is a org level github secret `PICO_THE_BUILDER_SLACKBOT_TOKEN`. Ask platform if it's not in your repo

- **slackbot_channel:** - Slack channel for the notification to be posted to. You can find this at the bottom of the "About" section of the slack channel. Example Channel ID: `C0198QJ6FP0`
- **github_token:** - The github actor token

- **title:** - The title of your notification

Optional Parameters
- **app_name:** - The name of the app being built. Acceptable values are ["services", "music_stand", "church_center_app", "check_ins", "headcounts", "people"]

- **build_number:** - The Build number of the application being built

- **build_version:** - The Version number of the application being built

- **build_type:** - The type of build - Acceptable values are ["playstore", "appstore", "firebase", "test", "ios", "android"]
- **build_type:** - The type of build

- **notes:** - Additional optional notes

- **status:** - The status of the build - default: 'working' - acceptable values: ["success", "failure", "working", "cancelled"]
- **github_token:** - The github actor token
- **ts:** - ID of slack thread 'The slack thread' - this app will populate this value and you don't need to provide it as long as you pass a `config`

- **config:** - As a way to pass values from one notify step to another, we use a config value as the output of a previous step. This config passes all the input values above that are sent and you can override any value in the config by passing it in as an input to a future step. Example: `config: ${{ steps.notify.outputs.config }}`

- **include_secrets:** - If you wish to use the config to pass from one job to another, the repository secrets included in the returned config from this action will cause github to skip returning it. To avoid this, you can set include_secrets to false and they won't be returned.

### Example Github Action Workflow Usage:

- name: notify
id: notify
uses: planningcenter/[email protected]
with:
title: ":google_play: Playstore build #${{ github.run_number }}"
build_number: ${{ steps.build_step.outputs.build_number }}
build_version: ${{ steps.version_step.outputs.version }}
build_type: 'appstore'
build_type: 'Appstore'
status: 'working'
github_token: ${{ secrets.MY_REPO_PAT }}
slackbot_secret: ${{ secrets.PICO_THE_BUILDER_SLACKBOT_SECRET }}
Expand Down

0 comments on commit ac8ddd3

Please sign in to comment.