Bitbucket for Aha! Develop

This is an extension for Aha! Develop providing integration with Bitbucket.

It provides these contributions:

• Links attribute - Link Aha! Develop records to Bitbucket branches and pull requests. See the status checks and approvals for the PR.
• Webhook - Automatically links pull requests to records if the PR title starts with the record reference number.
• Automation events - Update the status of linked Aha! Develop records as you work on PRs in Bitbucket.

The Bitbucket extension triggers events that other extensions can use for automation. For example, an extension can listen for the label event:

aha.on({ event: 'aha-develop.bitbucket.pr.update' }, async ({ record, payload }) => {
  record.teamWorkflowStatus = { name: 'In code review' };
  await record.save();
});

Installing the extension

Note: In order to install an extension into your Aha! Develop account, you must be an account administrator.

1. Install the Bitbucket extension by clicking here.

2. Configure a webhook in Bitbucket. The extension will automatically link Aha! records to branches and pull requests in Bitbucket if you include the Aha! reference number (like APP-123) in the name of the branch or pull request. To enable this:

   1. In Aha! Develop, go to Settings -> Account -> Extensions -> Bitbucket Integration -> Webhook from Bitbucket. Copy the hidden URL.
   2. In Bitbucket, go to the repository you want to integrate with Aha! Develop. Visit Repository settings > Webhooks.
   3. Create a new webhook with the following triggers:
      • Repository - Push
      • Pull request - Created
      • Pull request - Updated
      • Pull request - Approved
      • Pull request - Changes Request created
      • Pull request - Merged
      • Pull request - Declined
   4. Set the URL field to the value copied in the first step.

Working on the extension

Install aha-cli:

npm install -g aha-cli

Clone the repo:

git clone https://github.com/aha-develop/bitbucket.git

Install required modules:

yarn install

Note: In order to install an extension into your Aha! Develop account, you must be an account administrator.

Install the extension into Aha! and set up a watcher:

aha extension:install
aha extension:watch

Now, any change you make inside your working copy will automatically take effect in your Aha! account.

Building

When you have finished working on your extension, package it into a .gz file so that others can install it:

aha extension:build

After building, you can upload the .gz file to a publicly accessible URL, such as a GitHub release, so that others can install it using that URL.

To learn more about developing Aha! Develop extensions, including the API reference, the full documentation is located here: Aha! Develop Extension API