/
利用設定

利用設定

このページでは下記の通り、利用設定に必要な手順を紹介します。

1.GitLab-Jira連携設定の追加

GitLab-Jira連携を使用するプロジェクトのGitLabグループに所属する機械ユーザから、アクセストークンを発行します。

【GitLab上での操作】

「Admin Area」>「Users」>「該当の機械ユーザをクリック」>「Impersonate」をクリックします。

「画面右上のアイコンマーク」>「Settings」をクリックします。

「Access Tokens」から Name・Scopesを入力し、「Create personal access token」をクリックします。

選択するScopeは以下です。

  • api

  • read_repository

  • write_repository

連携時のJiraへの負荷を抑えるため、個人アクセストークンで閲覧範囲を最低限のGitLabプロジェクトに絞ることを推奨いたします。

Gitlab-Jira連携を使用するプロジェクトのGitLabグループに所属する機械ユーザは、
該当のGitLabグループ画面から左側にある「Members」をクリックし、グループ所属ユーザ一覧から確認できます。

 

【Jira上での操作】

Jira管理画面から、GitLab Connector for Jira Softwareに関する設定画面を開きます。

(「アプリケーション」→「GitLab」を選択します)

GitLabサーバを新規登録する場合、サーバ名(任意の論理名)、GitLabサーバURLを入力し、「接続テスト」をクリックしてください。

成功したら、「サーバ追加」をクリックします。

「プロジェクト追加」をクリックし、連携させるJiraプロジェクトを選択します。

適切な閲覧権限が設定されたGitLabアクセストークンを入力し、「保存」をクリックします。

保存が成功すると同期が開始され、ステータスが「有効」になると同期が完了し機能が利用可能となります。

2. GitLab-Jira間の同期

連携されたJiraプロジェクトへGitLabサーバの情報を同期することができます。

アプリケーション画面ページ下部のサーバ一覧で、同期を行うサーバの「アクション」から「今すぐ同期」もしくは「フル同期」をクリックします。

今すぐ「同期」と「フル同期」の違いに関して、詳細はhttps://aslead.atlassian.net/wiki/spaces/GCFJS/pages/575832157 をご覧ください。

3.GitLab-Jira連携設定の削除

連携されたJiraプロジェクトの設定を削除することができます。

アプリケーション画面ページ下部のサーバ一覧で、連携設定を削除するサーバの「アクション」から「削除」をクリックします。

 

4.GitLab-Jira連携設定の無効化/有効化

連携されたJiraプロジェクトの無効化/有効化をコントロールすることができます。

アプリケーション画面ページ下部のサーバ一覧で、有効化もしくは無効化するサーバの「アクション」から「有効」/「無効」をクリックします。

 

5.GitLab-Jira連携設定の編集

アクセストークンの変更や連携するJiraプロジェクトを変更することができます。

アプリケーション画面ページ下部のサーバ一覧で、連携設定を変更するサーバの「アクション」から「編集」をクリックします。

Jiraプロジェクト、アクセストークンを編集し「保存」をクリックします。

 

6.複数サーバの一括設定

1つのGitLabサーバに複数のJiraプロジェクトを連携している場合、「一括アクション」から一括ですべてのJiraプロジェクトに対して

  • 今すぐ同期/フル同期

  • 削除

  • 編集

  • 有効化/無効化

を行うことができます。

7.SonarQube連携設定

SonarQubeとGitLabサーバの連携を設定します。

連携設定を行うサーバの「SonarQube連携設定」ボタンをクリックします。

SonarサーバのURLとアクセストークンを設定し、「保存」します。

設定後、2. GitLab-Jira間の同期 から「フル同期」を実行してください。

その後、SonarQube連携設定欄に「設定済」と表示されることを確認します。