フリー版のGitLabでできる Integration Guide 〜どんどんつなげよう、GitLabの輪〜

1.はじめに
2.はしがき
3.Redmine
本書で扱うRedmine
Redmineのインストール
セットアップ
初期設定
GitLabのマニュアルの確認
GitLab側の設定
実際に使用している様子
GitLabのコミット時に「#2」を指定している様子
本インテグレーションのポイント
ご注意

4.Backlog
本書で扱うBacklog
Backlogの利用開始
ユーザ登録
初期設定
GitLabのマニュアルの確認
GitLab側の設定
GitLabのイシュー機能を非表示
実際に使用している様子
GitLabのコミット時に「キー情報」を指定している様子
本インテグレーションのポイント
ご注意

5.Jira
本書で扱うJiraと2つのユースケース
Jiraの利用開始
ユーザ登録
初期設定
GitLabのマニュアルの確認
ユースケース1. Jira Issue Integration
GitLab側の設定
GitLabのイシュー機能を非表示
実際に使用している様子
GitLabのコミット時に「URL情報」を指定している様子
本インテグレーションJira Issueのポイント
ご注意
ユースケース2. Jira development panel Integration
Jira側の設定
実際に使用している様子

1.はじめに

本書は、GitLabのフリー版をお使いの皆様に、無料で実現できる他社製品とのインテグレーション方法について詳しく説明したものです。

ぜひ実際に手を動かして、セットアップしてみてください。
いずれもプロジェクト単位なので、他のGitLab上のプロジェクトに影響を与えることはありません。

2.はしがき

本書に登場する会社名および商品名は各社の商標または登録商標です。
なお、本書ではⓇ、TM マークを明記しておりません。
本書で前提としている各製品等のバージョンは以下となります。

GitLab.com および GitLab Community Edition/Enterprise Edition Free版 17.10

3.Redmine

本書で扱うRedmine

Redmineとは、https://www.redmine.org/ で提供されている、無料のプロジェクト管理ツールです。非常に人気が高いOSSプロダクトです。

フリー版のGitLabでできる6

引用元: https://www.redmine.org/

2025/04/01時点で、最新のものは、 6.0.4となっています。

フリー版のGitLabでできる26 引用元: https://www.redmine.org/

Redmineのインストール

セットアップ

本書では、Dockerをつかってインストールします。

以下のファイルを作成： docker-compose.yml

version: '3.1'

services:

  redmine:
    image: redmine
    restart: always
    ports:
      - 80:3000
    environment:
      REDMINE_DB_MYSQL: db
      REDMINE_DB_PASSWORD: example
      REDMINE_SECRET_KEY_BASE: supersecretkey

  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: redmine

その後、以下のコマンドでインスタンスを起動します。

sudo docker compose up \-d

初期設定

Redmine側でプロジェクトや、イシューを作成できるよう、トラッカー等の設定をおこないます。一通りセットアップを完了します。

フリー版のGitLabでできる37 引用元: https://www.redmine.org/

仮に以下の内容で準備が完了したとします。

項目	設定値
URL	http://my-redmine.samurai-tanuki.com/
作成したプロジェクト	sample-project-1

GitLabのマニュアルの確認

以下のURLで、GitLabとRedmineの設定方法についてのガイドが記載されています。

Redmine | GitLab Docs

GitLab側の設定

フリー版のGitLabでできる20

項目	設定値
プロジェクトのURL	http://my-redmine.samurai-tanuki.com/projects/sample-project-1
イシューのURL	http://my-redmine.samurai-tanuki.com/issues/:id
新しいイシューのURL	http://my-redmine.samurai-tanuki.com/projects/sample-project-1/issues/new

（*上記では、「新しいイシューのURL」を指定していますが、本機能はもう動作しません。UI上は入力チェック機能が動作するため、なにか適当な文字列を指定すればよいです。プロジェクトのURL、イシューのURLを指定し、「テスト設定」を押下して動作を確認します）

上記の「プロジェクトのURL」は、GitLabのメニューの以下の部分に表示されます。

フリー版のGitLabでできる15

実際に使用している様子

Redmine側で、以下のようにイシューを作成します。

フリー版のGitLabでできる11

引用元: https://www.redmine.org/

フリー版のGitLabでできる12 引用元: https://www.redmine.org/

GitLabのコミット時に「#2」を指定している様子

フリー版のGitLabでできる16

コミットした後、以下のようにリンクが作成されます。

フリー版のGitLabでできる34

上記で「Issue in Redmine」をクリックすると、以下の画面に遷移します。

フリー版のGitLabでできる12 引用元: https://www.redmine.org/

本インテグレーションのポイント

GitLabとRedmineのインテグレーションを実現すると、以下のような内容が実現できます。

Redmine側でイシューを作成
GitLab側でソースコード等へ修正を加え、コミット時に、Redmine側でのチケット番号を指定すると、URLとして保存される
GitLabの画面で、そのチケット番号部分が「URLリンク」になっているため、クリックすればすぐにそのRedmineのチケットURLへ飛ぶことができる

ポイントとして、

GitLab側から、Redmine側へ直接「書き込み」は行わない
あくまでもリンクをつなげることで、GitLab ⇔ Redmine間で手動で行き来する手間と(別のチケットを参照しないように)操作ミスを防ぐ

の2点が価値ポイントとなります。

ご注意

本機能を有効にすると、GitLab側の「イシュー」機能が利用できなくなります。

4.Backlog

本書で扱うBacklog

Backlogとは、株式会社ヌーラボ社から提供されている、製品です。ここでは、GitLabとのインテグレーション方法について解説します。

フリー版のGitLabでできる31 引用元: https://backlog.com/ja/

Backlogの利用開始

ユーザ登録

Backlogの契約がまだで、テスト的に利用したい場合は、Free版が提供されているようなので、それを利用するのものオススメです。