Phusion Passenger: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
(Minimale Programme für Tests von Passenger)
(Konfiguration über HSADmin)
Zeile 18: Zeile 18:
Zum Deaktivieren einer App muss diese im app und app-ssl Verzeichnis gelöscht werden.
Zum Deaktivieren einer App muss diese im app und app-ssl Verzeichnis gelöscht werden.


== Konfiguration /  .htaccess ==
== Konfiguration ==


Das Plugin ist zwar unabhängig von Einträgen in der .htaccess aktiv,
Die Auswahl des Interpreters für die Skriptsprachen Python, Ruby und JavaScript (NodeJS) für die Ausführung Apache-Passenger-Modul erfolgt über Variablen "PassengerPython", "PassengerRuby" und "PassengerNodejs" in der Apache-VHost-Definition für die Domain. Der Inhalt dieser Variablen wird über HSAdmin im Dialog "Domain ändern" gesteuert.
kann aber über die .htaccess Datei im jeweiligen Domain-Verzeichnis konfiguriert werden,
z.B. in "/home/pacs/xyz00/users/example/doms/example.com/.htaccess":


    PassengerNodejs /home/pacs/xyz00/users/example/.nvm/versions/node/v6.11.2/bin/node
Die Voreinstellungen sind:


bzw.
  PassengerPython /usr/bin/python3


    PassengerRuby /home/pacs/xyz00/users/example/.rbenv/shims/ruby
  PassengerRuby /usr/bin/ruby
 
  PassengerNodejs /usr/bin/node
 
Eigene Konfigurationen wären zum Beipiel (Für den Webspace "xyz00" und den User "xyz00-example"):
 
  PassengerNodejs /home/pacs/xyz00/users/example/.nvm/versions/node/v20.11.0/bin/node
 
oder
 
  PassengerRuby /home/pacs/xyz00/users/example/.rbenv/shims/ruby


oder
oder


    PassengerPython /home/pacs/xyz00/users/example/my_venv/bin/python
  PassengerPython /home/pacs/xyz00/users/example/my_venv/bin/python


(Nähere Informationen bitte den jeweiligen Wiki-Seiten über die spezifischen Laufzeitumgebungen entnehmen.)
(Nähere Informationen bitte den jeweiligen Wiki-Seiten über die spezifischen Laufzeitumgebungen entnehmen.)


Um zum Debuggen die Fehlermeldungen sehen zu können, kann vorübergehend diese Zeile in die .htaccess Datei eingefügt werden:
Die Einstellung "PassengerFriendlyErrorPages on" kann ebenfall in HSAdmin als Domain-Option aktiviert werden. Nach dem Abschluss des Debugging sollte die Option wieder abgeschaltet werden!
PassengerFriendlyErrorPages on
Nach dem Abschluss des Debugging sollte die Zeile entfernt bzw. der Wert auf off gesetzt werden.


== Neueinlesen der Konfiguration / Restart der App ==
== Neueinlesen der Konfiguration / Restart der App ==

Version vom 23. Januar 2024, 18:33 Uhr

Phusion Passenger ist ein Apache-Plugin zur Integration von Apps auf Domain (vhost) Ebene. Dabei kann es sich z.B. um NodeJS, RubyOnRails, Django oder weitere Laufzeitumgebungen handeln.

Aktivierung / Deaktivierung

Sobald im Verzeichnis app bzw. app-ssl unter der aufgeschalteten Domain eine App existiert, wird dies von Phusion Passenger ausgeführt

Phusion Passenger ist immer für die gesamte aufgeschaltete Domain aktiviert, die Bereitstellung einer App wirkt also auch auf Subdomains im Verzeichnis 'subs'. Insbesondere wird damit PHP für die jeweilige Domain deaktiviert. Statischen Dateien (z.B. index.html) aus htdocs* und subs* sind davon nicht betroffen. Idealerweise wird daher für jede App eine eigene Subdomain mit HSAdmin aufgeschaltet.

Sobald eine App einmal geladen ist, sind die Settings und Mappings Bestandteil der transienten Apache vhost-Konfiguration. Änderungen an .htaccess-Settings bzgl. Passenger kommen dann nicht mehr direkt zum Tragen, weil die .htaccess zu Gunsten der Effizienz dann nicht mehr ausgewertet wird.

Zum Deaktivieren einer App muss diese im app und app-ssl Verzeichnis gelöscht werden.

Konfiguration

Die Auswahl des Interpreters für die Skriptsprachen Python, Ruby und JavaScript (NodeJS) für die Ausführung Apache-Passenger-Modul erfolgt über Variablen "PassengerPython", "PassengerRuby" und "PassengerNodejs" in der Apache-VHost-Definition für die Domain. Der Inhalt dieser Variablen wird über HSAdmin im Dialog "Domain ändern" gesteuert.

Die Voreinstellungen sind:

 PassengerPython /usr/bin/python3
 PassengerRuby /usr/bin/ruby
 PassengerNodejs /usr/bin/node

Eigene Konfigurationen wären zum Beipiel (Für den Webspace "xyz00" und den User "xyz00-example"):

 PassengerNodejs /home/pacs/xyz00/users/example/.nvm/versions/node/v20.11.0/bin/node

oder

 PassengerRuby /home/pacs/xyz00/users/example/.rbenv/shims/ruby

oder

 PassengerPython /home/pacs/xyz00/users/example/my_venv/bin/python

(Nähere Informationen bitte den jeweiligen Wiki-Seiten über die spezifischen Laufzeitumgebungen entnehmen.)

Die Einstellung "PassengerFriendlyErrorPages on" kann ebenfall in HSAdmin als Domain-Option aktiviert werden. Nach dem Abschluss des Debugging sollte die Option wieder abgeschaltet werden!

Neueinlesen der Konfiguration / Restart der App

Passenger Apps werden wir folgt neu gestartet oder neu geladen:

   mkdir app(-ssl)/tmp
   touch app(-ssl)/tmp/restart.txt

Das führt nach einer Weile zu einem graceful Restart der App. D.h. die einzelnen Prozesse werden sukzessive zwischen der Bedienung von HTTP-Requests neu gestartet. Im Rahmen dieses Restarts sollten geänderte .htaccess Direktiven Wirkung entfalten. Entsprechendes gilt für Änderungen an der Applikation selbst.

Minimale Programme für Tests von Passenger

Links

  • weitere Tipps und Beispiel für die Programmiersprachen Python und Ruby in der Support Mailingliste: [1]