Nginx mogilefs module (v 1.0.2)

rus eng

MogileFS client for nginx web server.

Description

The module queries MogileFS tracker specified by mogilefs_tracker directive and uses first path returned by tracker to fetch requested file. The file key is specified by mogilefs_pass directive. If no domain or no file with specified key is found by tracker "404 Not found" status is retuned. If file is found but zero paths are returned by tracker "403 Service unavailable" status is retuned.

Configuration directives


syntax: mogilefs_pass [<key>] {<fetch block>}
default: none
severity: mandatory
context: server, location, limit_except

Specifies key of the file to query from MogileFS tracker. The key can contain any variables. If key is omitted, the part of request URI will be uses as key, which remains after stripping the name of mathced location.

            location /download/ {
                mogilefs_pass {
                    [...]
                }
            }
        

In this example if request URI is /download/example.jpg, the tracker will be queried for file with the key example.jpg.

The fetch block contains configuration which will be used to fetch file from storage node. In this block it is necessary to use proxy_pass directive with $mogilefs_path as an argument. Example:

            mogilefs_pass {
                proxy_pass $mogilefs_path;
                proxy_hide_header Content-Type;
                proxy_buffering off;
            }
        

The variable $mogilefs_path contains absolute URL to the file on storage node. The fetch block creates a hidden internal location with the name /mogilefs_fetch_XXXXXXXX, where redirected will be performed after successful tracker response.


syntax: mogilefs_methods <[[method 1] method 2 ... ]>
default: GET
severity: optional
context: main, server, location

Specifies which methods will be allowed to access MogileFS. GET retrieves a resource from MogileFS, PUT creates or replaces, DELETE deletes a resource in MogileFS.


syntax: mogilefs_domain <domain>
default: default
severity: optional
context: main, server, location

Specifies the name of MogileFS domain to query. The specification may contain variables.


syntax: mogilefs_tracker <IP|IP:port|upstream>
default: none
severity: mandatory
context: main, server, location

Specifies address of MogileFS tracker to query.


syntax: mogilefs_noverify <on/off>
default: off
severity: optional
context: main, server, location

Enables sending of noverify argument to MogileFS.


syntax: mogilefs_connect_timeout <time>
default: 60s
severity: optional
context: main, server, location

Specifies a timeout to be used to connect to mogilefs tracker. Could not be longer than 75 seconds.


syntax: mogilefs_send_timeout <time>
default: 60s
severity: optional
context: main, server, location

Specifies a timeout to be used to send data to mogilefs tracker. If no data will be received by mogilefs tracker during this time interval, nginx will close the connection.


syntax: mogilefs_read_timeout <time>
default: 60s
severity: optional
context: main, server, location

Specifies a timeout to be used to receive data from mogilefs tracker. If no data will be send by mogilefs tracker during this time interval, nginx will close the connection.


Example configuration

error_log  logs/error.log notice;

working_directory /usr/local/nginx;

http {
    include       mime.types;
    default_type  application/octet-stream;

    server {
        listen       80;

        location /download/ {
            #
            # Query tracker at 192.168.2.2 for a file with the key
            # equal to remaining part of request URI
            #
            mogilefs_tracker 192.168.2.2;

            mogilefs_pass {
                proxy_pass $mogilefs_path;
                proxy_hide_header Content-Type;
                proxy_buffering off;
            }
        }
    }
}
        

Requirements

nginx 0.7.1 or above is required to compile this module.

Download

Latest version 1.0.2:
FileMD5SHA1
nginx_mogilefs_module-1.0.2.tar.gz62a72ce32d10b7811a18b672d8f69e173233d553586c534e81767c3c330ebc1e04bc8bf5
nginx_mogilefs_module-1.0.2.zipf0caf3601265a6505d555ab76cac0cfac645e04fb07225e0c63f765a61e9e322c3826f73
or go to
download area

Browse repository

http://github.com/vkholodkov/nginx-mogilefs-module/tree/master

How to use

Download sources from one of the links above. Unpack the archive:

tar xvzf nginx_mogilefs_module-1.0.2.tar.gz

Configure nginx with additional module:

cd <path to nginx sources>
./configure --add-module=<path to mogilefs module sources>
make
make install

Nginx

nginx -- is a web-server, developed by Igor Sysoev.

Licence

The licence of above-described module is BSD You should have received a copy of licence along with the source code.

Contact author

Valery Kholodkov valery+nginx@grid.net.ru
Please use address extension while composing an Email to me.


Copyright (C) 2009 Valery Kholodkov