diff --git a/docs/initiatives.rst b/docs/initiatives.rst index 9ab1151..5da0778 100644 --- a/docs/initiatives.rst +++ b/docs/initiatives.rst @@ -9,6 +9,8 @@ Drafts .. toctree:: :maxdepth: 1 + pagure2gitlab/index + Completed review ---------------- .. toctree:: diff --git a/docs/pagure2gitlab/current_situation.rst b/docs/pagure2gitlab/current_situation.rst new file mode 100644 index 0000000..454a9ef --- /dev/null +++ b/docs/pagure2gitlab/current_situation.rst @@ -0,0 +1,7 @@ +.. _current_situation: + +Current situation +================= + +This document describes investigation of what could be done with current state of GitLab API +and Pagure API for purpose of the migration tool. diff --git a/docs/pagure2gitlab/index.rst b/docs/pagure2gitlab/index.rst new file mode 100644 index 0000000..c81eaf7 --- /dev/null +++ b/docs/pagure2gitlab/index.rst @@ -0,0 +1,67 @@ +Pagure to Gitlab Importer +========================= + +Purpose +------- + +With Fedora and CentOS now having an official namespace on GitLab multiple projects wants to +migrate their repositories from `Pagure `_ to `GitLab `_. +This initiative is aimed to provide an easy way to migrate those projects. + +Resources +--------- + +* Initiative proposal: https://pagure.io/cpe/initiatives-proposal/issue/25 +* Pagure documentation: https://pagure.io/docs/pagure/ +* GitLab documentation: https://docs.gitlab.com/ + +Requirements +------------ + +* Self-service tool +* Git commit history preservation +* Ability to migrate pagure issues +* Ability to migrate pull-requests +* Command line interface +* Ability to migrate files uploaded to PRs and issues +* Mapping of Fedora identity to GitLab users +* Tool should be usable by both CentOS and Fedora users +* Ability to access the correct namespace on GitLab + + +Nice to have +------------ + +List of features that would be nice to have. + +* Web interface +* Syncing the FAS usernames to GitLab as users migrate for already migrated projects + +Investigation +------------- + +Following are the investigations of current situation and what are the possible solutions to +met the requirements. + +.. toctree:: + :maxdepth: 1 + + current_situation + + +Conclusions +----------- + +Conclusion for this initiative... + +Proposed Roadmap +---------------- + +* Step 1 - Investigate Pagure2GitLab +* Step 2 - ??? +* Step 3 - Profit! + +Estimate of work +---------------- + +Estimation of work for this initiative...