Jira DVCS コネクタ

caution
Jira Cloud 用の Jira DVCS コネクタは GitLab 15.1 で非推奨となり、16.0 で削除されました。代わりにGitLab for Jira Cloud アプリを使用してください。Jira DVCS コネクタは Jira 8.13 以前でも非推奨となり、削除されました。Jira DVCS コネクターは Jira 8.14 以降の Jira Data Center または Jira Server でのみ使用できます。Jira インスタンスを Jira 8.14 以降にアップグレードし、GitLab インスタンスで Jira インテグレーションを再設定してください。

Jira Data Center または Jira Server で Jira インスタンスをセルフホストし、Jira 開発パネルを使用したい場合は、Jira DVCS (ディストリビューション バージョン管理システム) コネクタを使用します。Jira DVCS コネクターはアトラシアンによって開発、メンテナーされています。詳細については、アトラシアンのドキュメントを参照してください。

Jira Cloud を使用している場合は、GitLab for Jira Cloud アプリにマイグレーションします。詳細については、GitLab for Jira Cloud アプリのインストールを参照してください。

Jira DVCS コネクターの設定

前提条件

  • GitLab インスタンスは Jira からアクセス可能である必要があります。
  • 少なくとも GitLab グループのメンテナー ロールを持っている必要があります。
  • ネットワークが GitLab と Jira 間のインバウンドおよびアウトバウンド接続を許可している必要があります。

DVCS 用 GitLab アプリケーションの作成

  • 単一グループのプロジェクトでは、グループアプリケーションを作成する必要があります。
  • 複数のグループにまたがるプロジェクトの場合、Jira インテグレーション作業専用の GitLab ユーザーアカウントを別途作成する必要があります。このアカウントは、定期的なメンテナンスがインテグレーションに影響しないことを保証します。
  • グループアプリケーションや別のユーザーアカウントを作成できない場合は、代わりに作成することができます：

DVCS用のGitLabアプリケーションを作成するには：

  1. 適切なアプリケーションセクションに移動します。
  2. Name] テキストボックスに、インテグレーションを説明する名前を入力します（例：Jira）。
  3. Redirect URIテキストボックスには、GitLab アカウントのリンクから生成されたリダイレクト URLを入力します。
  4. スコープで、api その他のチェックボックスを選択してオフに apiします。api Jira DVCS コネクタは api、必要な Webhook を自動的に作成して管理するために、api 書き込み可能なスコープを必要と apiします。
  5. Submit（送信）を選択します。
  6. アプリケーション IDとシークレットの値をコピーします。これらの値は Jira を設定するために必要です。

DVCS 用の Jira の設定

DVCS 用の Jira を設定します：

  1. トップバーの右上で、[管理({設定})] > [アプリケーション] を選択します。
  2. 左サイドバーで、DVCSアカウントを選択します。
  3. Hostドロップダウンリストから、GitLabまたはGitLab Self-Managed を選択します。
  4. Team or User Accountには、GitLabユーザーがアクセスできるトップレベルのGitLabグループの相対パスを入力します。
  5. Host URLには、GitLabインスタンスのドメインを入力します。
  6. Client Configurationドロップダウンリストから、作成したアプリケーションリンクを選択します。
  7. オプションです。新しいリポジトリの自動リンク］と［スマートコミットを有効にする］チェックボックスをオンまたはオフにします。
  8. Add] を選択し、[Continue] を選択します。

Jira は GitLab にリダイレクトし、そこで作成者を確認する必要があります。GitLab は Jira にリダイレクトし、同期されたプロジェクトが新しいアカウントに表示されます。最初の同期には数分かかります。最初の同期の後、更新には最大60分かかります。

他の GitLab トップレベルグループまたは個人のネームスペースから追加の GitLab プロジェクトを接続するには、Jira DVCS アカウントを追加して前の手順を繰り返します。

Jira にインポートしたデータをリフレッシュします。

Jira は 60 分ごとに GitLab プロジェクトのコミットとブランチをインポートします。Jira で手動でデータをリフレッシュするには、以下の手順に従います：

  1. インテグレーションを設定したユーザーとして Jira インスタンスにサインインします。
  2. トップバーの右上で、[管理({設定})] > [アプリケーション] を選択します。
  3. 左サイドバーで、DVCSアカウントを選択します。
  4. DVCS アカウントの 1 つ以上のリポジトリを更新するには：
    • すべてのリポジトリについて、アカウントの横にある省略記号({ellipsis_h}) >リポジトリを更新を選択します。
    • 単一のリポジトリの場合：
      1. アカウントを選択します。
      2. 更新したいリポジトリにカーソルを合わせ、[最後のアクティビティ]列で[リポジトリを同期（{再試行}）をクリック]を選択します。