nginx-build

command module
v0.4.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 27, 2015 License: MIT Imports: 13 Imported by: 0

README

nginx-build

Build Status

nginx-build - provides a command to build nginx seamlessly.

Requirements

  • wget for downloading nginx and external libraries
  • git for downloading 3rd party modules

Build Support

Installation

go get -u github.com/cubicdaiya/nginx-build

If you don't have go-runtime, you may download the binary from here.

If you are Mac OS X user, you can use Homebrew.

brew tap cubicdaiya/nginx-build
brew install nginx-build

Quick Start

nginx-build -d work
cd work/1.9.2/nginx-1.9.2
objs/bin/nginx -V

Custom Configuration

Configuration for building nginx

nginx-build provides a mechanism for customizing configuration for building nginx. Prepare a configure script like the following.

#!/bin/sh

./configure \
--sbin-path=/usr/sbin/nginx \
--conf-path=/etc/nginx/nginx.conf \

Give this file to nginx-build with -c.

$ nginx-build -d work -c configure.example
Direct configuration for building nginx

From v0.4.0, nginx-build allows to use nginx's configure options directly.

$ nginx-build -d work \
--sbin-path=/usr/sbin/nginx \
--conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log \
--pid-path=/var/run/nginx.pid \
--lock-path=/var/lock/nginx.lock \
--http-log-path=/var/log/nginx/access.log \
--http-client-body-temp-path=/var/lib/nginx/body \
--http-proxy-temp-path=/var/lib/nginx/proxy \
--with-http_stub_status_module \
--http-fastcgi-temp-path=/var/lib/nginx/fastcgi \
--with-debug \
--with-http_gzip_static_module \
--with-http_spdy_module \
--with-http_ssl_module \
--with-pcre-jit \
About --add-module

nginx-build allows to use multiple --add-module from v0.4.2.

$ nginx-build \
-d work \
--add-module=../nginx/ngx_small_light \
--add-module=../nginx/ngx_dynamic_upstream

On the other hand, nginx-build allows to embed multiple 3rd party modules with the single --add-module like the following, too.

$ nginx-build \
-d work \
--add-module=../nginx/ngx_small_light,../nginx/ngx_dynamic_upstream

The values of --add-module of nginx-build must be separated by ','. This feature is introduced in v0.4.0.

Limitations

And there are the limitations for the direct configuration below.

  • --with-pcre(force PCRE library usage) is not allowed
  • --with-pcre=DIR(set path to PCRE library sources) is allowed
  • --with-libatomic(force libatomic_ops library usage) is not allowed
  • --with-libatomic=DIR(set path to libatomic_ops library sources) is allowed

The limitations above are attributed by the flag package of Go. (multiple and different types from each other are not allowed)

Embedding ZLIB statically

Give -zlib to nginx-build.

$ nginx-build -d work -zlib

-zlibversion is an option to set a version of zlib.

$ nginx-build -d work -zlib -zlibversion=1.2.8
Embedding PCRE statically

Give -pcre to nginx-build.

$ nginx-build -d work -pcre

-pcreversion is an option to set a version of PCRE.

$ nginx-build -d work -pcre -pcreversion=8.37
Embedding OpenSSL statically

Give -openssl to nginx-build.

$ nginx-build -d work -openssl

-opensslversion is an option to set a version of OpenSSL.

$ nginx-build -d work -openssl -opensslversion=1.0.2c
Embedding 3rd-party modules

nginx-build provides a mechanism for embedding 3rd-party modules. Prepare a ini-file below.

[echo-nginx-module]
form=git
url=https://github.com/openresty/echo-nginx-module.git
rev=v0.58

[ngx_devel_kit]
form=git
url=https://github.com/simpl/ngx_devel_kit
rev=v0.2.19

Give this file to nginx-build with -m.

$ nginx-build -d work -m modules.cfg.example

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL