j2lab

Jira to GitLab Migrator

Introduction

j2lab is an open-source project designed to facilitate the seamless migration of projects from Jira to GitLab. j2lab aims to provide a one-stop solution for teams looking to transition their project management tools without losing crucial data.

Motivation

As of February 2, 2021, Atlassian has ceased selling new server licenses and has announced that they will terminate official support for server licenses in 2024. This change has significant repercussions for organizations that rely on server-based solutions, pushing them to seek alternatives. Faced with the uncertainty brought about by Atlassian's policy change, we have identified GitLab as a robust alternative that offers similar, if not better, functionalities compared to Jira.

Configuration

config.yaml

This YAML file houses the configuration for GitLab and Jira connections, as well as project-related settings. YAML files use a human-readable data serialization standard, making them convenient for configuration files.

Structure

1. jira

   • host: The URL of your Jira instance
   • name: The name of the Jira project.
   • jql: Jira Query Language expression for issue filtering.
   • custom_field: Custom fields like story_point and epic_start_date.

2. gitlab

   • host: The URL of the GitLab instance you're working with.
   • issue: Path to the GitLab project where issues will be migrated.
   • epic: Path to the GitLab project where epics will be migrated.

# Example config.yamljira:
host: https://jira.sbx.infograb.ioname: SSP# jql: id = SSP-1029 OR id = SSP-1 jql: ID = SSP-25custom_field:
story_point: customfield_10035epic_start_date: customfield_10015parent_epic: customfield_10110gitlab:
host: https://gitlab.comissue: infograb/team/devops/toy/gos/poc/jeffepic: infograb/team/devops/toy/gos/poc
...

user.csv

This CSV file contains the mapping of Jira username to GitLab accounts. CSV files are excellent for tabular data and are widely supported.

Columns

1. Jira Account ID: The unique identifier for a Jira account.
2. Jira Display Name: The display name in Jira.
3. GitLab User ID: The unique identifier for a GitLab account.

# Example user.csvJira User Name,GitLab User IDjeff,1341Dexter,2155kane,334admin,115
...

Installation

Homebrew (macOS)

brew tap infograb/j2lab
brew install j2lab

Executable Files (For other platforms)

You can also download the pre-built binaries for your specific platform from the Releases page.

Usage

Usage:
j2lab [flags]
j2lab [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
config Modify config files
help Help about any command
run Run the application
version Print the client and server version information
Flags:
-c, --config string config.yaml file
-d, --debug debug mode
-h, --help helpfor j2lab
-u, --user string user.csv file
Use "j2lab [command] --help"for more information about a command.

example

export GITLAB_TOKEN=your_gitlab_token
export JIRA_TOKEN=your_jira_token
j2lab run -c config.yaml -u user.csv

Contribution

If you're interested in contributing, please refer to the Contributing Guide before submitting a pull request.

Support

For any inquiries or additional questions, please reach out to InfoGrab via email or GitLab/GitHub messages.

License

This project is licensed under the GNU License - see the LICENSE file for details.