Catalyst::Manual::Deployment::NGINXUnit::PSGI - Deploying Catalyst with NGINX Unit
Catalyst runs under NGINX Unit using PSGI.
To configure a Catalyst app in NGINX Unit, upload a JSON configuration snippet via Unit's config API, available at an IP socket or a Unix domain socket (depending on Unit's startup settings):
# curl -X PUT --data-binary @config.json --unix-socket \ /path/to/control.unit.sock http://localhost/config
A minimal configuration includes a listener and an application entity:
{ "listeners": { "127.0.0.1:8080": { "pass": "applications/catalyst_app" } }, "applications": { "catalyst_app": { "type": "perl", "script": "/path/to/apps/myapp/myapp.psgi", "user": "catalyst_user", "group": "catalyst_group" } } }
The script should point to your app's .psgi file; user and group should have appropriate access rights.
script
.psgi
user
group
After a successful reconfiguration, you can manage your Catalyst app via the same config API.
Note: make sure the app's .psgi file includes the lib/ directory:
lib/
use lib 'lib'; use myapp;
For more information on NGINX Unit, visit: http://unit.nginx.org
Catalyst Contributors, see Catalyst.pm
This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.
To install Catalyst::Manual, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Catalyst::Manual
CPAN shell
perl -MCPAN -e shell install Catalyst::Manual
For more information on module installation, please visit the detailed CPAN module installation guide.