Tanz! Stefan Hornburg (Racke) 13. Deutscher Perl-Workshop, Frankfurt, 21. Oktober 2011

Transkript

1 Tanz! Stefan Hornburg (Racke) 13. Deutscher Perl-Workshop, Frankfurt, 21. Oktober 2011 Contents 1 Hintergrund und Projekte Tanzflur Dropbox LDAP Benutzerverwaltung Procurement für American Spaces Routes, Filter und Hooks Routes Splat Megasplat Präfix Filters Hooks Plugins Plugins auf CPAN Writing Plugins Plugins und Hooks Deployment Sessions Logs Szenarien Starman Perlbal Pools Skripts Ausblick Dancer Community

2 1 Hintergrund und Projekte 1.1 Tanzflur Tanzflur einfach ausdrucksstark effektiv minimale Abhängigkeiten Projekte Dropbox-Klon LDAP Benutzerverwaltung Procurement für American Corners 1.2 Dropbox Für die Firma Caithness in New York habe ich einen Dropbox-Klon entwickelt. Dropbox demonstriert die automatische Erkennung des MIME-Typs durch Dancer. Dropbox Autoindex Upload/Download Benutzerverwaltung 1.3 LDAP Benutzerverwaltung LDAP Benutzerverwaltung LDAP-Verzeichnis Benutzerverwaltung Adminstrator Referrer Patron 2

3 1.4 Procurement für American Spaces Procurement für American Spaces Warenkorb/Wunschliste Genehmigungsprozesse LibraryThing ISBNDB 2 Routes, Filter und Hooks 2.1 Routes Für eine Route benötigen wir HTTP-Methode Pfad Subroutine Rezept für Routes #! / u s r / b i n / env p e r l use Dancer ; g e t / => sub { t e m p l a t e i n d e x ; ; dance ; Der Pfad für eine Route kann in einer der folgenden Weisen angegeben werden. Routes String String mit benannten Parametern String mit Wildcards Splat Megasplat Regulärer Ausdruck Regulärer Ausdruck mit Captures 3

4 2.1.1 Splat Splat g e t / images / c o v e r s /. j p g => sub { my ( $ i s b n ) = s p l a t ; i f ( f " p u b l i c / images / c o v e r s / $ i s b n. j p g " ) { return s e n d _ f i l e " images / c o v e r s / $ i s b n. j p g " ; s t a t u s n o t _ f o u n d ; f o r w a r d 404; Megasplat Die einfache Wildcard matcht nur auf einen Teil des Pfads, d.h. bis zum nächsten Schrägstrich (Slash). Mit der doppelten Wildcard (Megasplat) wird einfach der Rest des Pfades gematcht und die splat-funktion gibt eine Liste zurück. Megasplat h t t p s : / / vsc. s t a t e. gov / l o s t p w d / b i l i n u x i a. de / e642bd543b9907bd2c06aa485261cb1a849a9f23fc7324bff45ebd3 g e t / l o s t p w d / => sub { my ( $ , $hash ) = s p l a t ; form > f i l l ( e m a i l => $ , hash => $hash ) ; t e m p l a t e ( l o s t p w d _ c o n f i r m, form => $form ) ; Captures h t t p s : / / dropbox. n i t e. s i / ~ r a c k e / t a l k s / dancer beamer. pdf any qr {^/~(? < user > [ ^ / ] + ) / (? < f i l e >.? ) /? $ => sub { my ( $ c a p t s, $user, $ f i l e ) ; $ c a p t s = c a p t u r e s ; $ f i l e = $ c a p t s >{ f i l e ; $ u s e r = $ c a p t s >{ u s e r ; ; Präfix Präfix 4

5 p r e f i x / w iki ; g e t qr { /? (? < page >. ) => sub { my $ c a p t s = c a p t u r e s ; ; t e m p l a t e wiki, { c o n t e n t => wiki ( $ c a p t s >{page ), page => $ c a p t s >{page ; 2.2 Filters Filters b e f o r e sub { ; a f t e r sub { ; before b e f o r e sub { u n l e s s ( s e s s i o n ( u s e r ) r e q u e s t >p a t h eq / l o g i n r e q u e s t >p a t h =~ m%^/ l o s t p w d% ) { r e d i r e c t / l o g i n ; ; 2.3 Hooks Hooks hook b e f o r e _ t e m p l a t e _ r e n d e r => sub { my $ t o k e n s = s h i f t ; my $menu ; i f ( s e s s i o n ( u s e r ) ) { $menu = [ { name => Logout, u r l => / l o g o u t ] ; e l s e { $menu = [ { name => Login, u r l => / l o g i n ] ; ; $tokens >{menu = $menu ; Die folgenden Hooks existieren in Dancer: before_deserializer before_file_render 5

6 before_error_init before_error_render before_template_render before_layout_render before_serializer after_deserializer after_file_render after_template_render after_layout_render after_error_render Der after_file_render-hook wird ausgelöst, nachdem eine statische Datei (Bild oder CSS-Datei) gesendet wurde. 3 Plugins Plugins Funktionalität Schlüsselwort Route Konfiguration 3.1 Plugins auf CPAN Plugins auf CPAN Dancer::Plugin::Database database Dancer::Plugin:: Dancer::Plugin::Ajax ajax Dancer::Plugin::LibraryThing Konfiguration p l u g i n s : L i b r a r y T h i n g : a p i _ k e y : d231aa37c9b4f5d304a60a3d0ad1dad4 d i r e c t o r y : p u b l i c / images / c o v e r s s i z e : l a r g e 6

7 Dancer::Plugin::LibraryThing Code use Dancer : : P l u g i n : : L i b r a r y T h i n g ; g e t / images / c o v e r s /. j p g => sub { my ( ) ; $ i s b n = s p l a t ; u n l e s s ( f " p u b l i c / images / c o v e r s / $ i s b n. j p g " ) = l i b r a r y t h i n g _ c o v e r ( $ i s b n ) ; i f < 3) { s t a t u s n o t _ f o u n d ; f o r w a r d 404; return s e n d _ f i l e " images / c o v e r s / $ i s b n. j p g " ; 3.2 Writing Plugins Writing Plugins register register_plugin plugin_setting 3.3 Plugins und Hooks Plugins und Hooks Dancer : : F a c t o r y : : Hook > i n s t a n c e > i n s t a l l _ h o o k s ( b e f o r e _ c a r t _ a d d ) ; 4 Deployment 4.1 Sessions Die Session-Engine wird mit session konfiguriert, ansonsten werden keine Sessions verwendet. Cookies sind Voraussetzung für Sessions mit Dancer. YAML-Sessions und JSON-Sessions sind nur für die Entwicklung gedacht Alternativen sind u.a.: Storable Cookie Memcached 7

8 MongoDB Eine gute Idee ist es die Session Engine für den Produktionsbetrieb in config.yml zu konfigurieren und für die Entwicklung in environments/development.yml zu überschreiben. Im Produktionsbetrieb ist es empfehlenswert die Ablauffrist für Sessions zu setzen, sonst ist eine Session für immer gültig. Sessions Engine session: Storable Verzeichnis session_dir: /var/run/dancer-sessions Ablauffrist session_expires: 8 hours 4.2 Logs Die Logger-Engine wird mit logger konfiguriert, ansonsten werden Logs erzeugt. Das Format für die Logs wird mit logger_format definiert, siehe search.cpan.org/perldoc?dancer::logger::abstract#logger_format. Verfügbare Engines sind u.a.: console file syslog * log4perl * Die Rotation der Logs für dateibasierte Engines darf nicht vergessen werden im Produktionsbetrieb. Logs Engine logger: file Verzeichnis log_path: log Format logger_format: "%t [%P] %m in %f l. %l" 4.3 Szenarien Die möglichen Szenarien für ein Deployment von Dancer findet man in der Dancer- Dokumentation: 8

9 Szenarien Standalone./bin/app.pl CGI, FastCGI plackup Starman Twiggy Corona Reverse Proxy Szenarien: Reverse Proxy Apache nginx Perlbal 4.4 Starman Starman p l a c k u p E p r o d u c t i o n s Starman \ workers =5 \ p i d / home / r a c k e / Dropbox / run / Dropbox. p i d \ p 5000 \ a b i n / app. p l \ D 4.5 Perlbal Am Anfang der Konfigurationsdatei laden wir das vpaths Plugin. Dann binden wir für bessere Performache ein. Perlbal LOAD v p a t h s XS e n a b l e h e a d e r s Pools Für unsere beiden Projekte erzeugen wir zunächst Pools: 9

10 Perlbal: Pools CREATE POOL p r o d _ s t a r m a n _ d o s q u a POOL p r o d _ s t a r m a n _ d o s q u a ADD : CREATE POOL p r o d _ s t a r m a n _ v s c POOL p r o d _ s t a r m a n _ v s c ADD : Perlbal: Reverse Proxy CREATE SERVICE v s c _ p r o d SET r o l e = r e v e r s e _ p r o x y SET pool = p r o d _ s t a r m a n _ v s c SET b u f f e r _ u p l o a d s = on ENABLE v s c _ p r o d Perlbal: Selector CREATE SERVICE v s c _ s e l e c t o r SET l i s t e n = : 8 0 SET r o l e = s e l e c t o r SET p l u g i n s = v p a t h s VPATH. = v s c _ p r o d ENABLE v s c _ s e l e c t o r Perlbal: SSL Selector CREATE SERVICE v s c _ s s l _ s e l e c t o r SET l i s t e n = : SET r o l e = s e l e c t o r SET p l u g i n s = v p a t h s SET e n a b l e _ s s l = on SET s s l _ k e y _ f i l e = / e t c / s s l / p r i v a t e / vsc. s t a t e. gov. key SET s s l _ c e r t _ f i l e = / e t c / s s l / c e r t s / vsc. s t a t e. gov. pem VPATH. = v s c _ p r o d ENABLE v s c _ s s l _ s e l e c t o r HEADER v s c _ s s l _ s e l e c t o r INSERT X Forwarded P r o t o : HTTPS 4.6 Skripts Dancer-Skripts sollten innerhalb der Dancer-Applikation liegen, gut geeignet ist das bin/-verzeichnis. Ein symbolischer Link is ausreichend. Ansonsten wird die Konfiguration nicht gefunden. Eine Ausgabe von Meldungen auf der Konsole ist wünschenswert, mit %m wird lediglich die reine Meldung ausgegeben. Skripts use Dancer : s c r i p t ; s e t l o g g e r => c o n s o l e ; s e t l o g g e r _ f o r m a t => %m ; 10

11 5 Ausblick 5.1 Dancer 2 Dancer2 keine globalen Variablen 100% OO Backend (Moo) Scoping for Sub-Applikationen überarbeitete Architektur 5.2 Community Community Web: Github: git://github.com/sukria/dancer.git IRC: irc.perl.org Mitarbeit: Dancer::Development The End Slides, Handout, Skripte: 11