Skip to content

Commit af40b31

Browse files
committed
extend README for csv-based batch migration
1 parent 688a01d commit af40b31

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

README.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,8 @@ Go to [Settings / Access Tokens](https://gitlab.com/-/profile/personal_access_to
8282

8383
#### gitlab.projectID
8484

85-
Leave it null for the first run of the script. Then the script will show you which projects there are. Can be either string or number.
85+
Leave it null for the first run of the script (leave csvImport.projectMapCsv empty either). Then the script will show you which projects there are. Can be either string or number.
86+
Leave it null if you want to import multiple projects via csv file (set `csvImport` instead).
8687

8788
#### gitlab.listArchivedProjects
8889

@@ -156,6 +157,23 @@ Maps the usernames from gitlab to github. If the assinee of the gitlab issue is
156157

157158
When one renames the project while transfering so that the projects don't loose there links to the mentioned issues.
158159

160+
### csvImport.projectMapCsv
161+
162+
Optional name of CSV file (located in project root) containing multiple projects for migration. If set, it overrules `gitlab.projectId` and `github.repo`.
163+
CSV file must contain the following values: GitLab project ID, GitLab project path, GitHub project path, e.g. 213,gitlab_namespace/gitlab_projectname,github_namespace/github_projectname
164+
165+
### csvImport.gitlabProjectIdColumn
166+
167+
Column in CSV file containing GitLab project ID
168+
169+
### csvImport.gitlabProjectPathColumn
170+
171+
Column in CSV file containing GitLab path
172+
173+
### csvImport.githubProjectPathColumn
174+
175+
Column in CSV file containing GitHub path
176+
159177
### conversion
160178

161179
#### conversion.useLowerCaseLabels

0 commit comments

Comments
 (0)