1. Zastosowanie buildout przy
wdrażaniu projektów opartych o
framework Django
Dominik Szopa
http://dominno.pl
PyCon PL 2009
16-18 październik 2009

2. Agenda
• Django - wdrażanie projektów,
• Virtualenv i Buildout,
• Buildout i Django,
• Podsumowanie,
• Przydatne linki.

3. Django - wdrażanie projektów
Każdy projekt składa się z wielu zależności:
• Django,
• Aplikacje zewnętrzne(np. django-tagging),
• Biblioteki(np. docutils, beautyfullsoap).

4. Django - wdrażanie projektów
Zależności mogą być instalowane z wielu źródeł:
• Systemu kontroli wersji,
• Używając setup.py,
• Używając setuptools i easy_install.

5. Django - wdrażanie projektów
Wielokrotna instalacja i konfiguracja na:
• Komputerach developerów,
• Serwerze,
• Wszystkich innych maszynach które mają coś
wspólnego z developmentem.

6. Django - wdrażanie projektów
Złe praktyki:
• Instalacja zależności w systemowym site-packages,
• Umieszczanie projektu wraz z pakietami zależnymi w
katalogach, które nie są zdefiniowane w PYTHONPATH.
Mogą prowadzić w rezultacie do:

8. Rozwiązanie ? Virtualenv i Buildout

9. Co to jest virtualenv ?
• Tworzy odseparowane, $ virtualenv moj_env
niezależne środowisko $ source bin/activate
Pythona, (moj_env) $ cd jakas_biblioteka
• Odizolowuje pakiety (moj_env) $ setup.py install
od systemowego site- (moj_env) $ deactivate
packages.

10. Wady virtualenv
• Nie rozwiązuje problemu ręcznej instalacji pakietów,
• Środowiska nie są przenośne,
• Środowiska nie są portowalne.

11. Co to jest buildout ?
• Automatyzuje instalacje zależności projektu,
• Projekt składa się z poszczególnych składników,
definiowanych w pliku konfiguracyjnym,
• Do konfiguracji oraz instalacji określonego składnika,
używane są rozszerzenia zwane "recipes" (przepisy),
• Każdy składnik zawiera informacje skąd pobrać dane oraz
gdzie je zapisać.

12. Istnieją przepisy które:
• Pobierają pakiety i instalują je w formie eggów,
• Pobierają źródła z systemu kontroli wersji,
• Tworzą symlinki,
• Wykonują polecenia systemowe,
• Pobierają i kompilują pakiety binarne,
• Więcej na http://pypi.python.org, 160+ dostępnych.

13. Buildout - przykład
$ buildout
[buildout]
parts = part1 part2 PyPi moje repo
[part1]
recipe = moj_przepis
[part2]
recipe =
moj_inny_przepis
mój desktop
$ python
>>> import part1
>>> import part2

14. Buildout i Django
Istnieje przepis "djangorecipe" dla Django który:
• pobiera i instaluje Django w wskazanej wersji,
• tworzy skrypt-nakładkę na manage.py w którym są wpisane
ścieżki do wszystkich zainstalowanych zależności przez
Buildout.

15. Buildout i Django - w szczegółach

16. Co będzie potrzebne
• Python,
• virtualenv,
• bootstrap.py z
http://svn.zope.org/*checkout*/zc.buildout/trunk/bootstrap/b
ootstrap.py,
• terminal.

17. Tworzenie środowiska
$ virtualenv moje_srodowisko –-no-site-packages
$ cd moje_srodowisko
$ source bin/activate
(moje_srodowisko)~/moje_srodowisko$

18. Wdrażanie Django z Buildout
$ mkdir app
$ cd app
$ wget
http://svn.zope.org/*checkout*/zc.buildout/trunk/bootstra
p/bootstrap.py
$ touch buildout.cfg

19. Konfiguracja Buildout dla Django
# buildout.cfg
[buildout]
parts = django
[django]
recipe = djangorecipe
version = 1.1

20. Rozruch Buildout'a
$ python bootstrap.py
Creating directory 'moje_srodowisko/app/bin'.
Creating directory 'moje_srodowisko/app/parts'.
Creating directory 'moje_srodowisko/app/eggs'.
Creating directory 'moje_srodowisko/app/develop-eggs'.
Generated script 'moje_srodowisko/app/bin/buildout'.

21. Instalacja Django
$ bin/buildout
Getting distribution for 'djangorecipe'.
Got djangorecipe 0.19.1.
Getting distribution for 'zc.recipe.egg'.
Got zc.recipe.egg 1.2.2.
Installing django.
django: Downloading Django from:
http://www.djangoproject.com/download/1.0/tarball/
Generated script 'moje_srodowisko/app/bin/django'.

22. Uruchomienie aplikacji
• bin/django runserver #!/moje_srodowisko/bin/python
• bin/django syncdb import sys
• itd. sys.path[0:0] = [
'/moje_srodowisko/app/parts/moj_pakiet1',
'/moje_srodowisko/app/parts/moj_pakiet2',
]
import djangorecipe.manage
if __name__ == '__main__':
djangorecipe.manage.main('moj_projekt.settings')

23. Jak wdrożyć swój projekt
# buildout.cfg
[buildout]
parts = django moj_projekt
[django]
recipe = djangorecipe
version = 1.1
settings = settings
projectegg = moj_projekt
.
.
.

24. Jak wdrożyć swój projekt
# buildout.cfg
.
.
eggs =
south
django-registration
extra-paths =
${buildout:parts-directory}
[moj_projekt]
recipe = iw.recipe.subversion
urls =
http://moje_repo.com/trunk/moj_projekt_z_svn/ .

25. Jak wdrożyć swój projekt
$ bin/buildout
.
.
Installing moj_projekt.
A moje_srodowisko/app/parts/moj_projekt/settings.py
.
.
Checked out revision 1.
Creating archive: .-dev.tar.gz

26. mod_wsgi ? fcgi ?
djangorecipe umożliwia generowanie skryptów WSGI oraz FCGI
• opcja: wsgi = true lub,
./bin/django.wsgi
• opcja: fcgi = true.
./bin/django.fcgi

27. Podsumowanie
• Buildout automatyzuje wdrożenia projektu,
• Virtualenv odizolowuje pakiety od systemowego site-
packages,
• djangorecipe umożliwia generowanie skryptów
rozruchowych dla WSGI i FCGI,

28. Przydatne linki
• http://www.buildout.org
• http://pypi.python.org/pypi/zc.buildout
• http://pypi.python.org/pypi/djangorecipe/
• http://www.sixfeetup.com/swag/buildout-quick-reference-card
• http://www.doughellmann.com/projects/virtualenvwrapper/

29. Dziękuję za uwagę!

30. Bibliografia - media
• http://farm4.static.flickr.com/3237/2796908072_63dbb1e52d_o_d.jpg
• http://farm3.static.flickr.com/2599/3920111676_b69ce1138d_b_d.jpg
• http://farm1.static.flickr.com/6/86227485_2bd48ad7f6_o_d.jpg
• ikony: http://graffletopia.com/stencils/144