Rozdělení Git repositáře na menší kusy

To se dá u git submodulů řešit celkem efektivně. Každý submodul si můžeš checkoutnout na jakoukoliv verzi. Ve výsledku to tedy nebude tak, že aplikace poběží na Nette ve verzi z master větve, ale poběží na checkoutnutém tagu, který označuje příslušný release.

Dá se to řešit pomocí netterobots.txt v adresári libs.

Ano, to dá, jenže to je jenom obcházení problému. Co až tam přibude něco dalšího?

Možná by se mohl netterobots.txt přidat i do distribuce (hlavní adresář)

To už by bylo trochu lepší řešení.

Editoval VeN (22. 9. 2010 16:02)

Oddělení libs/Nette do samotného repozitáře bych také uvítal :)

Vezmu jednoduchý případ, kdy budou existovat tři repositáře.

• nette
• nette-examples
• nette-skeleton

Všechno to jsou oddělené repositáře. V repositáři nette si přidáme dva submoduly se zbylými dvěmi repositáři:

$ git clone https://github.com/nette/nette.git nette
$ cd nette
$ git submodule add https://github.com/nette/nette-examples.git examples
$ git submodule add https://github.com/nette/nette-skeleton.git skeleton
$ git ci -m 'Skeleton a examples jako submoduly.'

Nyní máme v hlavním repositáři nette vytvořeny dva submoduly z repositářů nette-examples a nette-skeleton. V rámci submodulu můžeme pracovat stejně jako v samosteném repositáři. Pokud v něm něco změníme a commitneme, v hlavním repositáři se objeví změna ukazatele na verzi (klasický hash) submodulu. Superrepositář si drží pouze hashe na verze, ve kterých má submoduly.

Pokud bychom chtěli oddělený repositář pouze se třídami a testy, tak bychom vzali současný adresář Nette a adresář tests ze současného repositáře. Z těchto dvou bychom založili repositář nový, který by měl následující strukturu:

nette-core - Nette - Application
           |       - Caching
           |       - ...
           |
           - tests - ...

Lépe by to asi udělat nešlo, testy by měly zůstat u svých tříd. To kazí myšlenku samostatného Nette adresáře s frameworkem, ale nic lepšího mě nenapadá. Tohle jsem trochu nedomyslel. Druhý repositář (nette) by pak zahrnoval zbytek adresářů s tím, že by měl repositář nette-core jako submodul, stejně jak jsem to ukazoval výše. Pouze by musel být vložený opět jako nějaký adresář.

Když se na to tak koukám, tak by možná stačilo vyhodit examples a skeleton do oddělených repositářů a vložit je do nette repositáře jako submoduly, jak jsem ukazoval na začátku. Při vložení nette do aplikací přes submodul by to nenačítalo soubory ze submodulů nette-examples a nette-skeleton dokud by si to člověk nevyžádal, takže by se v aplikacím nemotaly.

Navrhuju aby místo adresáře skeleton v „hlavním repozitáři“ vzniknul repozitář nette-sandbox který by jako modul měl respozitář nette-libs a vice versa…

Celkem by bylo 9 menších repozitářů (nette, nette-examples, nette-extras, nette-libs, nette-sandbox, nette-tests, nette-tools, nette-api a nette-docs)

Detail repozitářů nette a nette-sandbox by mohl být zhruba tentoc:

nette

Hlavní repozitář Nette Framework se skládá z modulů:

• libs/ (repo: nette-libs) – to co je teď v hlavním repo v adresáři Nette
• examples/ (repo: nette-examples) – příklady
• extras/ (repo: nette-extras) – plužiny od továrního týmu ;)
• tests/ (repo: nette-tests) – testy
• tools/ (repo: nette-tools) – nástroje (requirements checker etc.)
• license.txt
• readme.txt

nette-sandbox

Fungující aplikace – pískoviště
Stačí rozbalit a můžeš si hrát. Obsah tak jak je teď ve skeletonu.

• app/
• document_root/
• libs/
  • Nette/ ( -> modul z repozitáře nette-libs)

nette-libs

Nette Framework

• Application/
• Caching/
• …

Obsah repozitářů nette-examples, nette-extras, nette-tests i nette-tools je nasnadě. Obsah nette-api a nette-docs jsem nepromýšlel – doposavat to stejně v gitu není pokud vím…

Takovéto řešení má dvě výhody:

1. Snadné použití pískoviště

Sandbox (nebo chcete-li skeleton) jako takový stačí skutečně rozbalit a je připraven k použití… nic se nemusí nikam kopírovat apod.

Příklad: „Nahození“ nového projektu pomocí sandboxu:

git clone https://github.com/nette/nette-sandbox.git /var/www/<project>

2. Pružný hlavní repozitář

Hlavní repozitář je sestaven z menších repozitářů, které je možné libovolně kombinovat.

Do projektu lze jednoduše přidat jako git submodule pouze repozitář nette-libs.

$ git submodule add https://github.com/nette/nette-libs.git libs/Nette

Dále je možné jednoduše přidělovat oprávnění pro jednotlivé repozitáře.
Například si dovedu představit že do repozitáře s příklady nette-examples by mohlo mít práva víc lidí než do repozitáře nette-libs.

Co myslíte?

Edit: small typos

Editoval pekelnik (29. 9. 2010 15:34)

+1

+1

+1

Jak si tak uklízím v projektu napadá mě skvělé využití submodulu nette-libs v repozitáři dibi… B-)

Já to řeším stahnutím submodulů do libs_all a jejich přilinkování do libs.

Ano, ale jakmile to budeš muset nastavovat na několika produkčních serverech, tak zjistíš, že je to děsně otravné. Chce to mít možnost deployovat aplikaci na pár příkazů, aby člověk nemusel neustále říkat: „Tohle si stáhni támhle a teď ještě tohle sem přilinkuj a pak už ti zbývá jenom tohleto.“

@vrtak: a deployment?

stáhnout, rozbalit, kopírovat? kam dáš tu starší verzi pro případ že nová schodí aplikaci?

@pekelnik: Tak aplikaci mam samozrejme v GITu. jen v tom gitu nemam submodul Nette ale normalne natvrdo soubory. Když nebude OK vrátím se jednoduše na předchozí revizi.

Omyl, link se do gitu uložím, takže se o to potom dál starat nemusím.

Aha, nepředpokládal jsem, že dáváš symlinky do repositáře. Moje chyba :)

Možná jsou to ptákoviny, ale

1. je nějaký důvod, proč repozitáře prefixovat „nette-“
2. proč skeleton nazývat sandbox?

1. ano co když se dobudoucna portfolio Nette Foundation rozšíří?
2. netuším mě se skeleton líbí víc… :-)

Rozdělení je super. Dík. Sandbox a jakákoliv další aplikace teď má ale tohle:

/libs
|---/Nette
    |---/Nette
        |---/Application
	|---/Caching
	|---/…
    |---/tests

Nejlepší by bylo

/libs
|---/Nette
    |---/Application
    |---/Caching
    |---/…

Proč oddělit testy a framework?

• při použití frameworku testuju jenom aplikaci, ne nette
• nechce se mi testy nahrávat produkční server, ale ani se starat o to je smazat/vynechat
• testování se nestane složitější, stačí přidat jeden modul; oproti tomu zbavit se testů, které jsou v modulu s frameworkem, tak snadno nejde

Možnost linkovat podadresáře IMHO nikdo od vývojářů nevymůže. Linus o tom myslím už několikrát mluvil, že to je tak jak to je a jinak to nebude :)

Osobně raději vidím, když budou Nette knihovny dodávané s testy. Sice je uživatelé frameworku nepotřebují, ale fylozoficky IMHO patří do jednoho repositáře.

Submoduly se použít dají, Robot loader si snadno poradí s dvojitým adresářem Nette. Pouze je třeba přidat pár adresářů do netterobots.txt. V naší firmě jsme zatím na lepší způsob nepřišli. Pokud to někdo děláte lépe, velice rád si na toto téma popovídám.

Jinak díky Davide za to rozdělení :)

Kam se ztratila minifikovaná verze? Ta bude teď jen na webu?
(nebo tam nikdy nebyla a já si to jen napamatuji? :D)