As part of our gradual migration to GitHub Apps for our GitHub integration, we’re formally deprecating GitHub Commit Status API updates for repositories on travis-ci.com managed by GitHub Apps. Instead, these repositories will have status updates reported to the GitHub Check Runs API. We will no longer deliver GitHub Commit Status API updates for repositories managed by GitHub Apps starting October 4th, 2018.
If your workflow doesn’t fall into either case, the change will have minimal impact – except the deprecated (duplicate) GitHub Status API updates will disappear from your pull requests. If you do use protected branches or the GitHub Commit Status API, we have some recommendations for updating.
Protected Branches are a feature in GitHub which let you block merging pull requests into specific branches unless status checks have passed.
If you’re a repository owner, you can update your repositories using protected branches to use status checks per the following:
- Go to the repository’s
Settingspage, and select
- In the
Branch Protection Settingssection, click
Editfor a protected branch
- Scroll down to the second box –
Require status checks to pass before merging. Select either
Travis CI - Pull Requestor
Travis CI - Branchor both. (Note:
continuous-integration/travis-ciis the Status API event which will be deprecated)
- Save your changes! Rinse and repeat for each protected branch.
Using the GitHub Commit Status API
Since we will no longer be using the GitHub Commit Status API, automations you’ve built or are using – including third party integrations – that rely on this GitHub endpoint may no longer work properly without the status API updates.
If you’re managing your integration with GitHub, we recommend switching to using the GitHub Check Runs API. For example, instead of retrieving a Commit Status via a
/repos/:owner/:repo/commits/:ref/statuses , we suggest you use the following endpoint:
Read the GitHub Check Runs API docs for more information about the payload you can expect.
We hope these recommendations are helpful! If you have a strict requirement on the GitHub Commit Status API that we didn’t cover here, please email [email protected] soon so we can help support through the deprecation process.
Of course, if you have any other questions about these changes or there’s anything we can do to help, let us know on the forum, travis-ci.community or send us an email as well. Thanks a bunch!