Jiraイシューのインテグレーション
Jira イシューインテグレーションは、1つ以上の GitLab プロジェクトを Jira インスタンスに接続します。Jira インスタンスは自分でホストすることも、Jira Cloud でホストすることもできます。サポートされている Jira のバージョンは6.x,7.x,8.x,9.xです。
インテグレーションの設定
GitLab 16.0 で導入されたJira パーソナルアクセストークンによる認証。
前提条件：
- GitLab インストールでは相対 URL を使用してはいけません。
- Jira Cloud については、Jira Cloud API トークンと、トークンを作成するために使用したメールアドレスが必要です。
-
Jira Data Center または Jira Server の場合は、次のいずれかが必要です：
- Jira ユーザー名とパスワード。
- Jira パーソナルアクセストークン (GitLab 16.0 以降)。
GitLab でプロジェクト設定を行うことで、Jira イシューのインテグレーションを有効にすることができます。これらの設定はグループレベルで、またはセルフマネジメント GitLab の場合はインスタンスレベルで設定できます。
GitLab でプロジェクト設定を行うには：
- 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
- 設定]>[インテグレーション]を選択します。
- Jira を選択します。
- インテグレーションを有効にする]で、[アクティブ]チェックボックスを選択します。
- 接続の詳細を入力します：
-
Web URL：この GitLab プロジェクトにリンクしている Jira インスタンス Web インターフェイスのベース URL (インスタンス:
https://jira.example.com)。 -
Jira API URL：Jira インスタンス API のベース URL (インスタンス:
https://jira-api.example.com)。この URL が設定されていない場合、デフォルトでWeb URLの値が使用されます。Jira Cloud の場合、Jira API URLは空白のままにします。 -
認証方法：
-
ベーシック
-
電子メールまたはユーザー名：
- Jira Cloud の場合、電子メールを入力します。
- Jira Data Center または Jira Server の場合は、ユーザー名を入力します。
-
API トークンまたはパスワード：
- Jira Cloud の場合、API トークンを入力します。
- Jira Data Center または Jira Server の場合は、パスワードを入力します。
-
電子メールまたはユーザー名：
- Jira 個人アクセストークン(Jira Data Center および Jira Server でのみ使用可能)：個人アクセストークンを入力します。
-
ベーシック
-
Web URL：この GitLab プロジェクトにリンクしている Jira インスタンス Web インターフェイスのベース URL (インスタンス:
- トリガーの設定を行います：
- トリガーとして、コミット、マージリクエスト、またはその両方を選択します。GitLab で Jira イシュー ID に言及すると、GitLab はそのイシューにリンクします。
- GitLab にリンクするコメントを Jira 課題に追加するには、コメントを有効にするチェックボックスとコメントが表示する情報を選択します。
- GitLab でJira イシューを自動的に移行するには、[Jira トランジションを有効にする] チェックボックスを選択します。
-
Jira イシューのマッチングセクションで
- Jira イシューの正規表現では、正規表現パターンを入力します。
- Jira issue prefix にはプレフィックスを入力します。
-
イシューセクションで
- GitLab プロジェクトでJira イシューを表示するには、[Jira イシューを有効にする] チェックボックスを選択し、Jira プロジェクトキーを入力します。GitLab プロジェクトでは、単一の Jira プロジェクトからのイシューしか表示できません。
この設定を有効にすると、その GitLab プロジェクトにアクセスできるすべてのユーザーは、指定した Jira プロジェクトのすべてのイシューを閲覧できるようになります。- 脆弱性の Jira イシューを作成するには、[脆弱性からの Jira イシュー作成を有効にする] チェックボックスを選択します。
- オプション。Test settingsを選択します。
- 変更を保存を選択します。
GitLab プロジェクトはインスタンス内のすべての Jira プロジェクトとやり取りできるようになり、プロジェクトには Jira プロジェクトを開く Jira リンクが表示されます。
Jira Cloud API トークンの作成
Jira Cloud の Jira イシュー インテグレーションを設定するには、Jira Cloud API トークンが必要です。Jira Cloud API トークンを作成するには
-
Jira プロジェクトへの書き込み権限を持つアカウントからアトラシアンにサインインします。
リンクはAPI トークンのページを開きます。または、アトラシアンのプロフィールから、アカウント設定 > セキュリティ > API トークンの作成と管理を選択します。
- API トークンの作成] を選択します。
- ダイアログでトークンのラベルを入力し、[作成]を選択します。
APIトークンをコピーするには、「コピー」を選択します。
GitLab の Jira Server から Jira Cloud へのマイグレーション
GitLab で Jira Server から Jira Cloud にマイグレーションし、Jira インテグレーションをメンテナーするには：
- 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
- 設定]>[インテグレーション]を選択します。
- Jira を選択します。
-
Web URL] に、新しい Jira サイト URL (例:
https://myjirasite.atlassian.net) を入力します。 - 電子メールまたはユーザー名には、Jira プロファイルに登録されている電子メールを入力します。
- Jira Cloud API トークンを作成し、トークンの値をコピーします。
- API トークンまたはパスワードに API トークンの値を貼り付けます。
- オプション。Test settingsを選択します。
- 変更を保存を選択します。
GitLab の既存の Jira イシュー参照を更新して新しい Jira サイト URL を使用するには、Markdown キャッシュを無効にする必要があります。