GitLab アカウントのリンク

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

GitLab と GitLab Enterprise の各アカウントとそれらのリポジトリを Jira にリンクして、課題に表示されるプル リクエストからの開発情報を参照できます。

サポート対象バージョン

サポートされているバージョンのリストは次のとおりです。

Jira バージョンGitLabGitLab self-managed
8.14 以降現行

13.0 以降

はじめる前に: OAuth 2.0 によって Jira と GitLab を統合する

ページに GitLab アカウントを追加する前に、OAuth 2.0 を使用して Jira と GitLab を統合する必要があります。この場合は、Jira が OAuth 2.0 クライアントとして機能する送信リンクを設定します。

このタスクを完了するには、Jira システム管理者である必要があります。

Jira 内

送信リンクを作成するには、次の手順に従います。

  1. 画面右上で [管理] > [アプリ] の順に選択します。

  2. [統合] で、[アプリケーション リンク] を選択します。
  3. [リンクを作成] を選択します。

  4. [外部アプリケーション] > [送信リンク] の順に選択します。

送信リンクを設定するには、次の手順に従います。

  1. サービス プロバイダーで [カスタム] を選択します。

  2. 連携の名前を入力します。

  3. ここではクライアント IDクライアント シークレットについて心配無用です、次のステップで GitLab から入手します。

  4. 次の表に示すように、認証エンドポイントとトークンのエンドポイントを入力します。

    GitLab タイプ認証エンドポイントトークン エンドポイント
    Gitlab.comhttps://gitlab.com/oauth/authorizehttps://gitlab.com/oauth/token
    GitLab self-managed<GITLAB_SELF_MANAGED_URL>/oauth/authorize<GITLAB_SELF_MANAGED_URL>/oauth/token
  5. リダイレクト URL をコピーします。この URL は次のステップの GitLab で使用します。

GitLab での操作

Jira 設定を開いたままにして、GitLab に移動して新しいアプリケーションを作成します。これによって、Jira で使用するアプリケーション ID (Jira のクライアント ID) とシークレット (クライアント シークレット) を取得します。

  1. GitLab で、[ユーザー設定] > [アプリケーション] の順に移動して、新しいアプリを追加します。次のデータを使用します。

    • リダイレクト URI: Jira からコピーした URL を入力します。

    • 機密情報: 有効のままにします。

    • スコープ: [API] を選択します。これは接続を機能させるために必要です。

  2. アプリケーションを作成したら、下の画像のようにアプリケーション ID とアプリケーション シークレットを取得する必要があります。

ここで Jira に戻る

Jira の設定に戻って、不足している情報を入力して統合を完成します。

  1. GitLab のアプリケーション ID をクライアント ID として入力します。

  2. GitLab のアプリケーション シークレットをクライアント シークレットとして入力します。

  3. [スコープ] で [api] を選択します。

  4. リンクを保存します。 

  5. GitLab の承認プロンプトで、[承認] を選択します。


GitLab アカウントをリンクする

先ほど作成した送信リンクを使用して、Jira のアカウント ページで GitLab アカウントをリンクします。

  1. 画面右上で [管理] > [アプリ] の順に選択します。

  2. [統合] で、[DVCS アカウント] を選択します。

  3. [アカウントをリンク] を選択します。

  4. [ホスト] ドロップダウンで [GitLab] または [GitLab Self-Managed] を選択します。

    • [GitLab Self-Managed] の場合は、GitLab ホストの URL を入力します。

    • Gitlab の場合は、ホスト URLhttps://gitlab.com に固定されています。

  5. [チームまたはユーザー アカウント] で、ターゲット グループとオプションのサブグループを入力します。 

    グループとサブグループを入力するための要件
    • グループは groupA/sub-groupA/sub-sub-groupA のように入力する必要があります。 

      設定として一度にアクティブにできるグループは 1 つのみです。以下に例を示します。

      • 既存の統合がすでに groupA を使用している場合は、新しい統合では groupA/sub-groupA を使用できません。

      • 同様に、既存の統合が groupA/sub-groupA を使用している場合は、新しい統合では groupA は使用できません。

    • すべてのスペースはダッシュ (-) に変更する必要があります。たとえば、[My projects] グループは my-projects にする必要があります。これはサブグループにも当てはまります。[My Projects] > [More Projects] は my-projects/more-projects になります。これを正しく行うもう 1 つの方法は、Gitlab でグループにアクセスして、http://gitlab.com/my-projects/more-projects などの URL をコピーすることです

  6. [クライアント設定] で、作成した送信リンクを選択します。GitLab との統合が 1 つしかない場合は、自動で選択されます。

    同じクライアント構成 (送信アプリ リンク) で複数のチームまたはユーザー アカウントをリンクしないでください。Jira にリンクする各 GitLab チームとユーザー アカウントでは、異なるクライアント構成を使用してください。

  7. [追加] を選択します。

次のステップ

アカウントを追加すると、結果は次のようになります。

  • リポジトリの同期: ページに表示されるアカウントを自動的にリンクする場合は、Jira によってそのリポジトリの同期が開始されます。詳細については、「開発ツールの統合」を参照してください。

  • 問題の照合: コミットとプル リクエストに課題キーが含まれている場合、Jira はそれらを見つけて関連する情報を課題に追加します。詳細は、「開発作業から課題を参照する」でご確認ください。

  • 開発情報の表示: 正しく参照された場合、開発情報はあなたの課題に追加されて、関係するすべての人により多くのコンテキストを提供します。詳細については、「課題に対する開発情報の表示」を参照してください。

  • ワークフロー トリガー: 開発ツールを統合するメリットの 1 つは、ワークフロー トリガーを追加することです。たとえば、新しいブランチを作成した後に課題ステータスを変更できます。詳細については、「ワークフロー トリガーの構成」を参照してください。

最終更新日 2023 年 11 月 24 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.