1 Installation
This add-on must be installed through the Atlassian Universal Plugin Manager (UPM):
- Click on Settings on your Confluence Cloud instance
- Click Find new add-ons from the left-hand side of the page
- Locate Include for Bitbucket Cloud for Confluence via search
- Click free trial
- You're done!
2 Configuration
2.1 Configuration in Bitbucket Cloud
- Go to Bitbucket Settings → OAuth → Add Consumer
Note: admin rights for the selected account are necessary - Name your OAuth consumer, and enter the following URL to the Callback URL: https://ch-mibex-include4bitbucket.herokuapp.com/oauth-callback
Give "Read" permissions for Repositories, Issues, Pull Requests (depends on what macros you will use e.g., if you like to use the macro for showing all open pull requests, you have to add the appropriate permission)
2.2 Configuration in Confluence
1. Go to Confluence Configuration → Include Bitbucket Cloud. You should then see the following page:
2. Add the Bitbucket credentials from above. To do that, click on the Add button. Note: the User/Team name has to be identical with the User/Team ID from Bitbucket Cloud. It is useful to copy/paste the team name from the repository URL.
Example:
3. Finished. You can now include files from Bitbucket into Confluence with the apps' macros.