GitLab アカウントのリンク
GitLab と GitLab Enterprise の各アカウントとそれらのリポジトリを Jira にリンクして、課題に表示されるプル リクエストからの開発情報を参照できます。
サポート対象バージョン
サポートされているバージョンのリストは次のとおりです。
| Jira バージョン | GitLab | GitLab self-managed |
|---|---|---|
| 8.14 以降 | 現行 | 13.0 以降 |
前提条件: OAuth 2.0 による Jira と GitLab の統合
Before you can add your GitLab account to the accounts page, you need to integrate Jira with GitLab using OAuth 2.0.
OAuth 2.0 との統合を Jira で作成するには、Jira システム管理者である必要があります。
Jira 内
Jira で新しい OAuth 2.0 連携を追加するには、次の操作を実行します。
- 画面右上で [管理
] > [システム] の順に選択します。 In the sidebar, select OAuth 2.0 and then select Add new integration.
[サービス プロバイダー] で [カスタム] を選択します。
連携の名前を入力します。
ここでは クライアント ID とクライアント シークレットは、まず置いておいてください。次のステップで GitLab から入手します。
次の表に示すように、認証エンドポイントとトークンのエンドポイントを入力します。
GitLab タイプ 認証エンドポイント トークン エンドポイント Gitlab.com https://gitlab.com/oauth/authorizehttps://gitlab.com/oauth/tokenGitLab self-managed <GITLAB_SELF_MANAGED_URL>/oauth/authorize<GITLAB_SELF_MANAGED_URL>/oauth/tokenリダイレクト URL をコピーします。この URL は次のステップの GitLab で使用します。
GitLab での操作
Jira 設定を開いたままにして、GitLab に移動して新しいアプリケーションを作成します。これにより、Jira で使用するアプリケーション ID とアプリケーション シークレットが得られます。
GitLab で、[ユーザー設定] > [アプリケーション] の順に移動して、新しいアプリを追加します。次のデータを使用します。
リダイレクト URI: Jira からコピーした URL を入力します。
機密情報: 有効のままにします。
スコープ: [API] を選択します。これは接続を機能させるために必要です。
- アプリケーションを作成したら、下の画像のようにアプリケーション ID とアプリケーション シークレットを取得する必要があります。
ここで Jira に戻る
Jira の設定に戻って、不足している情報を入力して統合を完成します。
GitLab のアプリケーション ID をクライアント ID として入力します。
GitLab のアプリケーション シークレットをクライアント シークレットとして入力します。
[スコープ] で [API] を選択します。
Save the integration, and then select Test Connection.
- GitLab の承認プロンプトで、[承認] を選択します。
GitLab アカウントをリンクする
With the OAuth 2.0 integration created, you can use it when linking your GitLab account on the accounts page in Jira:
- 画面右上で [管理] > [アプリ] の順に選択します。
- Under Intergations, select DVCS Accounts.
- Select Link an account.
[ホスト] ドロップダウンで [GitLab] または [GitLab Self-Managed] を選択します。
[GitLab Self-Managed] の場合は、GitLab ホストの URL を入力します。
Gitlab の場合は、ホスト URL は https://gitlab.com に固定されています。
[チームまたはユーザー アカウント] で、ターゲット グループとオプションのサブグループを入力します。
- [クライアント設定] で、作成した OAuth 2.0 統合を選択します。1 つしかない場合は、自動的に選択されます。
- [追加] を選択します。
次のステップ
アカウントを追加すると、結果は次のようになります。
リポジトリの同期: ページに表示されるアカウントを自動的にリンクする場合は、Jira によってそのリポジトリの同期が開始されます。詳細については、「開発ツールの統合」を参照してください。
問題の照合: コミットとプル リクエストに課題キーが含まれている場合、Jira はそれらを見つけて関連する情報を課題に追加します。詳細は、「開発作業から課題を参照する」でご確認ください。
開発情報の表示: 正しく参照された場合、開発情報はあなたの課題に追加されて、関係するすべての人により多くのコンテキストを提供します。詳細については、「課題に対する開発情報の表示」を参照してください。
ワークフロー トリガー: 開発ツールを統合するメリットの 1 つは、ワークフロー トリガーを追加することです。たとえば、新しいブランチを作成した後に課題ステータスを変更できます。詳細については、「ワークフロー トリガーの構成」を参照してください。