Changes between Version 7 and Version 8 of rfc71_github_migration
- Timestamp:
- Apr 6, 2018, 12:59:22 AM (5 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
rfc71_github_migration
v7 v8 9 9 10 10 It is proposed that the GDAL source tree and ticket database moves from 11 the OSGeo hosted Subversion repository/Trac database to GitHub.11 the OSGeo hosted Subversion repository/Trac database to !GitHub. 12 12 Full source code history will be preserved. To make the migration simpler, 13 existing tickets will remain in OSGeo Trac and will not be migrated to GitHub.14 New tickets will have to be opened in GitHub.13 existing tickets will remain in OSGeo Trac and will not be migrated to !GitHub. 14 New tickets will have to be opened in !GitHub. 15 15 16 16 == Motivations == … … 23 23 (or even those with SVN access) to submit their contributions, in particular 24 24 because of the coupling with the continuous integratations services of Travis-CI 25 and AppVeyor that enable maintainers to check that the contribution doesn't25 and !AppVeyor that enable maintainers to check that the contribution doesn't 26 26 introduce known regressions + the friendly way of commenting a pull request. 27 However the manual porting of GitHub pull requests to Trac is a bit painful27 However the manual porting of !GitHub pull requests to Trac is a bit painful 28 28 for GDAL maintainers. 29 3. GitHub has become the de-facto hosting platform for a lot of open-source29 3. !GitHub has become the de-facto hosting platform for a lot of open-source 30 30 projects. 31 31 32 32 == Details of the migration == 33 33 34 0. The existing GitHub git repository will be pushed to34 0. The existing !GitHub git repository will be pushed to 35 35 https://github.com/OSGeo/gdal_svn_mirror_backup (eventually removed once we are 36 36 confident further steps have not messed things up) 37 1. As GitHub also uses the syntax "#1234" to link commit messages to its issues38 that was also used in Trac, currently when following links in GitHub that point to a Trac39 ticket, one ends up to a non-existing or unrelated GitHub issue/pull request.40 So the commit messages of the current GitHub mirror will be rewritten by37 1. As !GitHub also uses the syntax "#1234" to link commit messages to its issues 38 that was also used in Trac, currently when following links in !GitHub that point to a Trac 39 ticket, one ends up to a non-existing or unrelated !GitHub issue/pull request. 40 So the commit messages of the current !GitHub mirror will be rewritten by 41 41 a "git filter-branch --msg-filter 'python rewrite.py' -- --all" command to 42 42 replace "#1234" with "https://trac.osgeo.org/gdal/ticket/1234" … … 49 49 git repository. 50 50 5. The cron job on the OSGeo server that refreshes the website from sources 51 will be modified to pull from GitHub rather than SVN.51 will be modified to pull from !GitHub rather than SVN. 52 52 6. Ticket creation permissions will be removed in Trac. Modification or closing of 53 53 existing open tickets will still be possible. From that point, if closing a 54 54 Trac ticket, one will have manually to reference the github commit. 55 7. The settings of the GDAL GitHub repository will be changed allow tickets to55 7. The settings of the GDAL !GitHub repository will be changed allow tickets to 56 56 be filed. Labels and Milestones will be populated with relevant content 57 57 … … 59 59 other GDAL developers/contributors would be welcome: 60 60 61 * Most visible Trac wiki documentation will have to be revised to point to GitHub61 * Most visible Trac wiki documentation will have to be revised to point to !GitHub 62 62 * HOWTO-RELEASE will have to be revised. 63 63 * Existing SVN committers still interested in the project will have to request 64 commit access to the GitHub repo.64 commit access to the !GitHub repo. 65 65 * Some support from OSGeo SAC will be needed to turn the GDAL SVN repository to 66 66 read-only (a complementary option would be to rename it to gdal_historical so that … … 72 72 == Exit strategy == 73 73 74 GitHub is a closed platform. In case it would close or would start askin to pay74 !GitHub is a closed platform. In case it would close or would start askin to pay 75 75 unreasonable fees, some backup strategy of the tickets would be needed. The 76 76 solutions might be: 77 77 * https://github.com/josegonzalez/python-github-backup 78 * GitLab has an import module fromGitHub.78 * !GitLab has an import module from !GitHub. 79 79 Although some experimentation has been done with those, this RFC does *not* cover 80 80 setting up those solutions as a regular backup system. … … 82 82 == Not covered by this RFC == 83 83 84 * Migration of Trac wiki content to GitHub wiki is not in the scope of this RFC. Can be done later84 * Migration of Trac wiki content to !GitHub wiki is not in the scope of this RFC. Can be done later 85 85 86 86 == Previous related discussions ==