How to Display Jenkins Build Status Badge on GitHub

Boban Miksin Date 22-Oct-2020 2 minutes to read
How To Display Jenkins Build Status Badge On Github

Table of contents

    What is Embeddable Build Status Plugin?

    This plugin allows Jenkins to expose what is the current state of your last build or a specific build as an image icon (badge) via fixed URL.

    Note: This is applicable to Jenkins 2.222.1 and Embeddable Build Status Plugin 2.0.3. Perhaps it works for previous versions as well.

    5 steps for displaying Jenkins build status badge on GitHub

    1. Open Jenkins -> Manage Jenkins -> Manage Plugins
    2. Install Embeddable Build Status Plugin from the Available tab
    3. On the project level or the entire Jenkins level, assign Anonymous Users with the ViewStatus Job permission
    4. From the specific build page or branch build page on Jenkins click on the Embeddable Build Status link and copy the value from the Markdown unprotected box
    5. Paste it in the README.md on a GitHub project
    how_to_display_jenkins_build_status_badge_on_github.png

    Embeddable Build Status link

    how_to_display_jenkins_build_status_badge_on_github_2.png

    Pasting README.md on a GitHub project

    Note that the link from the markdown can be omitted, so only the badge image gets displayed.

    As the final result, you should see the following.

    how_to_display_jenkins_build_status_badge_on_github_3.png

    Your display jenkins build status badge is now on GitHub

    Troubleshooting with Display Jenkins Build Status Badge on GitHub - The image is broken or not shown

    GitHub is doing an image link anonymization, which means images are being prefetched, cached, and not served directly from Jenkins. As GitHub performs a strict SSL verification, it will fail if the certificate is invalid or your Jenkins JKS does not contain a full certificate chain. In that case, you have to recreate it.

    After you fix the certificate issue, make sure to purge Camo’s cache. A Camo link can be obtained from the README.md preview mode or by simply inspecting the HTML from the browser.

    boban-miks-in_authorsphoto.png
    Boban Miksin CTO

    Boban is a craftsman with more than ten years of dedicated service to the development and management of new software.