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:
Set up an application tunnel (if required).
Check that the Application tunnels app is installed in Jira 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: アプリケーション トンネルをセットアップする
You may be able to skip this step. Refer to the following table:
| Jira instance accessible over public internet | Jira instance is on a private network |
|---|---|---|
Jira instance is earlier than 11.3.11 | Go to step 3 (Your tunnel will be set up automatically) | Complete step 1 (Set up an application tunnel) |
Jira instance is 11.3.11 or later | Go to step 3 (Your tunnel will be set up automatically) | Go to step 2 (Your tunnel will be set up automatically, but you may need to install an app) |
新しいトンネルを作成する
Atlassian Marketplace でアプリケーション トンネル アプリを開きます。
Data Center インスタンスに Marketplace アプリをインストールします。
必要な接続とアップストリーム ポートを設定します。
移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
Select Data management, then Data sources, then Application tunnels.
[トンネルを作成] を選択します。
ウィザードに従ってオンプレミス インスタンスの詳細を入力して、トンネルに関連付けられたセキュリティ キーを生成します。
Jira Data Center インスタンスにキーを追加します。
インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。
インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーション トンネル] で [セキュリティ キーを追加] を選択することで手動で追加できます。
セキュリティ キーを貼り付けて、ウィザードのステップに従います。
これでトンネルが作成されました。ステータスが「接続済み」になるまで待ってください。
既存のトンネルを使用する
既存のトンネルを使用するには、HTTP コネクタを変更します。
インストール ディレクトリで
conf/server.xmlファイルを編集します。secure="true"という属性が含まれるようにコネクタを更新します。
Step 2: Check that the Application tunnels app is installed in Jira Data Center
In this step, you'll check that your Data Center instance has an app from Atlassian Marketplace installed. The app is required for application tunnels to work.
Navigate to the Manage apps page in your Jira Data Center admin screen.
Search for the Application tunnels app, and if it’s not instaleld, install it Application tunnels from Atlassian Marketplace.
Step 3: Set up сloud connector
このステップでは、クラウド組織と Jira Data Center インスタンスの間に組織レベルのクラウド コネクタを作成します。
「クラウド コネクタを設定する」で説明されているステップを実行したあと、このページに戻ります。
Step 4: Set up Teamwork Graph connector
この手順では、クラウド サイトと Data Center インスタンスを切り替える必要があるため、必ず両方を開いておいてください。
Also in this step, we’ll run a check to reach your Data Center instance.
if a tunnel is already connected to your instance, it will be selected automatically.
If no tunnel exists and your version supports automatic setup, you can create one directly during this step. Credentials are exchanged automatically, with no manual copying and no Data Center restart.
クラウドで Teamwork Graph コネクタを作成する
1. Go to アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
2. Select Data management, then Data sources, then Connected sources.
3. Next to your organization connection, select Connect app.
4. On the Select an app to connect screen, select Atlassian Rovo.
5. On the Select site screen, select a cloud site that you’d like to connect Teamwork Graph to, and then select Next.
6. On the Check connection screen, if a tunnel isn’t automatically selected, select the Private connection option, which will create a tunnel for you, then select Next.
7. On the Send connection request screen, select Agree and continue.
8. Now that you’ve configured the connection on the cloud side, select Go to Data Center to finish the connection. If you don’t have the Data Center system admin permissions, ask the admin to continue the setup on the Data Center side.
Data Center で接続リクエストを承認する
1. Jira 管理画面の [Cloud connectors (クラウド コネクタ)] ページで、[Review request (リクエストのレビュー)] を選択します。
2. On the Review connection request screen, select Accept. If you previously chose to have a tunnel created up for you, this approval covers both the application tunnel and the Teamwork Graph connector. Rovo is powered by Teamwork Graph, so it will appear with that name on the list.
If you chose to have a tunnel automatically created, after accepting the connection, no restart of the Data Center instance is required.
Step 5: Manage shared content in cloud
インデックス化するプロジェクトを選択できます。既定では、すべてのプロジェクトが選択されています。今後作成される新しいプロジェクトを含めるかどうかも選択できます。
作業を開始する前に、次の点に注意してください。
コネクタは、含めるデータの選択を保存した後にのみ、含まれるプロジェクトのコンテンツのインデックス化を開始します。それまでは、コネクタではプロジェクト名、プロジェクト キー、プロジェクト アイコンを含むすべてのプロジェクトのリストのみをインデックス化します。
個別の課題のブロックはサポートされていません。
共有コンテンツを管理するには、次の手順に従います。
クラウド管理者ハブの [接続済みソース] ページを更新します。
新しい 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 アプリをインストールします。
必要な接続とアップストリーム ポートを設定します。
移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
Select Data management, then Data sources, then Application tunnels.
[トンネルを作成] を選択します。
ウィザードに従ってオンプレミス インスタンスの詳細を入力して、トンネルに関連付けられたセキュリティ キーを生成します。
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 コネクタのセットアップ画面にアクセスします。
移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
From the side navigation, select Connectors.
Select Add connector, then, if you have more than one site, pick the site you want to connect to.
[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, 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 のどちらの管理者パネルにも表示されなくなります。
この内容はお役に立ちましたか?