Skip to content

guibranco/github-status-action-v2

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace
 
 

Repository files navigation

github-status-action-v2 status github-status-action-v2 status wakatime

GitHub Status Action V2

Adds a status update to a commit. GitHub will always show the latest state of a context.

Warning

Disclaimer This version was created because the original (V1) has not been updated by the creator for a while.

Usage

Inputs

  • authToken (required)
    Use secrets.GITHUB_TOKEN or your own token if you need to trigger other workflows that use "on: status"'
  • state (required)
    The status of the check should only be success, error, failure or pending
  • context
    The context, is displayed as the name of the check
  • description
    Short text explaining the status of the check
  • owner
    The repository owner defaults to context github.repository_owner if omitted
  • repository
    Repository, default to context github.repository if omitted
  • sha
    SHA of commit to update status on, defaults to context github.sha
    If using on: pull_request use github.event.pull_request.head.sha
  • target_url
    Url to use for the details link. If omitted no link is shown.

Outputs

None.

Example

name: "test"
on: # run on any PRs and main branch changes
  pull_request:
  push:
    branches:
      - main

  jobs:
  test: # make sure the action works on a clean machine without building
    runs-on: ubuntu-latest
    steps:
    
    - uses: actions/checkout@v4

    - name: Run the action # You would run your tests before this using the output to set state/desc
      uses: guibranco/github-status-action-v2@latest
      with: 
        authToken: ${{secrets.GITHUB_TOKEN}}
        context: 'Test run'
        description: 'Passed'
        state: 'success'
        sha: ${{github.event.pull_request.head.sha || github.sha}}