| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
user:zeman:eman [2013/01/21 14:37]
zeman Slití větví. |
user:zeman:eman [2013/01/23 15:39] (current)
zeman harvest.pl |
| ====== Eman ====== | ====== Eman ====== |
| |
| Ondrův e-mail z 4.2.2011: | ===== Instalace ===== |
| |
| musim se pochlubit, ze (az na jeste par much) mam ukazku pouziti emana pro preklad i pro ty, kdo to jeste vubec nezkouseli: | <code bash>git clone https://daniel.zeman@redmine.ms.mff.cuni.cz/eman.git eman |
| | git clone https://daniel.zeman@redmine.ms.mff.cuni.cz/ufal-smt-playground.git statmt |
| | export PATH=$PATH:`pwd`/eman/bin |
| | cd statmt/playground</code> |
| | |
| | Mělo by to jít vybalit i bez toho uživatelského jména (''daniel.zeman@'' apod., vyžaduje samozřejmě heslo), ale bude to pak bez práva ukládat změny zpět na server pomocí ''git push''. |
| | |
| | Příkaz ''<nowiki>eman --man</nowiki>'' ukáže příručku s nápovědou. |
| | |
| | Ondrův příklad pro rychlý start (říjen 2012): |
| | <code bash>eman clone (--dry-run) < eman.samples/cs-en-mini.traceback</code> |
| | |
| | ==== Archiv ==== |
| | |
| | Eman z SVN dle Ondrova e-mailu z 4.2.2011: |
| |
| <code bash>svn co https://svn.ms.mff.cuni.cz/svn/statmt/trunk statmt | <code bash>svn co https://svn.ms.mff.cuni.cz/svn/statmt/trunk statmt |
| SKIP_IRSTLM=yes eman clone --start < eman.samples/cs-en-mini.traceback</code> | SKIP_IRSTLM=yes eman clone --start < eman.samples/cs-en-mini.traceback</code> |
| |
| Prikaz: | [[Přechod z SVN/Trac na Git/Redmine]] (podzim 2012) |
| | |
| eman --man | |
| | |
| ukaze manualovou stranku | |
| |
| ===== Tvorba šablon (nové druhy kroků, seeds) ===== | ===== Tvorba šablon (nové druhy kroků, seeds) ===== |
| V současnosti je k dispozici několik různých šablon pro vyhodnocení výsledků překladu na testovacích datech. Šablona ''eval'' pouští Ondrův program ''testbleu'', šablona ''evaluator'' pouští vyhodnocovací program Mosese upravený Matoušem Macháčkem, který umí několik různých metrik včetně BLEU, šablona ''daneval'' spolupracuje s Joshuou. | V současnosti je k dispozici několik různých šablon pro vyhodnocení výsledků překladu na testovacích datech. Šablona ''eval'' pouští Ondrův program ''testbleu'', šablona ''evaluator'' pouští vyhodnocovací program Mosese upravený Matoušem Macháčkem, který umí několik různých metrik včetně BLEU, šablona ''daneval'' spolupracuje s Joshuou. |
| |
| Eman umí projít všechny kroky s výsledky a spojit je v jednom výstupu. K tomu slouží příkaz **''eman collect''**, který na základě ''eman.results.conf'' vyrobí ''eman.results''. Ukázkový a funkční konfigurační soubor je ''eman.results.conf.sample-wmt12''. Výstup ''eman.results'' lze pak ještě dále vylepšit pomocí ''make bleu'' (make bleu vlastně ten collect samo volá). | Eman umí projít všechny kroky s výsledky a spojit je v jednom výstupu. K tomu slouží příkaz **''eman collect''**, který na základě ''eman.results.conf'' vyrobí ''eman.results''. Ukázkový a funkční konfigurační soubor je ''eman.results.conf.sample''. Já používám jako obálku skript **''harvest.pl > harvest.txt''**, který výsledky zformátuje tak, jak chci (seskupí podle jazykových párů a seřadí podle skóre). |
| | |
| (Podle Ondřeje make bleu ještě možná závisí na skriptu ./sitename, který je tam pro konsolidaci výsledků z mnoha hřišť.) | |
| |
| ===== Kombinace dvou a více hřišť ===== | ===== Kombinace dvou a více hřišť ===== |
| |
| Jestliže stěhujete kroky, které jsou ve stavu FAILED, na novém hřišti je pravděpodobně nebudete moci spustit pomocí ''eman continue'', protože jejich ''eman.command'' (který už se znova nepřegeneruje) nejspíš obsahuje cesty na staré hřiště (a např. když zavoláte corpman starého hřiště, bude vám hledat korpusy tam, ne tady). Můžete ale použít ''eman redo --start'', čímž se na novém hřišti vytvoří kopie kroku s novým ''eman.command'', bez přegenerování všech kroků, na kterých krok závisí. | Jestliže stěhujete kroky, které jsou ve stavu FAILED, na novém hřišti je pravděpodobně nebudete moci spustit pomocí ''eman continue'', protože jejich ''eman.command'' (který už se znova nepřegeneruje) nejspíš obsahuje cesty na staré hřiště (a např. když zavoláte corpman starého hřiště, bude vám hledat korpusy tam, ne tady). Můžete ale použít ''eman redo --start'', čímž se na novém hřišti vytvoří kopie kroku s novým ''eman.command'', bez přegenerování všech kroků, na kterých krok závisí. |
| |
| ===== Přechod na nové úložiště Redmine/git ===== | |
| |
| ÚFALí server Redmine je na adrese https://redmine.ms.mff.cuni.cz/projects. Ondra na něj v říjnu 2012 přestěhoval podstatnou část repozitáře StatMT z svn/trac (https://svn.ms.mff.cuni.cz/trac/statmt). Konkrétně jsou tu teď projekty [[https://redmine.ms.mff.cuni.cz/projects/ufal-smt-playground|ufal-smt-playground]] a [[https://redmine.ms.mff.cuni.cz/projects/eman|eman]] (na něj se z playgroundu odkazuje jako na podmodul). | |
| |
| Pro vybalení hřiště Ondra doporučil studentům následující příkaz. Předpokládám, že studenti, neznajíce Ondrovo heslo, to museli volat bez toho ''ondrej.bojar@'' na začátku a získali nějaký read-only přístup. A já na rozdíl od nich můžu použít daniel.zeman a získám přístup i pro zápis. | |
| |
| <code bash>git clone https://ondrej.bojar@redmine.ms.mff.cuni.cz/ufal-smt-playground.git jmeno_pracovni_kopie | |
| # Raději pracovat na 64bitovém stroji kvůli kompilacím. | |
| ssh sol12 | |
| cd /net/cluster/TMP/zeman | |
| git clone https://daniel.zeman@redmine.ms.mff.cuni.cz/ufal-smt-playground.git redplayground</code> | |
| |
| Eman jako podmodul se asi neaktualizuje sám. Nějakou verzi k nějakému datu zřejmě získám automaticky s hřištěm, ale pokud chci mít jistotu, že budu mít ten aktuální, můžu/měl bych? udělat | |
| |
| <code bash>cd redplayground | |
| git submodule init | |
| git submodule update</code> | |
| |
| Další Ondrova doporučení (ale to druhé, vizualizace commitů, bude asi fungovat jen v ixech): | |
| |
| <code bash>git svn crashcourse | |
| gitk -a</code> | |
| |
| Dokumentace ke gitu je například [[http://git-scm.com/documentation|tady]]. | |
| |
| * ''git clone <url>'' ... naklonovat existující repozitář (dělá se na začátku podobně jako ''svn checkout'', ale sémantika není stejná) | |
| * ''git status'' ... v jakém stavu jsou jednotlivé soubory? (untracked / committed / modified / staged) | |
| * ''git add <file>'' ... zkopírovat změněný soubor do staging oblasti nebo zahrnout do verzování dosud neverzovaný soubor (rovnou se dostane do staging oblasti) | |
| * ''git reset HEAD <file>'' ... vyřadit soubor ze staging oblasti | |
| * ''git checkout -- <file>'' ... zapomenout změny v pracovní kopii a vrátit se k verzi souboru uložené v repozitáři | |
| * ''git commit -m 'log<nowiki>'</nowiki>'' ... uložit soubory ze staging oblasti do (lokálního!) repozitáře; na vzdálený server to pořád nemá vliv | |
| * ''git commit -a'' ... přeskočit stageování a uložit i soubory, které už sledujeme, změnily se, ale nejsou ve staging oblasti | |
| * ''.gitignore'' ... soubor se jmény či šablonami jmen souborů, které se nemají verzovat a nemají se ani hlásit jako neverzované | |
| * ''git diff'' ... co jsem změnil, ale ještě nezkopíroval do staging oblasti | |
| * ''git diff --cached'' ... co jsem změnil a zkopíroval do staging oblasti | |
| * ''git log'' ... historie uložených verzí | |
| * ''gitk'' ... grafický program, který vizualizuje výstup ''git log'' | |
| * ''git rm <file>'' ... odstranit soubor z pracovní složky a říct gitu, že ho má přestat sledovat | |
| * ''git rm --cached <file>'' ... přestat sledovat soubor, ale jeho kopii v pracovní složce ponechat | |
| * ''git mv <file1> <file2>'' ... přejmenovat nebo přesunout soubor | |
| * ''git remote -v'' ... zobrazit názvy nakonfigurovaných vzdálených repozitářů včetně jejich URL. "origin" je ten, ze kterého jsme se naklonovali. | |
| * ''git remote add <shortname> <url>'' ... přidat vzdálený repozitář, se kterým se můžeme synchronizovat | |
| * ''git fetch origin'' ... stáhnout nové změny ze vzdáleného repozitáře origin. Stáhnou se jako nová větev a neslijí se s mou aktuální větví, dokud to neudělám ručně. | |
| * ''git pull origin'' ... stáhnout nové změny a pokusit se je automaticky slít s mými. Musíme mít nakonfigurováno automatické sledování vzdálené větve. Ale u originu to tak defaultně je. | |
| * ''git push origin master'' ... odeslat změny v mé hlavní (master) větvi zpět na server, ze kterého jsem se naklonoval (origin) | |
| * ''git remote show origin'' ... zobrazit informace o stavu vzdáleného repozitáře ve vztahu ke mně | |
| * ''git branch testing'' ... vytvořit novou větev testing (rozvětvení bude na aktuálním commitu), ale zatím do ní nepřepínat (na aktuální větev ukazuje ukazatel HEAD) | |
| * ''git checkout testing'' ... přepnout se do existující větve testing a vybalit její soubory do pracovní složky | |
| * ''git checkout -b testing'' ... zkratka: vytvořit novou větev a hned se do ní přepnout | |
| * ''git checkout -b testing dfcb57a2'' ... vrátit se k revizi (commitu) s kódem ''dfcb57a2'', na něm vytvořit novou větev ''testing'' a hned se do ní přepnout. Při návratu k revizi, která současně není na konci nějaké větve, se doporučuje založit novou větev, aby HEAD vždy ukazovalo na větev a ne na pouhou revizi. Předchází se tím případným problémům, ke kterým může dojít, jestliže nad touto revizí provedeme nové změny: fakticky by vznikla nová větev, ta by ale neměla název a systém by mohl usoudit, že ji smaže, protože není potřeba. | |
| * ''git merge testing'' ... slít větev testing s mou aktuální větví | |
| * ''git branch -d testing'' ... zrušit větev, kterou už nepotřebujeme, protože jsme ji slili s jinou | |
| * ''git checkout -b serverfix origin/serverfix'' ... založit větev serverfix na základě nové větve, kterou jsme získali fetchem ze serveru origin, a přepnout se do ní. Současně tím vzniká vztah mezi novou lokální a vzdálenou větví. Tento vztah se vezme v potaz při synchronizaci pomocí push a pull. | |
| * ''git push origin :serverfix'' ... smazat větev serverfix na serveru origin ("na mé straně před dvojtečkou vezmi nic a udělej z toho aktuální stav větve serverfix na straně serveru") | |
| * ''git rebase <basebranch> <topicbranch>'' ... práce se záplatami (patches) je jiný způsob, jak slít dvě větve. Výsledek je stejný, ale historie je přímější, samostatná větev v ní nebude vidět. Rebase přehraje na větvi base změny provedené ve větvi topic. ALE: Nemají se rebaseovat commity, které už jsme odeslali do veřejného repozitáře. Rebasing vyrábí nové commity, které mají stejný obsah, ale nejsou stejné. Pokud spolupracuji s někým jiným, kdo měl v ruce ty předchozí, nyní zavržené commity, vznikne binec, který budeme obtížně dávat dohromady. | |
| |
| ===== Strategie přechodu ===== | |
| |
| * Získat stav ve chvíli, kdy Ondřej stěhoval hřiště pod git. Čili vybalit nějaký historický stav gitu. Této verzi bude odpovídat nějaký historický stav mého svn. | |
| * Vyrobit si větev dansvn (v gitu) a nějak do ní promítnout aktuální stav v mém svn. | |
| * Přepnout se do Ondřejovy (hlavní) větve a vybalit (pull) její aktuální stav (HEAD). | |
| * Teď už teoreticky kdykoli můžeme obě větve opět slít. ALE! | |
| * Já ještě potřebuju zařídit, aby moje pracovní kopie svn začala být pracovní kopií větve dansvn v gitu, aniž bych musel její obsah kopírovat (jsou tam ty obří neverzované hardlinky, které by se kopírováním rozpojily a zabíralo by to ještě více místa). | |
| * Mějme dvě složky: gitplayground a svnplayground. Obě jsou pracovní kopií téže verze hřiště, ale jedna je navázaná na tuto verzi v gitu a druhá na odpovídající verzi v svn. Složka gitplayground kromě toho obsahuje už jen případné pomocné soubory gitu a nic jiného. Složka svnplayground obsahuje pomocné soubory svn a navíc neverzované podsložky-bumbrlíčky. | |
| * Neverzované bumbrlíčky nechceme stěhovat, ty musí zůstat na místě. Proto musíme kolem nich uklidit, aby se k nim mohl nastěhovat git. Odstraníme všechny verzované podsložky svnplayground, všechny verzované soubory a složku ''.svn'' s pomocnými soubory svn. | |
| * Veškerý obsah složky gitplayground, včetně pomocných souborů git, rekurzivně zkopírujeme do složky svnplayground vedle neverzovaných bumbrlíčků. | |
| * Ověříme, zda tato kopie funguje a ví, že je pracovní kopií repozitáře git. | |
| * Přejmenujeme tuto kopii na ''playground''. Složku ''gitplayground'' můžeme smazat. | |
| |
| <code bash># Zkusit si, zda lze repozitář git jen tak kopírovat a on nadále funguje. | |
| ssh sol12 | |
| cd /net/cluster/TMP/zeman | |
| cp -R redplayground gitplayground | |
| cd gitplayground | |
| # Sesynchronizovat můj git. Tím dostanu všechny revize až do současnosti. | |
| git pull origin | |
| # Vrátit se mezi commity přenesené z svn k poslednímu mému. | |
| # Označit to jako novou větev dansvn. | |
| git checkout -b dansvn dfcb57a2 | |
| # Někde vedle si vyrobit čistý checkout nejnovější verze v svn, bez těch neverzovaných bumbrlíčků. | |
| cd .. | |
| svn --username zeman checkout https://svn.ms.mff.cuni.cz/svn/statmt/trunk cleansvnplayground | |
| # Zkopírovat poslední verze souborů v relevantních složkách z svn do gitu. | |
| cd cleansvnplayground | |
| cp -R playground ../gitplayground | |
| cp -R scripts ../gitplayground | |
| cp -R src ../gitplayground | |
| cd ../gitplayground | |
| # Odstranit pomocné složky .svn ze všech složek ve zkopírovaném stromu. | |
| find -type d -regex '.*\.svn' -print -exec rm -rf '{}' \; | |
| # Podívat se, které soubory se změnily a které mám teď navíc. | |
| # Těch navíc se Ondřej při stěhování zbavil a já je chci nejspíš taky ručně smazat. | |
| # Výjimkou jsou soubory, které jsem si do svn přidal sám a chci je zachovat. Ty nemazat, svezou se s git add. | |
| git status | |
| rm ... | |
| # Označit všechny změny v existujících souborech v svn, + případně přidané nesmazané soubory, ke commitu. | |
| git add . | |
| # Zapamatovat si změny a uložit je v místním repozitáři. | |
| git commit -m 'Danovy změny v svn po odštěpení git verze.' | |
| # Vyrobit protějšek nové větve i na serveru. | |
| git push origin dansvn | |
| # Slít změny z obou větví. Součástí musí být vyřešení konfliktů. | |
| # V tomto případě byl navíc soubor scripts/eman vyčleněn do samostatného repozitáře git, to ošetřil Aleš. | |
| # Po vyřešení konfliktů promítnout změnu na server. | |
| git checkout master | |
| git merge dansvn | |
| git push origin master | |
| # Po slití už větev dansvn nepotřebujeme, smazat u nás i na serveru. | |
| # (Neměníme tím rozvětvenou historii, pouze zapomínáme pojmenovanou záložku, která do ní ukazuje.) | |
| git branch -d dansvn | |
| git push origin :dansvn | |
| </code> | |
| |
