Bitbucket

You can import tasks from your Bitbucket instance using the bitbucket service name.

Example Service

Here’s an example of a Bitbucket target:

toml

[my_issue_tracker]
service = "bitbucket"
username = "ralphbean"
key = "mykey"
secret = "mysecret"

ini

[my_issue_tracker]
service = bitbucket
bitbucket.username = ralphbean
bitbucket.key = mykey
bitbucket.secret = mysecret

The above example is the minimum required to import issues from Bitbucket. You can also feel free to use any of the configuration options described in Common Service Configuration Options.

To get a key and secret, go to the “OAuth” section of your profile settings and click “Add consumer”. Set the “Callback URL” to https://localhost/ and set the appropriate permissions. Then assign your consumer’s credentials to key and secret.

Service Features

Include and Exclude Certain Repositories

If you happen to be working with a large number of projects, you may want to pull issues from only a subset of your repositories. To do that, you can use the include_repos option.

For example, if you would like to only pull-in issues from your project_foo and project_fox repositories, you could add this line to your service configuration:

toml

include_repos = ["project_foo", "project_fox"]

ini

bitbucket.include_repos = project_foo,project_fox

Alternatively, if you have a particularly noisy repository, you can instead choose to import all issues excepting it using the exclude_repos configuration option.

In this example, noisy_repository is the repository you would not like issues created for:

toml

exclude_repos = ["noisy_repository"]

ini

bitbucket.exclude_repos = noisy_repository

Please note that the API returns all lowercase names regardless of the case of the repository in the web interface.

Include Merge Requests

Merge requests are included by default. You can exclude them by disabling this feature:

toml

include_merge_requests = "False"

ini

bitbucket.include_merge_requests = False

Project Owner Prefix

To include the project owner in the project name:

toml

project_owner_prefix = true

ini

bitbucket.project_owner_prefix = True

Provided UDA Fields

Field Name	Description	Type
bitbucketid	Bitbucket Issue ID	Number (numeric)
bitbuckettitle	Bitbucket Title	Text (string)
bitbucketurl	Bitbucket URL	Text (string)