You can import tasks from your Bitbucket instance using
bitbucket service name.
Here’s an example of a Bitbucket target:
[my_issue_tracker] service = bitbucket bitbucket.username = ralphbean bitbucket.key = mykey bitbucket.secret = mysecret
[my_issue_tracker] service = "bitbucket" username = "ralphbean" key = "mykey" 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
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
For example, if you would like to only pull-in issues from
project_fox repositories, you could add
this line to your service configuration:
bitbucket.include_repos = project_foo,project_fox
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:
bitbucket.exclude_repos = noisy_repository
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:
bitbucket.include_merge_requests = False
include_merge_requests = false
Project Owner Prefix¶
To include the project owner in the project name:
bitbucket.project_owner_prefix = True
project_owner_prefix = true
Provided UDA Fields¶
Bitbucket Issue ID