Bitbucket Cloud アカウントのリンク
Bitbucket Cloud アカウントとそのリポジトリを Jira にリンクして、課題に表示されるプル リクエストの開発情報を参照できます。
Bitbucket Cloud での OAuth 1.0 アカウント接続のサポートは、Jira 9.12.31、Jira 10.3.16、Jira 11.3.1 で廃止されました。Jira インスタンスが OAuth 1.0 を使用して Bitbucket Cloud に接続されている場合、できるだけ早く接続を更新して OAuth 2.0 を使用することをお勧めします。OAuth 1.0 のサポートが終了すると、OAuth 1.0 を使用した接続は機能しなくなります。
概要
接続を OAuth 1.0 から OAuth 2.0 に移行しているか、OAuth 2.0 接続を最初から設定するかに応じて、以下のいずれかのプロセスを実行します。
OAuth 2.0 接続を最初から設定
- Bitbucket で、非公開の OAuth 2.0 コンシューマーを作成します。
- Jira で、OAuth 2.0 を使用して Bitbucket Cloud をリンクします。
OAuth 1.0 から OAuth 2.0 へ移行
- Bitbucket で、コールバック URL を含めるように OAuth コンシューマーをアップデートします。
- Jira で、OAuth 1.0 接続を削除します。
- Jira で、OAuth 2.0 を使用して Bitbucket Cloud をリンクします。
Bitbucket Cloud で非公開の OAuth コンシューマーを作成または編集
接続を最初から設定する場合は、Bitbucket Cloud ワークスペースで非公開の OAuth 2.0 コンシューマーを作成して、Jira に Bitbucket へのアクセスを許可します。
接続を OAuth 1.0 から OAuth 2.0 にアップグレードする場合は、既存のコンシューマーにコールバック URL を追加します。
Bitbucket Cloud のアカウントに対する管理者権限を持つユーザーとしてログインする必要があります。
Bitbucket Cloud で OAuth トークンを作成するには、次の手順を実行します。
[アバター] > [すべてのワークスペース] の順に選択します。
- 関連するワークスペースを選択します。
- [設定] > [ワークスペース設定] の順に選択します。
- [アプリと機能] から、[OAuth コンシューマー] を選択します。
新しいコンシューマーを作成するには、[コンシューマーの追加] を選択します。
既存のコンシューマーをアップデートするには、[その他の操作...] を選択してから、アップデートするコンシューマーの横にある [編集] を選択します。以下の詳細を入力してください。
名前: わかりやすい名前 (例: Jira DVCS)。
- 説明: このトークンが何のために作成されたのかを想起させるような説明。
- URL: Jira Software インスタンスの URL (例:
https://example.atlassian.net)。 - コールバック URL: プレースホルダーの値。Jira インスタンスの URL を使用するか、あるいは
http://localhostに設定することをお勧めします。コールバック URL は OAuth 2.0 と互換性のあるコンシューマーを作成するために必要ですが、その値は認証フローでは使用されません。
- [これは非公開コンシューマーです] チェックボックスを選択します。
以下のパーミッションを選択します:
アカウント: 書き込み
リポジトリ: 管理者 (リポジトリへの書き込み権限はなし)
プル リクエスト: 読み取り
- Webhook: 読み取りと書き込み
- 保存 を選択します。
- Select the name of your consumer to see the OAuth key and OAuth Secret values. You’ll need them when adding your Bitbucket cloud account in Jira.
Bitbucket Cloud への OAuth 1.0 接続を削除
この手順は、Bitbucket Cloud 接続を OAuth 1.0 から OAuth 2.0 にアップグレードする場合にのみ実行します。
OAuth 1.0 Bitbucket Cloud 接続を Jira から削除するには、次の手順に従います。
- [管理] > [アプリケーション] の順に移動します。
- サイドバーで、[DVCS アカウント] を選択します。
- リストで、削除する接続を見つけます。[その他の操作...] を選択し、[アカウントの削除] を選択して確定します。
アカウントが削除されたら、新しい OAuth 2.0 接続の作成に進むことができます。
使用している Bitbucket Cloud アカウントをリンクする
Jira で Bitbucket Cloud アカウントを追加するには、次の手順を実行します。
[管理] > [アプリケーション] の順に移動します。
サイドバーで、[DVCS アカウント] を選択します。
- [アカウントをリンク] を選択します。
In Host, select Bitbucket cloud OAuth 2.0.
Bitbucket Cloud からキーとシークレットの値をコピーして、クライアント ID とクライアント シークレットとして Jira に入力します。
- Leave the default values for Auto Link New Repositories and Enable Smart Commits
(recommended), or change them if required. - Select Add.
次のステップ
アカウントを追加すると、結果は次のようになります。
リポジトリの同期: [DVCS] ページに表示されるアカウントを自動的にリンクする場合は、Jira はそのリポジトリの同期を開始します。詳細については、「DVCS を使用した開発ツールの統合」を参照してください。
問題の照合: コミットとプル リクエストに課題キーが含まれている場合、Jira はそれらを見つけて関連する情報を課題に追加します。詳細は、「開発作業から課題を参照する」でご確認ください。
開発情報の表示: 正しく参照された場合、開発情報はあなたの課題に追加されて、関係するすべての人により多くのコンテキストを提供します。詳細については、「課題に対する開発情報の表示」を参照してください。
ワークフロー トリガー: 開発ツールを統合するメリットの 1 つは、ワークフロー トリガーを追加することです。たとえば、新しいブランチを作成した後に課題ステータスを変更できます。詳細については、「ワークフロー トリガーの構成」を参照してください。