Difference between revisions of "Package:Tengine"

From Funtoo
Jump to navigation Jump to search
m
(Undo revision 10076 by Threesixes (talk) idk something happened, and major regression?)
Line 4: Line 4:
|Homepage=http://tengine.taobao.org
|Homepage=http://tengine.taobao.org
}}
}}
Tengine is an {{package|www-servers/nginx}} fork.  It supports DSO module loading, meaning it can have external modules without the need to compile them in.   
Tengine is an {{package|www-servers/nginx}} fork.  It supports DSO module loading, meaning it can have external modules without the need to compile them in.  Tengine is a good back end web server node choice.


===Installation===
===Installation===
Line 18: Line 18:


==== External Modules ====
==== External Modules ====
Passenger is an easy method to serve ruby, python, node.js, and Meteor cms' or web applications.
If you want to run passenger:
If you want to run passenger:
{{file|name=/etc/portage/make.conf|desc=build the passenger module|body=
{{file|name=/etc/portage/make.conf|desc=build the passenger module|body=
Line 23: Line 25:
}}
}}


Then, just:  
Then merge:  
{{console|body=###i## emerge tengine}}
{{console|body=###i## emerge tengine}}


Line 48: Line 50:
{{c|/etc/tengine/sites-available/localhost}} has site specific configurations.  Generally localhost is copied to domain.tld file formats in the {{c|/etc/tengine/sites-available/}} directory.
{{c|/etc/tengine/sites-available/localhost}} has site specific configurations.  Generally localhost is copied to domain.tld file formats in the {{c|/etc/tengine/sites-available/}} directory.


===Redirection from HTTP to HTTPS===
===Redirection===
These days, it is usual to have anything on https to protect your users regarding login and privacy where it comes handy to automatically redirect requests from http which are often a result of the browsers autocompletion. To achieve that, we need a server listening on http and redirecting to our main server on https like this :
These days, it is usual to have anything on https to protect your users regarding login and privacy where it comes handy to automatically redirect requests from http which are often a result of the browsers autocompletion. To achieve that, we need a server listening on http and redirecting to our main server on https like this :


Line 60: Line 62:
}}
}}


=== Unix Socket ===
To listen on a unix socket & 127.0.0.1:
{{file|name=/etc/tengine/sites-available/localhost|desc=Listen on a unix socket|body=
server{
listen 127.0.0.1;
listen unix:/var/run/tengine.sock;
...
}
}}
===PHP-FPM===
===PHP-FPM===
Tengine does not natively support php, so we delegate that responsibility to [[Package:PHP#Fpm | php-fpm]]
Tengine does not natively support php, so we delegate that responsibility to [[Package:PHP#Fpm | php-fpm]]
Line 68: Line 79:
index index.php index.cgi index.htm index.html;
index index.php index.cgi index.htm index.html;
location ~ \.php$ {
location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
#         fastcgi_pass 127.0.0.1:9000;   #uncomment this line, and comment the socket line above to use tcp
include fastcgi.conf;
include fastcgi.conf;
         }
         }
Line 76: Line 88:


=== Passenger ===
=== Passenger ===
To serve with passenger, change the root statement below to point to your rails application's public directory:
Passenger's app environments:
#test
#development
#production
 
{{note|Anything the internet can touch should be in production mode.}}
 
==== Ruby on Rails ====
To serve with passenger, change the root statement below to point to your application's public directory:
{{file|name=/etc/tengine/sites-available/localhost|desc=passenger configuration|body=
{{file|name=/etc/tengine/sites-available/localhost|desc=passenger configuration|body=
passenger_root /usr/libexec/passenger/locations.ini;
passenger_root /usr/libexec/passenger/locations.ini;
Line 88: Line 108:
}
}
}}
}}
==== Node.js ====
{{file|name=/etc/tengine/sites-available/localhost|desc=passenger configuration|body=
passenger_root /usr/libexec/passenger/locations.ini;
passenger_ruby /usr/bin/ruby;
server {
        passenger_enabled on;
passenger_app_env development;
root /home/$USER/node/public;
        ...
}
}}
Create the public directory:
{{console|body=###i## mkdir /home/$USER/node/public}}
Passenger's node entry point is app.js, the entry point must be named this for passenger to serve it.
Create a node hello world:
{{file|name=/home/$USER/node/app.js|desc=node hello world|body=
// Load the http module to create an http server.
var http = require('http');
// Configure our HTTP server to respond with Hello World to all requests.
var server = http.createServer(function (request, response) {
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.end("Hello World From Node.js\n");
});
//**only for instances started via node app.js** Listen on port 8000, IP defaults to 127.0.0.1
server.listen(8000);
//**only for instances started via node app.js** Put a friendly message on the terminal
console.log("Server running at http://127.0.0.1:8000/");}}
==== Python ====
{{SectionNeedsUpdates}}
Currently (01:52, May 19, 2015 (UTC)) python 3.x doesn't clash well with passenger, however python 2.7 runs well.
{{console|body=###i## eselect python set  python2.7}}


===Usage===
===Usage===

Revision as of 08:12, May 21, 2015

Tengine

   Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Tengine is an www-servers/nginx fork. It supports DSO module loading, meaning it can have external modules without the need to compile them in. Tengine is a good back end web server node choice.

Installation

Shared & Static Modules

If you happen to want all modules installed dynamically, you, still, need to install some static modules. Make sure to add this to your /etc/portage/make.conf file:

   /etc/portage/make.conf - Tengine all-modules build
...
TENGINE_SHARED_MODULES_HTTP="access addition autoindex browser charset_filter empty_gif fastcgi flv footer_filter geoip image_filter limit_conn limit_req lua map memcached mp4 random_index referer reqstat rewrite scgi secure_link slice split_clients sub sysguard tfs trim_filter upstream_ip_hash upstream_least_conn upstream_session_sticky user_agent userid_filter uwsgi xslt"
TENGINE_STATIC_MODULES_HTTP="concat dav degradation geo gunzip gzip gzip_static perl proxy realip spdy ssi ssl stub_status upstream-rbtree upstream_check upstream_consistent_hash upstream_keepalive"
...

External Modules

Passenger is an easy method to serve ruby, python, node.js, and Meteor cms' or web applications.

If you want to run passenger:

   /etc/portage/make.conf - build the passenger module
TENGINE_EXTERNAL_MODULES_HTTP="passenger"

Then merge:

root # emerge tengine

Configuration

Files for configuration are located at /etc/tengine

The major differing point in tengine from nginx is that you have to specifically declare which modules are loaded. Available modules are located at /var/lib/tengine/modules.

   /etc/tengine/tengine.conf - DSO module statements
...
dso {
	load ngx_http_charset_filter_module.so;
	load ngx_http_fastcgi_module.so;
	load ngx_http_rewrite_module.so;
	load ngx_http_access_module.so; ## added because you want most likely use allow & deny on certain positions
}
...

Tengine

/etc/tengine/tengine.conf contains engine specific configurations.

Sites

/etc/tengine/sites-available/localhost has site specific configurations. Generally localhost is copied to domain.tld file formats in the /etc/tengine/sites-available/ directory.

Redirection

These days, it is usual to have anything on https to protect your users regarding login and privacy where it comes handy to automatically redirect requests from http which are often a result of the browsers autocompletion. To achieve that, we need a server listening on http and redirecting to our main server on https like this :

   /etc/tengine/sites-available/redir - redirection from http to https
server {
        server_name domain.tld;
        listen 80;
	return 302  https://www.domain.tld$request_uri;
}

Unix Socket

To listen on a unix socket & 127.0.0.1:

   /etc/tengine/sites-available/localhost - Listen on a unix socket
server{
	listen 127.0.0.1;
	listen unix:/var/run/tengine.sock;
...
}

PHP-FPM

Tengine does not natively support php, so we delegate that responsibility to php-fpm

   /etc/tengine/sites-available/localhost - fpm tcp/ip configuration
server {
        ...
	index index.php index.cgi index.htm index.html;
	location ~ \.php$ {
		fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
#	        fastcgi_pass 127.0.0.1:9000;   #uncomment this line, and comment the socket line above to use tcp
		include fastcgi.conf;
        }
        ...
}

Passenger

Passenger's app environments:

  1. test
  2. development
  3. production
   Note

Anything the internet can touch should be in production mode.

Ruby on Rails

To serve with passenger, change the root statement below to point to your application's public directory:

   /etc/tengine/sites-available/localhost - passenger configuration
passenger_root /usr/libexec/passenger/locations.ini;
passenger_ruby /usr/bin/ruby;

server {
        passenger_enabled on;
	passenger_app_env development;
	root /home/$USER/ror/public;
        ...
}

Node.js

   /etc/tengine/sites-available/localhost - passenger configuration
passenger_root /usr/libexec/passenger/locations.ini;
passenger_ruby /usr/bin/ruby;

server {
        passenger_enabled on;
	passenger_app_env development;
	root /home/$USER/node/public;
        ...
}

Create the public directory:

root # mkdir /home/$USER/node/public

Passenger's node entry point is app.js, the entry point must be named this for passenger to serve it.

Create a node hello world:

   /home/$USER/node/app.js - node hello world
// Load the http module to create an http server.
var http = require('http');

// Configure our HTTP server to respond with Hello World to all requests.
var server = http.createServer(function (request, response) {
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.end("Hello World From Node.js\n");
});

//**only for instances started via node app.js** Listen on port 8000, IP defaults to 127.0.0.1
server.listen(8000);

//**only for instances started via node app.js** Put a friendly message on the terminal
console.log("Server running at http://127.0.0.1:8000/");

Python

   Important

This section is in need of updates.

Currently (01:52, May 19, 2015 (UTC)) python 3.x doesn't clash well with passenger, however python 2.7 runs well.

root # eselect python set  python2.7

Usage

To start the tengine server:

root # rc-update add tengine default
root # rc