Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
subversion [2008/09/19 14:05] zeman Undoing changes. |
subversion [2013/04/02 09:56] (current) ufal |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Subversion ====== | + | ====== Subversion |
Subversion ('' | Subversion ('' | ||
- | Subversion vám poskytuje různé možnosti, kde založit tzv. **repozitář** (tedy archív verzí vašeho projektu), a různé možnosti, jak k němu přistupovat. **Lokální repozitář** vám stačí, používáte-li Subversion pro archivaci projektu, na kterém pracujete pouze vy, případně i další členové ÚFALu, ale všem vám stačí přistupovat k repozitáři z terminálu či skriptů běžících na linuxových počítačích na ÚFALu. Lokální repozitář je prostě podstrom adresářové struktury na síťových discích (konkrétně v ''/ | + | Subversion vám poskytuje různé možnosti, kde založit tzv. **repozitář** (tedy archív verzí vašeho projektu), a různé možnosti, jak k němu přistupovat. **Lokální repozitář** vám stačí, používáte-li Subversion pro archivaci projektu, na kterém pracujete pouze vy, případně i další členové ÚFALu, ale všem vám stačí přistupovat k repozitáři z terminálu či skriptů běžících na linuxových počítačích na ÚFALu. Lokální repozitář je prostě podstrom adresářové struktury na síťových discích (konkrétně v ''/ |
Pro projekty ÚFALu, na nichž chcete spolupracovat i s lidmi zvenku, (serverové repozitáře) použijte vyhrazený stroj [[internal: | Pro projekty ÚFALu, na nichž chcete spolupracovat i s lidmi zvenku, (serverové repozitáře) použijte vyhrazený stroj [[internal: | ||
- | ===== Subversion Server ===== | + | ===== Subversion/Git Server |
- | Toto je Milanovo e-mailové shrnutí z 26.9.2007. Týká se konfigurace serverových repozitářů na serveru | + | Server '' |
- | Mili kolegove, | + | Co bylo zachováno stejné jako před přestavbou: |
- | po diskusi s Ondrou Bojarem | + | * uživatelské účty a hesla pro ssh přístup do systému |
+ | * uživatelské účty, zavedené pro https autentizaci | ||
+ | * účty | ||
+ | * veškerá data systému Trac a stav repozitářů | ||
- | - nalogujete se na svn.ufal.ms.mff.cuni.cz | + | Co je změněno: |
- | | + | * soubor s účty a hesly pro https autentizaci je nyní: ''/ |
- | - pak se rozhodnete | + | * soubor pro nastavení práv v svn repozitářích je: ''/ |
+ | * staré cesty jsou nalinkovány na novou strukturu: | ||
+ | * ''/ | ||
+ | * ''/ | ||
+ | * ''/ | ||
+ | |||
+ | Co je nové: | ||
+ | * podpora založení repozitáře git | ||
+ | * podpora propojení systému Trac s git repozitářem | ||
+ | * přístup ke git repozitáři přes https a ssh | ||
+ | |||
+ | ===== Založení nového projektu ===== | ||
+ | |||
+ | Podívejme se, co je potřeba si projít a nastavit při konfiguraci nového projektu svn/git: | ||
+ | * přihlásíte se přes ssh na '' | ||
+ | | ||
+ | * pro vytvoření | ||
+ | |||
+ | SVN: / | ||
+ | |||
+ | | ||
+ | |||
+ | Repozitáře se vždy vytvoří i s rozhraním Trac; pokud ho vyloženě nechcete, smažte struktury Tracu: | ||
+ | |||
+ | rm -rf /home/ | ||
+ | |||
+ | Pak se rozhodnete, kterými | ||
==== Konfigurace webového rozhraní SVN (preferováno) ==== | ==== Konfigurace webového rozhraní SVN (preferováno) ==== | ||
Line 23: | Line 52: | ||
< | < | ||
- | Co se tyce svn weboveho rozhrani, | + | Co se tyce svn weboveho rozhrani, modul ma nasledujici |
- | * uzivatele: '' | + | * uzivatele: '' |
- | * jejich opravneni: '' | + | * jejich opravneni: '' |
- | O zbytek se stara webovy modul subversion | + | O zbytek se stara webovy modul subversion. |
- | Konfiguraky jsou globalni, tj. pro vsechny projekty spolecne. | + | Nyní už můžeme |
- | O přidávání uživatelů a hesel viz níže. | + | < |
- | ==== Konfigurace protokolu SVN ==== | + | Konfiguráky jsou globální, tj. pro všechny projekty společné, v& |
+ | |||
+ | === Přidávání vlastních uživatelů pro webové přístupy (SVN, GIT i Trac) === | ||
+ | |||
+ | Vlastni uzivatele pro webove pristupy pridate do centralniho souboru webovych hesel v ''/ | ||
+ | |||
+ | htpasswd -bs / | ||
+ | nebo | ||
+ | htpasswd -s / | ||
+ | # na heslo budete dotázáni, heslo se nezobrazí ani na terminálu | ||
+ | |||
+ | ==== Konfigurace pristupu ke Git repozitari ==== | ||
+ | |||
+ | Ke Git repozitarum je mozne v principu pristupovat dvema zpusoby: | ||
+ | |||
+ | * nahledem pres Gitweb rozhrani: https:// | ||
+ | |||
+ | * git klientem pres https: < | ||
+ | |||
+ | * pres ssh: < | ||
+ | |||
+ | V teto konfiguraci git neumi rozlisovat RO a RW uzivatele (jedine pres ssh a ACL prava). Pri pristupu pres https | ||
+ | je pouzivan autentizacni soubor / | ||
+ | Tuto funkcionalitu castecne doplnuje opt system Gitosis, ale prozatim jsem ho neinstaloval. Komunikace pri jeho pouziti probiha pres ssh, na serveru bezi Gitosis server pod uzivatelem Gitosis a uzivatele jsou rozlisovani diky certifikatum pro ssh, ktere | ||
+ | jsou pro ne po jednom vygenerovany. | ||
+ | |||
+ | ==== Konfigurace protokolu SVN (raději nepoužívat, | ||
Toto rozhraní je užíváno SVN klienty, kteří dostanou repository udanou ve tvaru '' | Toto rozhraní je užíváno SVN klienty, kteří dostanou repository udanou ve tvaru '' | ||
Line 39: | Line 94: | ||
Pristupova prava pro svn protokol se urcuji pro kazdy projekt nezavisle, v adresari conf v dane repository (jak je vytvorena mym skriptem), tj. napr.: | Pristupova prava pro svn protokol se urcuji pro kazdy projekt nezavisle, v adresari conf v dane repository (jak je vytvorena mym skriptem), tj. napr.: | ||
- | vim /home/svn/repos/ | + | vim /home/DATA/svn/ |
- | vim /home/svn/repos/ | + | vim /home/DATA/svn/ |
- | + | Vzory nastaveni pristupu jsou zde: ''/ | |
- | Vzory nastaveni pristupu jsou zde: ''/ | + | |
Pozor - hesla se tu nastavuji jako textove retezce, neni to htaccess! Po siti tedy tecou nekryptovane! | Pozor - hesla se tu nastavuji jako textove retezce, neni to htaccess! Po siti tedy tecou nekryptovane! | ||
Line 49: | Line 103: | ||
==== Konfigurace přístupu k systému Trac ==== | ==== Konfigurace přístupu k systému Trac ==== | ||
- | Trac - pouziva take overovani vuci: | + | Trac poskytuje webové rozhraní k repozitáři a dalším službám kolem správy projektu. Používá tutéž evidenci uživatelů a hesel jako webový ('' |
- | AuthUserFile /home/svn/ | + | |
- | Trac ma navic vlastni system prav. Trac vas rozpozna podle loginu, se kterym jste se prihlasili pri http autentizaci, | + | AuthUserFile / |
+ | |||
+ | Při přístupu k webovému rozhraní | ||
Takto spustíte konfigurační skript pro Trac vašeho projektu: | Takto spustíte konfigurační skript pro Trac vašeho projektu: | ||
- | trac-admin / | + | trac-admin /home/DATA/ |
+ | Chcete-li mít přístup k nastavení Tracu pro tento projekt i přes webové rozhraní Tracu, uvnitř '' | ||
- | ==== Přidávání vlastních uživatelů pro webové přístupy (SVN i Trac) ==== | + | < |
- | Vlastni uzivatele pro webove pristupy pridate do centralniho souboru webovych hesel v '' | + | Ve webovém rozhraní (https://svn.ms.mff.cuni.cz/projects/$PROJEKT) se pak objeví tlačítko //Admin//. V něm ještě klikněte na // |
- | htpasswd -bs /home/svn/users/passwords < | + | **Upozornění: |
- | nebo | + | |
- | | + | === Časté problémy === |
- | # na heslo budete dotázáni, heslo se nezobrazí ani na terminálu | + | |
+ | == V tracu chybí tlačítko Browse Source == | ||
+ | |||
+ | Ověřte, že v souboru '' | ||
+ | |||
+ | == V prohlížení kódu se neukazuje Unicode == | ||
+ | |||
+ | Ověřte, že v souboru ''/ | ||
+ | |||
+ | ==== Přístup k repozitáři z Microsoft Windows ==== | ||
+ | Pracovní kopii projektu můžete mít i ve Windows. Tím se nemá na mysli, že vybalíte kopii pomocí '' | ||
===== Lokální Subversion ===== | ===== Lokální Subversion ===== | ||
Line 117: | Line 183: | ||
Pokud jste si jisti, že pro tento projekt nebudete nikdy potřebovat větve ani otagované verze, můžete pravděpodobně vynechat vytváření podsložek '' | Pokud jste si jisti, že pro tento projekt nebudete nikdy potřebovat větve ani otagované verze, můžete pravděpodobně vynechat vytváření podsložek '' | ||
+ | |||
+ | |||
+ | ===== Přechod z lokálního repozitáře na serverový ===== | ||
+ | |||
+ | Nepamatujete si, kde vlastně leží repozitář vašeho projektu? Nacházíte-li se ve své pracovní kopii projektu, příkazem '' | ||
+ | |||
+ | < | ||
+ | Path: . | ||
+ | URL: file:/// | ||
+ | Repository Root: file:/// | ||
+ | Repository UUID: 9edd2012-306b-417f-90a6-873db92f1308 | ||
+ | Revision: 7 | ||
+ | Node Kind: directory | ||
+ | Schedule: normal | ||
+ | Last Changed Author: zeman | ||
+ | Last Changed Rev: 7 | ||
+ | Last Changed Date: 2009-02-19 10:58:20 +0100 (Thu, 19 Feb 2009)</ | ||
+ | |||
+ | Vzhledem k tomu, že URL ve výše uvedeném hlášení začíná < | ||
+ | |||
+ | < | ||
+ | / | ||
+ | cd / | ||
+ | # Přístup k svn přes protokol svn (nešifrovaně!) | ||
+ | vi authz | ||
+ | vi passwd | ||
+ | # Přístup k svn a tracu přes protokol https | ||
+ | vi / | ||
+ | # Pokud jsem se tam ještě nenašel, můžu své heslo nastavit takto: | ||
+ | htpasswd -s / | ||
+ | # Přístupová práva k svn repozitáři prostřednictvím https (obecně i specificky pro tento projekt) | ||
+ | vi / | ||
+ | # Přístupová práva ke správě projektu v tracu | ||
+ | # Mělo by jít též editovat ve webovém rozhraní | ||
+ | trac-admin / | ||
+ | |||
+ | Serverový projekt a repozitář jsou založené a přístupová práva doufejme správně nastavena. Teď se tedy můžeme pustit do vlastního přenosu dat projektu. Samozřejmě předpokládáme, | ||
+ | |||
+ | < | ||
+ | scp interset.svndump svn.ms.mff.cuni.cz:/ | ||
+ | rm interset.svndump | ||
+ | ssh svn.ms.mff.cuni.cz | ||
+ | svnadmin load / | ||
+ | rm interset.svndump | ||
+ | trac-admin / | ||
+ | # This happens inside trac-admin: resynchronize its history with svn. | ||
+ | Trac [/ | ||
+ | Trac [/ | ||
+ | # Log off svn server, continue on local machine | ||
+ | exit | ||
+ | # Replace the working copy of local project by a working copy of the server project | ||
+ | cd .. | ||
+ | mv interset interset.localwc | ||
+ | svn --username zeman checkout https:// | ||
+ | mv trunk interset | ||
+ | cd interset</ | ||
===== Přechod z CVS pod SVN ===== | ===== Přechod z CVS pod SVN ===== | ||
+ | |||
+ | //(Za kopii poznámek děkuji Edovi Bejčkovi.)// | ||
+ | |||
+ | * [[http:// | ||
+ | * [[http:// | ||
+ | * [[http:// | ||
+ | |||
+ | Existuje pythonovský skript, ktery převod provádí. Je nastavitelné, | ||
+ | nahrání na úfalí SVN server (heslo stejne jako na stroj ufal): | ||
+ | |||
+ | <code bash>$ cp -r / | ||
+ | $ rm vallex-cvs/ | ||
+ | $ rm vallex-cvs/ | ||
+ | $ cvs2svn -s vallex --encoding=cp1250 --encoding=L2 --encoding=utf8 | ||
+ | vallex-cvs/ | tee logfile.txt | ||
+ | $ scp -r vallex bejcek@svn:/ | ||
+ | |||
+ | Danovy poznámky: | ||
+ | |||
+ | Poslední krok s& | ||
+ | |||
+ | < | ||
+ | biblio-cvs/ | tee logfile.txt</ | ||
+ | |||
+ | Potom budu postupovat podobně jako při stěhování lokálního repozitáře SVN na server popsaném výše. | ||
+ | |||
+ | < | ||
+ | rm biblio.svndump | ||
+ | ssh svn.ms.mff.cuni.cz | ||
+ | svnadmin load / | ||
+ | rm biblio.svndump</ | ||
+ | |||
+ | ==== Zastaralý a velmi amatérský návod ==== | ||
Rozmyslete si, zda chcete zachovat pouze aktuální verzi vašeho projektu, nebo i některé starší. Pokud chcete zachovat pouze aktuální verzi, vybalte si ji do nějaké pracovní složky pomocí '' | Rozmyslete si, zda chcete zachovat pouze aktuální verzi vašeho projektu, nebo i některé starší. Pokud chcete zachovat pouze aktuální verzi, vybalte si ji do nějaké pracovní složky pomocí '' | ||
Line 464: | Line 619: | ||
===== Troubleshooting ===== | ===== Troubleshooting ===== | ||
+ | |||
+ | ==== Password for GNOME keyring ==== | ||
+ | |||
+ | I had this issue on my workstation ('' | ||
+ | |||
+ | <code bash> | ||
+ | Password for ' | ||
+ | svn: OPTIONS of ' | ||
+ | |||
+ | First, what is the Gnome keyring? According to [[http:// | ||
+ | |||
+ | Unfortunately, | ||
+ | * set empty password for the keyring | ||
+ | * remove the keyring | ||
+ | * change the setting of Subversion | ||
+ | |||
+ | One on-line forum suggests removing the keyring file. This sounds like a good idea because I do not think I use it otherwise. | ||
+ | |||
+ | <code bash>rm ~/ | ||
+ | |||
+ | This solution worked for me. For the sake of completeness: | ||
+ | |||
+ | <code bash># Edit the file and add the following line in the [Auth] section (uncommented!): | ||
+ | # password-stores = | ||
+ | # Note that the line may already be there, commented, and/or with the value = no. | ||
+ | vim ~/ | ||
+ | |||
+ | ==== Working copy path does not exist in repository ==== | ||
If you get the message: | If you get the message: | ||
Line 493: | Line 676: | ||
Most likely, this is all you will need to look at to do most of your work. Most of this material comes from Section 3.5. | Most likely, this is all you will need to look at to do most of your work. Most of this material comes from Section 3.5. | ||
- |