Jira 開発パネル
Jira 開発パネルを使用すると、Jira で直接 Jira イシューの GitLab アクティビティを表示できます。Jira 開発パネルを設定するには：
- Jira Cloud については、GitLab が開発・メンテナーしているGitLab for Jira Cloud アプリを使用してください。
- Jira Data Center または Jira Server の場合は、アトラシアンが開発・メンテンスしているJira DVCS コネクタを使用してください。
概要については、Jira 開発パネルのインテグレーションを参照してください。
機能の可用性
この表は、Jira DVCS コネクタと GitLab for Jira Cloud アプリで利用可能な機能を示しています：
| 機能 | Jira DVCS コネクタ | GitLab for Jira Cloud アプリ |
|---|---|---|
| スマートコミット | {チェックサークル｝はい | {チェックサークル｝はい |
| マージリクエストの同期 | {チェックサークル｝はい | {チェックサークル｝はい |
| ブランチの同期 | {チェックサークル｝はい | {チェックサークル｝はい |
| コミットの同期 | {チェックサークル｝はい | {チェックサークル｝はい |
| 既存データの同期 | {チェックサークル｝はい | {チェック・サークル｝はい (部分)1 |
| 同期ビルド | {点線円｝いいえ | {チェックサークル｝はい |
| デプロイの同期 | {点線円｝いいえ | {チェックサークル｝はい |
| 同期機能フラグ | {点線円｝いいえ | {チェックサークル｝はい |
| 同期間隔 | 最大60分 | リアルタイム |
| ブランチの作成 | {点線円｝いいえ | {チェックマーク｝はい（GitLab SaaSのみ） |
| ブランチからマージリクエストを作成 | {チェックサークル｝はい | {チェックサークル｝はい |
| Jira 課題からブランチを作成 | {点線円｝いいえ | {チェックサークル｝はい (GitLab 14.2 で導入) |
- Jiraに同期されたGitLabデータを参照してください。
GitLab の接続プロジェクト
Jira 開発パネルは、Jira インスタンスとそのすべてのプロジェクトを次のように接続します：
- GitLab for Jira Cloud アプリの場合、リンクされた GitLab グループまたはサブグループとそのプロジェクト
- Jira DVCS コネクタの場合、リンクされた GitLab グループ、サブグループ、または個人の名前空間とそのプロジェクト
開発者パネルに表示される情報
GitLab の ID で Jira 課題を参照することで、Jira 課題の GitLab アクティビティをJira 開発パネルで見ることができます。開発パネルに表示される情報は、GitLab で Jira 課題 ID を参照した場所によって異なります。
| GitLab: Jira 課題 ID を言及した場所 | Jira 開発パネル: 表示される情報 |
|---|---|
| マージリクエストのタイトルまたは説明 | マージリクエストへのリンク デプロイへのリンク マージリクエストタイトルによるパイプラインへのリンク マージリクエストディスクリプションによるパイプラインへのリンク1 ブランチへのリンク2 |
| Branch name | ブランチへのリンク デプロイへのリンク |
| コミットメッセージ | コミットへのリンク 最後にデプロイに成功した環境から最大 5,000 コミット後のデプロイへのリンク3 4 |
| Jira スマートコミット | カスタムコメント、ログ時間、またはワークフロー遷移 |
- GitLab 15.10 で導入されました。
- GitLab 15.11 で導入。
- GitLab 16.2 で
jira_deployment_issue_keysというフラグで導入。デフォルトで有効。 - GitLab 16.3で一般的に利用可能に。機能フラグ
jira_deployment_issue_keysを削除しました。
Jira スマートコミット
前提条件：
- 同じメールアドレスまたはユーザー名で GitLab と Jira のユーザーアカウントが必要です。
- コマンドはコミットメッセージの最初の行に書く必要があります。
- コミットメッセージは1行を超えてはいけません。
Jira スマートコミットは、Jira イシューを処理するための特別なコマンドです。これらのコマンドを使うと、GitLab を使って次のことができます：
- Jira イシューにカスタムコメントを追加します。
- Jira 課題に対して時間を記録します。
- Jira 課題をプロジェクト ワークフローで定義されたステータスに移行します。
スマートコミットはこの構文に従う必要があります：
<ISSUE_KEY> <ignored text> #<command> <optional command parameters>
1つのコミットで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 |
スマートコミットの仕組みや使用可能なコマンドの詳細については、こちらをご覧ください：