Script for importing Mantis issues into (a new project in) GitLab. The created GitLab issues will have the same issue numbers are the corresponding Mantis issues. Please do not use this script against a GitLab project that has GitLab issue.
The script performs the following:
- Reads configuration file and Mantis issues export
- Fetches GitLab Project and Members
- Fetches existing issues from GitLab Project
- For each Mantis Issue
- If a corresponding GitLab issue exists, its Title, Description, Labels and Closed status are updated
- Otherwise
- A new GitLab issue is created with an appropriate Title, Description, Labels and Closed status
- All issue notes/comments imported from Mantis are replaced (removed and created again)
Unfortunately you have to download the program m2gl.js
install the requirements and execute it via npm.
npm install
npm m2gl
m2gl -i options
-i, --input CSV file exported from Mantis (Example: issues.csv) [required]
-c, --config Configuration file (Example: config.json) [required]
-g, --gitlaburl GitLab URL hostname (Example: https://gitlab.com) [required]
-p, --project GitLab project name including namespace (Example: mycorp/myproj) [required]
-t, --token An admin user's private token (Example: a2r33oczFyQzq53t23Vj) [required]
-s, --sudo The username performing the import (Example: bob) [required]
-f, --from The first issue # to import (Example: 123)
-n, --dryRun (experimental) Just show migration steps, no write operations
-v, --verbose Output signifigant more log messages about executed steps
In order to correctly map Mantis attributes you must create a JSON file and specify it with the -c switch (see mantis2gitlab.config.json).
This section maps Mantis username
(Reporter, Assigned To, etc.) to a corresponding GitLab user name.
{
"users": {
"mantisUserName1": {
"gl_username": "GitLabUserName1"
},
"mantisUserName2": {
"gl_username": "GitLabUserName2"
}
}
}
This setting defines the URL to the old mantis installation. When specified, Mantis cases imported in GitLab will contain a back-link to their corresponding Mantis issue.
{
"mantisUrl": "https://www.oldserver.com/mantis"
}
This section maps Mantis Category-ids to corresponding GitLab labels.
{
"category_labels": {
"1": "area:Admin",
"2": "area:Voter",
"5": "area:Service"
}
}
This section maps Mantis Priorities to corresponding GitLab labels. Note that the numeric priorities are used when exporting from SQL.
{
"priority_labels": {
"20": "priority:low",
"low": "priority:low",
"40": "priority:high",
"high": "priority:high",
"50": "priority:urgent",
"urgent": "priority:urgent",
"60": "priority:immediate",
"immediate": "priority:immediate"
}
}
This section maps Mantis Severities to corresponding GitLab labels. Note that the numeric severities are used when exporting from SQL.
{
"severity_labels": {
"10": "severity:feature",
"feature": "severity:feature",
"20": "severity:trivial",
"trivial": "severity:trivial",
"30": "severity:text",
"text": "severity:text",
"40": "severity:tweak",
"tweak": "severity:tweak",
"50": "severity:minor",
"minor": "severity:minor",
"60": "severity:major",
"major": "severity:major",
"70": "severity:crash",
"crash": "severity:crash",
"80": "severity:block",
"block": "severity:block"
}
}
This section maps which Mantis Statuses indicate that the issue is closed. Note that the numeric severities are used when exporting from SQL.
{
"closed_statuses": {
"80": true,
"resolved": true,
"90": true,
"closed": true
}
}
This section maps which Mantis project version should be mapped to according GitLab milestone-id.
"version_milestones": {
"MantisNameOfVersion v1": 1,
"MantisNameOfVersion 1.1": 2,
"MantisNameOfVersion 2.0": 5
}
The input to this script is a CSV file with the following columns:
Id
- Will create a corresponding GitLab IssueSummary
- Will create a corresponding GitLab TitleCategory
- Will create a corresponding GitLab Label fromconfig.category_labels[Category]
Priority
- Will create a corresponding GitLab Label fromconfig.priority_labels[Priority]
Severity
- Will create a corresponding GitLab Label fromconfig.severity_labels[Severity]
Created
- Will be included in the Description headerUpdated
- Will be included in the Description header, if different fromCreated
TargetVersion
- Will assign ticket to corresponding GitLab milestone (see Config)Reporter
- Will be included in the Description headerAssigned To
- Will be included in the Description headerDescription
- Will be included in the DescriptionInfo
- Will be appended the DescriptionNotes
- Will be split on"$$$$"
and attached as GitLab issue comments
You can export a summary of the Mantis issues from the View Issues page by clicking on the Export CSV button.
Note: This export will only include a subset of the issues, will lack the issue notes, and is definitely not the recommended approach.
Recommend: The following SQL query pulls all the supported columns from the Mantis database. Make sure you specify the
correct PROJECT_NAME
:
SELECT
bug.id as Id,
project.name as Project,
bug.category_id as CategoryId,
bug.summary as Summary,
bug.priority as Priority,
bug.severity as Severity,
bug.status as Status,
FROM_UNIXTIME(bug.date_submitted, '%Y-%m-%dT%TZ') as Created,
bug.date_submitted as CreatedTimestamp,
FROM_UNIXTIME(bug.last_updated, '%Y-%m-%dT%TZ') as Updated,
bug.last_updated as UpdatedTimestamp,
bug.target_version as TargetVersion,
bug.fixed_in_version as FixedInVersion,
reporter.username as Reporter,
handler.username as "Assigned To",
bug_text.description as Description,
bug_text.additional_information as Info,
GROUP_CONCAT(
CONCAT(FROM_UNIXTIME(bugnote.date_submitted, '%Y-%m-%dT%TZ'), '][', note_reporter.username, '][', bugnote_text.note)
ORDER BY bugnote.Id SEPARATOR '$$$$'
) as Notes
FROM
mantis_bug_table as bug
JOIN mantis_project_table project ON bug.project_id = project.id
JOIN mantis_bug_text_table bug_text ON bug.bug_text_id = bug_text.id
JOIN mantis_user_table as reporter ON bug.reporter_id = reporter.id
LEFT OUTER JOIN mantis_user_table as handler ON bug.handler_id = handler.id
LEFT OUTER JOIN mantis_bugnote_table as bugnote ON bugnote.bug_id = bug.id
LEFT OUTER JOIN mantis_bugnote_text_table as bugnote_text ON bugnote.bugnote_text_id = bugnote_text.id
LEFT OUTER JOIN mantis_user_table as note_reporter ON bugnote.reporter_id = note_reporter.id
WHERE
project.name = 'PROJECT_NAME'
GROUP BY bug.id
ORDER BY bug.id;
- Make sure the input CSV file only includes issues for the project you want to import.
- CSV file with delimiter=, and escape="
- You should use
--verbose
parameter when using--dryRun
- 1.0
- Initial release
- 2.0
- Update node-libraries
- Update syntax
- Add dry-run and verbose mode
- Adapt to GitLab API v4
Frithjof Gnas
Stepan Riha
Based on https://github.com/nonplus/mantis2gitlab which is based on https://github.com/soheilpro/youtrack2gitlab
Copyright 2024 Frithjof Gnas
Licensed under the The MIT License (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
http://www.opensource.org/licenses/mit-license.php
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.