Jira開発パネル
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
Jira開発パネルを使用すると、JiraイシューのGitLabアクティビティーをJiraで直接表示できます。Jira開発パネルをセットアップするには、次の手順に従います:
- Jira Cloudでは、GitLabで開発および保持されているJira Cloudアプリ用のGitLabを使用します。
- Jira Data CenterまたはJira Serverでは、Atlassianで開発および保持されているJira DVCS connectorを使用します。
概要については、Jira開発パネルのインテグレーションを参照してください。
機能の可用性
この表は、Jira DVCSコネクターとJira Cloudアプリ用GitLabで使用できる機能を示しています:
| 機能 | Jira DVCSコネクタ | GitLab for Jira Cloudアプリ |
|---|---|---|
| スマートコミット | 対応 | 対応 |
| マージリクエストの同期 | 対応 | 対応 |
| ブランチの同期 | 対応 | 対応 |
| コミットの同期 | 対応 | 対応 |
| 既存データの同期 | 対応 | はい（Jiraと同期されたGitLabのデータを参照） |
| ビルドの同期 | 対象外 | 対応 |
| デプロイの同期 | 対象外 | 対応 |
| 機能フラグの同期 | 対象外 | 対応 |
| 同期間隔 | 最大60分 | リアルタイム |
| ブランチの削除 | 対象外 | 対応 |
| ブランチからマージリクエストを作成 | 対応 | 対応 |
| Jiraイシューからブランチを作成 | 対象外 | 対応 |
GitLabで接続されたプロジェクト
Jira開発パネルは、すべてのプロジェクトを持つJiraインスタンスを以下に接続します:
- Jira Cloudアプリ用GitLabの場合、リンクされたGitLabグループまたはサブグループとそのプロジェクト
- Jira DVCSコネクターの場合、リンクされたGitLabグループ、サブグループ、または個人のネームスペースとそのプロジェクト
開発パネルに表示される情報
Jira開発パネルでJiraイシューに関するGitLabアクティビティーを表示するには、GitLabでID別にJiraイシューを参照します。開発パネルに表示される情報は、GitLabでJiraイシューのIDをどこに記述するかによって異なります。
Jira Cloudアプリ用GitLabでは、次の情報が表示されます。
| GitLab: JiraイシューのIDを記述する場所 | Jira開発パネル: 表示される情報 |
|---|---|
| マージリクエストのタイトルまたは説明 | マージリクエストへのリンク デプロイへのリンク マージリクエストのタイトルを介したパイプラインへのリンク マージリクエストの説明を介したパイプラインへのリンク（GitLab 15.10で導入）。 ブランチへのリンク（GitLab 15.11で導入） レビュアー情報と承認ステータス（GitLab 16.5で導入） |
| ブランチ名 | ブランチへのリンク デプロイへのリンク |
| コミットメッセージ | コミットへのリンク 環境への最後のデプロイが成功した後、最大2,000コミットからのデプロイへのリンク1 2 |
| Jiraスマートコミット | カスタムコメント、記録された時間、またはワークフローの移行 |
脚注:
- GitLab 16.2で
jira_deployment_issue_keysフラグとともに導入されました。デフォルトでは有効になっています。 - 一般提供はGitLab 16.3で開始されました。機能フラグ
jira_deployment_issue_keysは削除されました。
Jiraスマートコミット
前提要件:
- 同じメールアドレスまたはユーザー名を持つGitLabおよびJiraユーザーアカウントが必要です。
- コマンドは、コミットメッセージの最初の行に記述する必要があります。
- コミットメッセージが複数行にわたることはできません。
Jiraスマートコミットは、Jiraイシューを処理するための特別なコマンドです。これらのコマンドを使用すると、GitLabを使用して以下を実行できます:
- Jiraイシューにカスタムコメントを追加します。
- Jiraイシューに対して時間を記録します。
- プロジェクトのワークフローで定義された任意のステータスにJiraイシューを遷移させます。
スマートコミットは、この構文に従う必要があります:
<ISSUE_KEY> <ignored text> #<command> <optional command parameters>単一のコミットで1つまたは複数のコマンドを実行できます。
スマートコミットの構文
| コマンド | 構文 |
|---|---|
| コメントを追加 | KEY-123 #comment Bug is fixed |
| 時間を記録 | KEY-123 #time 2w 4d 10h 52m Tracking work time |
| イシューをクローズ | KEY-123 #close Closing issue |
| 時間を記録してイシューをクローズ | KEY-123 #time 2d 5h #close |
| コメントを追加して進行中に移行 | KEY-123 #comment Started working on the issue #in-progress |
スマートコミットの動作方法と使用可能なコマンドの詳細については、以下を参照してください:
デプロイ
Jiraデプロイを使用すると、ソフトウェアリリースの進捗状況をJiraで直接追跡および視覚化できます。
以下の場合、GitLabは環境とデプロイに関する情報をJiraに送信します:
- プロジェクトの
.gitlab-ci.ymlファイルにenvironmentキーワードが含まれている。 - JiraイシューIDがGitLabの特定の箇所で言及され、パイプラインがトリガーされた。
詳細については、環境とデプロイを参照してください。