Jira Data Center を Teamwork Graph に接続する
Jira Data Center のプロジェクトと課題を Teamwork Graph に統合することで、Data Center および Cloud サイト全体でチームのナレッジを一元化します。
何がインデックス化されますか?
Jira DC コネクタは、次のオブジェクトをインデックス化します。
プロジェクト (ビジネス、ソフトウェア、サービスの各タイプ)
課題
コメント
関連する各オブジェクトについて、次の属性がインデックス化されます。
名前
タイプ
説明
createdDate
最終更新日
作成者
最終更新者:
投稿者
担当者
Project
親
ラベル
投票数
ウォッチャー
反応
ステータス
サブタイプ
優先度
期限
ソリューション
環境
添付ファイル
関係
チーム
URL
コンテナー キー (エピック/プロジェクトなどの関係用)
親キー (サブタスク/親の関係用)
テキスト/本文 (コメント用)
はじめる前に
Jira Data Center を Teamwork Graph に接続するために最低限必要なバージョンは、Jira 11.0 以降および 10.3.10 LTS 以降です。
[コンテンツを管理] でリストされるエクスペリエンスは、Rovo Connector for Jira Data Center プラグインにバンドルされています。これらは、Jira Data Center 11.3.4 以降および 10.3.19 以降で利用できます。Atlassian Marketplace で Rovo Connector for Jira Data Center を検索して、Jira Data Center 11.2.1 以降、10.3.10 以降、および 10.7.3 以降用のプラグインをインストールすることもできます。
クラウド サイトには最大 3 つの Jira Data Center インスタンスを接続できます。
Teamwork Graph では常に権限が遵守されます。ユーザーには、すでにアクセス権があるコンテンツのみが表示されます。コネクタと権限の詳細をご確認ください
Jira 11.3 以降では、クラウド コネクタを介して Data Center とクラウドをリンクする新しい方法を導入しています。このアプローチでは、引き続きアプリケーション リンクを接続方法として利用できますが、今後は OAuth 2.0 によって強化されます。
レート制限を有効にしている場合は、コンテンツが Teamwork Graph でシームレスにインデックス化されるように、リクエスト制限を調整する必要があることがあります。
既存の Jira コネクタがあり、Rovo Connector for Jira Data Center プラグインをアップグレードしたい場合は、新しいコネクタをセットアップすることをお勧めします。
既存のコネクタを引き続き使用する場合は、データの損失を防ぐため、アップグレード前に Jira DC インスタンスで次の機能フラグを無効にしてください。com.atlassian.jira.plugin.rovo.disable.journal.on.plugin.restart
プラグインのバージョンを更新してコンテンツを管理した後、この機能フラグを再び有効化できます。Jira DC で機能フラグを管理する方法の詳細をご確認ください
概要
Jira Data Center を Teamwork Graph に接続する準備ができている場合は、次のステップを実行します。これらのステップは、ご利用の Jira Data Center バージョンによって異なります。
For Jira 11.3 and later, or Jira 10.3.23 and later patches:
Data Center インスタンスがプライベート ネットワークでホストされている場合は、アプリ トンネルを作成します。
クラウド コネクタを使用して Rovo コネクタをセットアップします。
含めるプロジェクトを選択します。
既存の Rovo コネクタをクラウド コネクタに切り替えることは、インデックス再作成がトリガーされ、問題が発生する可能性があるため、現時点では推奨していません。
Jira Data Center 11.2 以前の場合は、次のようにアプリ リンクを使用します。
アプリ トンネルを作成するか、許可リストを設定します。このステップは、プライベート ネットワークでホストされている Jira インスタンスにのみ適用されます。Jira インスタンスがパブリック インターネットにある場合は、このステップをスキップしてください。
受信アプリケーション リンクを作成します。
アトラシアンの管理でコネクタをセットアップします。
Jira Data Center インスタンスを 1 つのクラウド テナントに接続する際の制限を撤廃しました。Rovo コネクタを使用して、必要な数のインスタンスに接続できるようになりました。
検索には一定の制限が適用されます。詳細については、「検索」をご確認ください
Cloud コネクタで Teamwork Graph に接続する
These steps apply to Jira 11.3 and later, and Jira 10.3.23 and later patches. If you’re using earlier versions, check other connection options via application links.
ステップ 1: アプリケーション トンネルをセットアップする
Jira Data Center インスタンスにパブリック インターネットからアクセスできる場合は、このステップをスキップしてステップ 2 に進んでください。
Jira Data Center インスタンスが非公開ネットワークにある場合は、Cloud 組織から Jira Data Center インスタンスへのアプリ トンネルをセットアップする必要があります。設定を調整することで、既存のトンネルも使用できます。トンネルの詳細
新しいトンネルを作成する
Atlassian Marketplace でアプリケーション トンネル アプリを開きます。
Data Center インスタンスに Marketplace アプリをインストールします。
必要な接続とアップストリーム ポートを設定します。
移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
[データ管理] > [データ ソース] > [アプリケーション トンネル] の順に選択します。
[トンネルを作成] を選択します。
ウィザードに従ってオンプレミス インスタンスの詳細を入力して、トンネルに関連付けられたセキュリティ キーを生成します。
Jira Data Center インスタンスにキーを追加します。
インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。
インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーション トンネル] で [セキュリティ キーを追加] を選択することで手動で追加できます。
セキュリティ キーを貼り付けて、ウィザードのステップに従います。
これでトンネルが作成されました。ステータスが「接続済み」になるまで待ってください。
既存のトンネルを使用する
既存のトンネルを使用するには、HTTP コネクタを変更します。
インストール ディレクトリで
conf/server.xmlファイルを編集します。secure="true"という属性が含まれるようにコネクタを更新します。
ステップ 2: クラウド コネクタをセットアップする
このステップでは、クラウド組織と Jira Data Center インスタンスの間に組織レベルのクラウド コネクタを作成します。
「クラウド コネクタを設定する」で説明されているステップを実行したあと、このページに戻ります。
ステップ 3: Teamwork Graph コネクタをセットアップする
この手順では、クラウド サイトと Data Center インスタンスを切り替える必要があるため、必ず両方を開いておいてください。
クラウドで Teamwork Graph コネクタを作成する
1. クラウド管理者ハブの「Connected sources (接続済みのソース)」ページに移動します。このページを開く方法は、次のように 2 つあります。
a. Data Center の [Jira 管理] の [Cloud connectors (クラウド コネクタ)] ページで、[Connect cloud apps (クラウド アプリの接続)] を選択します。クラウドの関連ページにリダイレクトされます。
b. クラウドの管理ハブで、[データ管理] > [データソース] > [接続済みソース] の順に移動します。
2. 組織接続の横にある [Connect app (アプリを接続)] を選択します。
3. [Select an app to connect (接続するアプリを選択)] 画面で、[Atlassian Rovo] を選択します。
4. [サイトを選択] 画面で、Teamwork Graph に接続するクラウド サイトを選択し、[次へ] を選択します。
5. [Check connection (接続を確認)] 画面で、Data Center インスタンスに到達するためのチェックを実行します。複数のアプリケーション トンネルがある場合は、必要なものを選択してから、[次へ] を選択します。アプリケーション トンネルがない場合は、作成してください。
6. [Send connection request (接続リクエストを送信)] 画面で、[同意して続行] を選択します。
7. クラウド側で接続を設定したので、[Go to Data Center (Data Center に移動)] を選択して接続を完了します。Data Center システムの管理者権限がない場合は、管理者に Data Center 側のセットアップを続行するよう依頼してください。
Data Center で接続リクエストを承認する
1. Jira 管理画面の [Cloud connectors (クラウド コネクタ)] ページで、[Review request (リクエストのレビュー)] を選択します。
2. [接続リクエストの確認] 画面で [承認] を選択します。Rovo は Teamwork Graph を基盤としているため、リストにはその名前で表示されます。
ステップ 4: クラウドで共有コンテンツを管理する
インデックス化するプロジェクトを選択できます。既定では、すべてのプロジェクトが選択されています。今後作成される新しいプロジェクトを含めるかどうかも選択できます。
作業を開始する前に、次の点に注意してください。
コネクタは、含めるデータの選択を保存した後にのみ、含まれるプロジェクトのコンテンツのインデックス化を開始します。それまでは、コネクタではプロジェクト名、プロジェクト キー、プロジェクト アイコンを含むすべてのプロジェクトのリストのみをインデックス化します。
個別の課題のブロックはサポートされていません。
共有コンテンツを管理するには、次の手順に従います。
クラウド管理者ハブの [接続済みソース] ページを更新します。
新しい Teamwork Graph コネクタを見つけて、[コンテンツを管理] を選択します。
3. [Choose data to include (含めるデータを選択)] 画面で、インデックス化するプロジェクトを選択します。既定では、すべてのプロジェクトが選択されています。次のいずれかの方法を使用できます。
[Automatically include all current and future spaces (現在および今後のすべてのプロジェクトを自動的に含める)] トグルを有効にします。
トグルを無効にして、インデックス化するプロジェクトの名前を選択します。
4. [保存] を選択します。
これで、Teamwork Graph コネクタが設定されました。
次のステップ
Jira Data Center の接続が完了すると、チーム メンバーには、検索のフィルター オプションとして Jira Data Center と Jira Service Management Data Center (該当する場合) が表示されます。結果が表示される前に接続を求められます。これは、Teamwork Graph においてチーム メイトに表示する結果をそれぞれのアクセス権に基づいて制限するのに必要です。
Jira Data Center インスタンス内のコンテンツの量によっては、すべてがインデックス化されて Teamwork Graph に表示されるまでに時間を要する場合があります。
接続ステータス
[接続済みソース] ページには、Data Center インスタンスが Teamwork Graph にどのように接続されているかを示すさまざまなステータスがあります。クラウドと Data Center での接続ステータスの概要は次のとおりです。
クラウドのステータス | Data Center のステータス | 説明 |
|---|---|---|
接続済み | 接続済み | 接続は正常に確立されています。 |
取り消し済み | 無効 | コネクタの認証情報は取り消されており、クラウド管理者が認証情報をローテーションするまで接続は無効になります。 |
中断 | 中断 | 接続はアクティブでしたが、予期せず動作を停止しました。 |
Teamwork Graph にアプリケーション リンク経由で接続する
これらのステップは、Jira Data Center 11.2 以前に適用されます。新しいバージョンをご利用の場合は、Cloud コネクタ経由の接続オプションの使用をご検討ください。
ステップ 1: アプリケーション トンネルをセットアップする
Jira Data Center インスタンスにパブリック インターネットからアクセスできる場合は、このステップをスキップしてステップ 2 に進んでください。
Jira Data Center インスタンスが非公開ネットワークにある場合は、Cloud 組織から Jira Data Center インスタンスへのアプリ トンネルをセットアップする必要があります。設定を調整することで、既存のトンネルも使用できます。トンネルの詳細
また、トンネルの使用が望ましくない場合は、Data Center インスタンス内の Atlassian Cloud 製品やサイトの受信接続や IP を許可リストに登録することもできます。Atlassian Cloud 製品の IP アドレスとドメインの詳細については、こちらをご確認ください。
新しいトンネルを作成する
Atlassian Marketplace でアプリケーション トンネル アプリを開きます。
Data Center インスタンスに Marketplace アプリをインストールします。
必要な接続とアップストリーム ポートを設定します。
移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
[データ管理] > [データ ソース] > [アプリケーション トンネル] の順に選択します。
[トンネルを作成] を選択します。
ウィザードに従ってオンプレミス インスタンスの詳細を入力して、トンネルに関連付けられたセキュリティ キーを生成します。
Jira Data Center インスタンスにキーを追加します。
インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。
インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーション トンネル] で [セキュリティ キーを追加] を選択することで手動で追加できます。
セキュリティ キーを貼り付けて、ウィザードのステップに従います。
これでトンネルが作成されました。ステータスが「接続済み」になるまで待ってください。
既存のトンネルを使用する
既存のトンネルを使用するには、HTTP コネクタを変更します。
インストール ディレクトリで
conf/server.xmlファイルを編集します。secure="true"という属性が含まれるようにコネクタを更新します。
ステップ 2: 受信アプリケーション リンクを作成する
接続プロセスで使用する Jira Data Center インスタンスの管理画面でアプリ リンクを作成します。アプリ リンクの作成方法をご確認ください
Jira 11.0 EAP4 以前では、アプリ リンク作成を開始する前に次の手順を実行してください。
ダーク機能ページに移動: <base_url>/secure/SiteDarkFeatures!default.jspa
ダーク機能ページにこのフラグを追加:
scope.manage.subscriptions.enabledアプリ リンクの作成に進む
Jira Data Center で、[管理] > [アプリ リンク] に移動します。
[リンクを作成] を選択します。
[外部アプリケーション] > [受信] を選択します。
[続行] を選択します。
アプリケーション リンクの名前を入力します。
https://id.atlassian.com/outboundAuth/finishをリダイレクト URL として挿入します。アプリの権限については、[サブスクリプションを管理] を選択します。
[保存] を選択します。
アプリケーション リンク テーブルの [アクション] で、その他のアクション (•••) > [認証情報を表示] の順に選択します。
[クライアント ID] と [クライアント シークレット] をメモします。この情報は、アトラシアンの管理でコネクタをセットアップする際に必要になります。
ステップ 3: アトラシアンの管理でコネクタをセットアップする
アトラシアンの管理の Jira Data Center コネクタのセットアップ画面にアクセスします。
移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
[アプリ] > [コネクタ] の順に選択します。
複数のサイトがある場合は、接続するサイトを選択してから [コネクタを追加] を選択します。
[Jira Data Center] を選択して [次へ] を押します。
Jira Data Center を設定します。
Jira Data Center の接続の名前を入力します。
Data Center のネットワーク タイプを選択します。
ネットワークがファイアウォールの内側にあり、パブリック インターネットからアクセスできない場合は、プライベート ネットワークを選択します。事前にセットアップしたアプリケーション トンネルを選択します。
Jira Data Center インスタンスにパブリック インターネットからアクセスできる場合、またはトンネルを使用する代わりに受信接続や IP を許可リストに登録している場合は、パブリック ネットワークを選択します。Jira Data Center インスタンスのサーバー ベース URL (該当する場合はコンテキスト パスを含む) を挿入します。
OAuth のクライアント ID とクライアント シークレットを入力します。
免責事項を確認します。
[Authorize Jira Data Center (Jira Data Center を承認)] を選択します。
ステップ 4: 含めるデータを選択する
インデックス化するプロジェクトを選択できます。既定では、すべてのプロジェクトが選択されています。今後作成される新しいプロジェクトを含めるかどうかも選択できます。
作業を開始する前に、次の点に注意してください。
コネクタは、含めるデータの選択を保存した後にのみ、含まれるプロジェクトのコンテンツのインデックス化を開始します。それまでは、コネクタではプロジェクト名、プロジェクト キー、プロジェクト アイコンを含むすべてのプロジェクトのリストのみをインデックス化します。
個別の課題のブロックはサポートされていません。
コネクタをセットアップすると、インデックス化されたコンテンツを管理できるようになります。
移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
Select Data Management, then Data sources, and then Connected sources.
[サイト] で、Jira Data Center の横にある [その他のアクション] () を選択し、[コンテンツを管理] を選択します。
コンテンツを削除する
すでにインデックス化されたプロジェクトを除外するよう選択した場合、検索から即座に削除されます。そのデータをアトラシアンが保管する期間の詳細については、データ、プライバシー、使用に関するガイドラインをご確認ください。
次のステップ
Jira Data Center の接続が完了すると、チーム メンバーには、検索のフィルター オプションとして Jira Data Center と Jira Service Management Data Center (該当する場合) が表示されます。結果が表示される前に接続を求められます。これは、Teamwork Graph においてチーム メイトに表示する結果をそれぞれのアクセス権に基づいて制限するのに必要です。
Jira Data Center インスタンス内のコンテンツの量によっては、すべてがインデックス化されて Teamwork Graph に表示されるまでに時間を要する場合があります。
Teamwork Graph コネクタを管理する
These steps apply to Jira 11.3 and later, or Jira 10.3.23 and later patches.
認証情報を取り消す
認証情報が漏洩し、安全でなくなった可能性がある場合は、認証情報を取り消してコネクタを無効にできます。
Teamwork Graph の認証情報を取り消すには、次の手順に従います。
1. Data Center インスタンスに移動します。[管理] にアクセスし、[アプリケーション リンク] を見つけて、[クラウド コネクタ] に移動します。
2. [その他のアクション] () を選択し、[Revoke credentials (認証情報を取り消す)] を選択します。
3. [Revoke credentials (認証情報を取り消す)] を選択してアクションを確定します。コネクタのステータスが [無効] に変更されます。
認証情報をローテーションする
Rovo の認証情報は、有効期限が切れた場合や取り消された後にローテーションできます。
Rovo の認証情報をローテーションするには、次の手順に従います。
1. クラウドの管理ハブで、[Data Management (データ管理)] > [データソース] > [接続済みソース] の順に移動します。
2. 組織コネクタを見つけて展開します。
3. Rovo 接続の横にある [その他のアクション] () を選択し、[Rotate credentials (認証情報をローテーションする)] を選択します。
4. [Rotate credentials (認証情報をローテーションする)] を選択してアクションを確定します。認証情報のローテーションが実行されるまで、最大 30 分間お待ちください。コネクタのステータスが [Connected (接続済み)] に変わります。
コネクタを削除する
Teamwork Graph コネクタは必要に応じて何度でも削除して再確立できます。コネクタを削除するには、接続済みステータスである必要があります。
Data Center から Teamwork Graph コネクタを削除するには、次の手順に従います。
1. Data Center インスタンスに移動します。[管理] にアクセスし、[アプリケーション リンク] を見つけて、[クラウド コネクタ] に移動します。
2. [その他のアクション] () を選択し、[Delete connector (コネクタを削除する)] を選択します。
3. [削除] を選択して、アクションを確定します。
クラウドから Teamwork Graph コネクタを削除するには、次の手順に従います。
1. クラウドの管理ハブで、[Data Management (データ管理)] > [データソース] > [接続済みソース] の順に移動します。
2. 組織コネクタを見つけて展開します。
3. Rovo コネクタの横で、[その他のアクション] () を選択し、[Delete connector (コネクタを削除する)] を選択します。
4. [削除] を選択して、アクションを確定します。
コネクタがクラウドと Data Center のどちらの管理者パネルにも表示されなくなります。
この内容はお役に立ちましたか?