Migrare la GitHub

De la dexonline wiki
Sari la navigare Sari la căutare

În februarie 2014 am migrat de la Subversion la git și GitHub. Aici documentez procesul.

Migrarea de la svn la git, într-un repository local

Vezi https://help.github.com/articles/importing-from-subversion și https://github.com/nirvdrum/svn2git#readme

sudo apt-get install git-core git-svn ruby rubygems
sudo gem install svn2git

Am extras toți autorii care au contribuit vreodată:

svn log --quiet http://voronet.francu.com/repos/DEX | grep -E "r[0-9]+ \| .+ \|" | cut -d'|' -f2 | sed 's/^ //' | sort | uniq

Am creat un fișier cu numele și adresele de e-mail (înțeleg că acesta este formatul Git pentru autori).

alex.grigoras = Alex Grigoraș <alex.grigoras@gmail.com>
alexm = Alex Morega <alex@grep.ro>
alinu = Alin Ungureanu <alyn.cti@gmail.com>
cata = Cătălin Frâncu <cata@francu.com>
cristian.chilipirea = Cristian Chilipirea <cristian.chilipirea@cti.pub.ro>
grigoroiualex = Aleg Grigoroiu <grigoroiualexandru@gmail.com>
guitarMan = Horia <mihaitrifu512@yahoo.com>
mihai17 = Mihai Trifu <mihaitrifu512@yahoo.com>
radu = Radu Borza <raduborza@gmail.com>
root = Cătălin Frâncu <cata@francu.com>
sonia = Sonia Andriu <sonia@andriu.ro>
svn = Cătălin Frâncu <cata@francu.com>
vially = Valentin Hăloiu <vially.ichb@gmail.com>

Am ales versiunea 4 pentru svn2git: The svn repo is NOT in standard layout and has no trunk, branches, or tags at the root level of the repo. Instead the root level of the repo is equivalent to the trunk and there are no tags or branches.

svn2git http://voronet.francu.com/repos/DEX --authors authors.txt --rootistrunk --verbose

Încărcarea acestui repository la GitHub

git remote add origin git@github.com:CatalinFrancu/dexonline.git
git push origin master

Migrarea tichetelor trac la issues pe GitHub

Am experimentat un pic cu trac2github, dar nu merge bine. Pierde diacriticele și dă niște erori. Pare că apelează API-ul GitHub în mod greșit.

Folosim tratihubis. Am exportat tichetele și comentariile în două fișiere csv:

sqlite3 -header -csv /path/to/trac.db < tratihubis-master/query_comments > comments.csv
sqlite3 -header -csv /path/to/trac.db < tratihubis-master/query_tickets.sql > tickets.csv

Am creat fișierul tratihubis.conf care mapează cât de mult se poate din utilizatorii Trac la utilizatori GitHub:

[tratihubis]
user = CatalinFrancu
password = ...
repo = dexonline
tickets = /path/to/tickets.csv
comments = /path/to/comments.csv
users = radu: RaduBorza, radu_borza@yahoo.it: RaduBorza, alex grigoras: alex-grigoras, cristian chilipirea: darkhunterj, grep.ro/openid: mgax, mihaitrifu512: MihaiTrifu, sonia andriu: sandriu, strat.cristian@gmail.com: cgst, sîrbu nicolae-cezar: sarbull, vially: vially, constantin serban-radoi: costash, *: CatalinFrancu

Am testat (dry-run):

python tratihubis.py tratihubis.conf

Am modificat pe alocuri tratihubis.py, căci issue-urile pe GitHub nu conțineau numele corecte.

  • am apelat repo.create_issue(title, body, 'CatalinFrancu') cu numele meu hard-coded ca să previn niște erori de API. Presupun că nu poți crea un bug prin API și să-l asignezi altcuiva
  • am adăugat un % tracUser lipsă: raise _ConfigError(_OPTION_USERS, u'Trac user "%s" must be mapped to a Github user' % tracUser)

Am rulat „pe bune”:

python tratihubis.py --really tratihubis.con

Notă: tichetele 1-178 sunt numerotate identic pe Trac și pe GitHub. Tichetele 179, 180 și 181 lipsesc pe Trac (erau deschise de un spammer și le-am șters la nivel jos, din sqlite). Tichetele 182-... din Trac corespund tichetelor 179-... de pe GitHub (așadar numerele de ordine pe GitHub sunt cu 3 mai mici).

Migrarea clienților DEX și DEX-mobile de pe dexonline.ro

Am testat întâi pe beta.dexonline.ro, după care pe m.dexonline.ro, după care pe dexonline.ro. Redau doar pașii pentru dexonline.ro (site-ul principal).

Am clonat repository-ul într-un director nou:

cd public_html
git clone https://github.com/CatalinFrancu/dexonline DEX-git

Acum era necesar să copiez toate fișierele din vechiul repository care nu erau sub controlul lui Subversion. Le-am listat cu comanda:

cd DEX
svn status --no-ignore | sort

Apoi am mutat fișiere și directoare folosind modul arhivă pentru păstrarea permisiunilor, de exemplu:

sudo cp -vai log/*log ../DEX-git/log/

Pe măsură ce le copiam, le filtram cu grep -v din ieșirea lui svn status, până când am rămas cu o listă goală.

Apoi am redenumit cele două directoare, păstrând vechiul director intact în DEX-svn:

mv DEX DEX-svn; mv DEX-git DEX

Am încărcat pagini pe m.dexonline.ro:8080 și pe dexonline.ro:8080 ca să evit cache-ul Varnish.

Migrarea paginilor wiki

Am migrat, de mână, lista de pagini de la http://trac.dexonline.ro/wiki/TitleIndex (mai puțin cele generate automat de Trac, evident). În general, le-am păstrat numele.

Întrucât exista deja o pagină Despărțirea în silabe, am mutat pagina respectivă de pe Trac în Discuție:Despărțirea în silabe. Cele două (pagina și discuția) sunt foarte asemănătoare. Ar trebui unificate.

Migrarea fișierelor atașate tichetelor

GitHub acceptă doar fișiere de tip imagine. Pe acelea le-am încărcat la fiecare issue separat.

Pentru restul fișierelor, politica lui GitHub este să-ți găsești singur găzduire, apoi să pui legături către ele. Le-am încărcat pe toate aici, la Fișiere atașate în Trac. MediaWiki pare să pună legături roșii, cu intermitență, dar le puteți consulta și la Special:Listă fișiere.

Apoi am pus legături către ele din fiecare issue GitHub.

Pentru a găsi toate tichetele Trac care aveau fișiere atașate, am folosit comanda:

sqlite3 /path/to/trac.db
select distinct id from attachment where type = 'ticket' order by id;

Lucruri de făcut

Etichetează bugurile: newbie, graphic etc.

Link din Informații pentru programatori către lista de tichete newbie (după reetichetarea tichetelor)

Completează secțiunea despre contribuții din Instrucțiuni de instalare.

Regândește pagina principală, care acum trebuie să se adreseze lingviștilor, programatorilor etc.

Redenumește baza de date MySQL din 'lingv' în 'wiki'.

Dă pe blog? S-ar putea să fie de interes prea restrâns pentru asta.