Build Status for Confluence allows you to embed a lozenge into a Confluence page showing the current status of a particular build.
Installation
Build Status for Confluence is available to be installed throughout the UPM in the Atlassian Marketplace.
Administrators
Once installed - a new menu option is available in the Confluence Administration area labeled "Build Status Configuration".
Configuring available Bamboo servers
In order for an Atlassian Bamboo Server to be available to be selected - the Application Link (for more information about Application Links - please see https://confluence.atlassian.com/display/APPLINKS/Application+Links+Documentation ) has to be a Trusted Application or have an oAuth authorization set up.
Configuring available Jenkins servers
The configuration screen will ask you for the following pieces of information for each Jenkins server configuration:
- Name
- Base URL
- Username
- Password
Please note the user credentials are stored as plain text in the database.
Displaying build status lozenge in a Confluence page
To embed the lozenge in a page:
From the Macro Browser pick "Build Status" | |
Pick your build server (if you have multiples) then pick your build plan | |
Save and view |
Troubleshooting
Issue | Resolution |
---|---|
I don't see the build servers I expect in the drop down | In order for a Bamboo server to be viewable you need to set up a Trusted application or oAuth relationship in Application Links. This configuration can be implemented at the global Confluence admin level. |
I don't see the build plans I expect in the drop down | For Bamboo, you will only be able to retrieve the build plans that you have access to. Ask your Bamboo build plan administrator to ensure that the Bamboo build plan permissions are set appropriately. |
I can't see the build status lozenge | For Bamboo, you will only be able to see lozenges for the build plans that you have access to view. Ask your Bamboo build plan administrator if you can be granted access to view the status lozenges. |