Bitbucket Cloud を Jira Server アプリケーションに接続する

When your Bitbucket Cloud account is connected with Jira Software Server, your team sees their branches, commit messages and pull requests right in the context of the Jira Software issues they're working on. Read more in Integrating with development tools.


Connect a Bitbucket Cloud account with Jira Software Server

To connect your Bitbucket Cloud account with Jira Software Server, you use the DVCS Connector provided in Jira.

You'll need to have admin permissions on both Jira Software Server and on the Bitbucket Cloud account you want to connect. 


Step 1. Create an OAuth access token for your Bitbucket Cloud account

The DVCS Connector requires an OAuth access token, which you create in your Bitbucket Cloud account. You should create the access token in the Bitbucket Cloud account that owns the repositories you want to link. If you are linking repositories for a team, you should generate this token using the team account. 

次のように OAuth トークンを作成します。

  1. From your avatar in the bottom left, click Bitbucket settings.
    If connecting a team, select your team or click View all teams for a full list, then click Settings.
  2. Click OAuth under Access Management.
  3. コンシューマの追加をクリックします。
  4. Enter the following details:
    Name: Enter 'JIRA DVCS' for this example.
    Description: Enter a helpful reminder of the purpose of this token.
    URL: Enter the URL for the Jira Software instance (for example,

  5. 以下のパーミッションを選択します: 
    • アカウント: 書き込み
    • リポジトリ: 管理者 (リポジトリへの書き込み権限はなし)
    • Pull requests: Read


      These are the minimum permissions required by the Jira DVCS connector.
      Selecting additional permissions will have no adverse affects on the integration.
  6. 保存をクリックします。
  7. 消費者の名前をクリックして、OAuth キーシークレットの値を確認します。
  8. DVCS をブラウザで開いたまま、次のステップにいってください。

Step 2. Add the OAuth token in Jira Software Server

After you create a key and secret in Bitbucket Cloud, you go to Jira Software Server and enter the account, the OAuth key, and secret as follows:

  1. Log in to Jira Software Server as a user with admin permissions.
  2. Choose Applications from the cog (settings) icon.
  3. Choose DVCS accounts from the 'Integrations' section on the left.
  4. Click Link Bitbucket Cloud or GitHub account.
  5. Choose 'Bitbucket Cloud' as the Host value.
  6. チーム または ユーザーアカウント名を入力します。

  7. Copy the OAuth Key and Secret values from your Bitbucket Cloud account into the dialog.

  8. Change the auto link and Smart Commits defaults if necessary:

  9. 追加をクリックします。

  10. プロンプトでアクセスを許可します。

The account you just connected and all of its repositories appears in the 'DVCS accounts' page in Jira. The initial synchronization starts automatically.

DVCS Connection notes

The DVCS Connector does not automatically trust the key and secret. It asks you to authorize the connection using an account and password combination. The authorizing account need not be the account you used to create the key and secret, but it should have administrative access on all the repositories you want to link. 

When you link an account using the DVCS Connector, the connector adds a post-commit web hook to all the repositories owned by the account in Bitbucket Cloud. When a commit happens, the web hook passes commit information to the DVCS Connector for processing.

On the Jira Software side, the repositories owned by your Bitbucket Cloud account appear on the 'DVCS accounts' page. A team member may create repositories under their individual Bitbucket Cloud account, but assign the team as the owner. These repositories also appear in the list.

After you link an account, Jira Software automatically starts looking for commits that reference issue keys. The summary shows the synchronization results and errors, if any. A synchronization of commit data from the Bitbucket repository to Jira Software can take some time. As the synchronization progresses, the commits appear in related issues. You can always enable and disable the linking of repositories with Jira Software as needed. 


Jira Software プロジェクトでコミット情報がどのように表示されるかの例

開発者がコミットを作成する場合、 以下のように、Jira Software 課題キーをコミットメッセージに追加する必要があります。

git commit -m "PROJ-123 add a README file to the project."
git push origin <branchname>

Jira Software uses the issue key to associate the commit with an issue, so the commit can be summarized in the Development panel for the Jira Software issue. Read more in Integrating with development tools.


プロジェクトのユーザーは、Jira Software 課題の開発パネルでコミット情報を見るために、「開発ツールを表示」権限を持っている必要があります。Jira Software 管理者はプロジェクトの権限スキームを編集してこの権限を付与することができます。プロジェクト権限の管理」を参照してください。
最終更新日 2017 年 9 月 13 日


Powered by Confluence and Scroll Viewport.