Web ゲートウェイと連携させるための Nginx の構築と構成 (Windows)

CSP のための Nginx の構築手順

1. MSYS2 シェルで作業を開始し、Nginx のドキュメントで推奨される作業ディレクトリ構造を作成します。

   /opt/

2. /opt で作業して、以下のコマンドを使用して Nginx ソース・コードをチェックアウトします。

   hg clone http://hg.nginx.org/nginx
   

   

   これにより、Nginx ソース・コードが /opt/nginx/ の下に配置されます。

3. CSP 拡張子に以下のディレクトリを作成します。

   mkdir /opt/nginx/objs/lib/csp/
   

4. モジュールのソース・コード (ngx_http_csp_module.c) を、前の手順で作成したディレクトリにコピーします。

5. 同じディレクトリ内に、config という名前の構成ファイルを作成します。 このファイルには、以下の行が含まれる必要があります。

   ngx_addon_name=ngx_http_csp_module
   HTTP_MODULES="$HTTP_MODULES ngx_http_csp_module"
   NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_csp_module.c"
   

   

6. /opt/nginx/ で作業し、Nginx 構築環境を構成します。

   auto/configure --with-cc=cl --builddir=objs --prefix=
                  --conf-path=conf/nginx.conf --pid-path=logs/nginx.pid
                  --http-log-path=logs/access.log --error-log-path=logs/error.log
                  --sbin-path=nginx.exe
                  --http-client-body-temp-path=temp/client_body_temp
                  --http-proxy-temp-path=temp/proxy_temp
                  --http-fastcgi-temp-path=temp/fastcgi_temp
                  --with-cc-opt=-DFD_SETSIZE=1024 --without-http_rewrite_module
                  --without-http_gzip_module
                  --with-select_module --with-ipv6
                  --add-module=objs/lib/csp
   

   

   最後の行に、CSP モジュールをインクルードする指示が含まれることに注意してください。

7. Nginx をコンパイルします。これは、現在の MSYS2 シェルまたは Visual Studio 開発者コマンド・プロンプトで実行できます。

   MSYS2 シェルを使用するには、目的の Visual Studio 構築環境に対応する vcvarsall.bat スクリプトを見つけて、Nginx をコンパイルします。

   cd /c/path/to/vcvarsall
   vcvarsall.bat
   cd -
   nmake -f objs/Makefile
   

   

   vcvarsall.bat を探す場所がわからない場合は、Visual Studio 開発者コマンド・プロンプトを開くと、構築環境が設定されます。まず、MSYS2 パスを現在の MSYS2 シェル内の同等の Windows パスに変換します。

   cygpath –m $(pwd)
   

   

   次に、目的の構築環境のために Visual Studio コマンド・プロンプトを開き、その Windows パスに移動します。Nginx をコンパイルします。

   nmake -f objs/Makefile
   

   

   成功した場合、/opt/nginx/objs/ にサーバ (nginx.exe) が表示されます。

8. Nginx のインストール ： これを実行する最も簡単な方法は、まず Windows 用の Nginx の事前構築済みバージョンをダウンロードおよびインストールして、ディレクトリ構造 (通常 C:\nginx\) を取得し、次にそのインストール内の nginx.exe ファイルを、ローカルで作成したものと置き換えることです。

   動作可能な Nginx インストールの通常のディレクトリ構造は、以下のとおりです。

   Directory of C:\nginx
   
   03/07/2017  09:09    <DIR>          .
   03/07/2017  09:09    <DIR>          ..
   26/06/2017  10:14    <DIR>          conf
   26/06/2017  10:14    <DIR>          contrib
   10/05/2018  12:53    <DIR>          csp
   26/06/2017  10:14    <DIR>          docs
   26/06/2017  10:14    <DIR>          html
   10/05/2018  15:57    <DIR>          logs
   04/07/2017  15:52           715,264 nginx.exe
   26/06/2017  10:17    <DIR>          scgi_temp
   26/06/2017  10:17    <DIR>          temp
   26/06/2017  10:17    <DIR>          uwsgi_temp
   

   

   このディレクトリの nginx.exe のコピーを、構築手順で作成したバージョンで置き換えます。

例 ： 特定のパスでのすべてのトラフィックに対する CSP ルーティングを有効にする

適切な server 構成ブロック内に以下のセクションを配置し、/csp パスに送信されるすべてのトラフィックを Web ゲートウェイにルーティングします。

location /csp {
CSP On;
CSPNSD_pass localhost:7038;
}

例 ： InterSystems IRIS のファイル・タイプに対する要求を Web ゲートウェイにルーティングする

適切な server 構成ブロック内に以下のセクションを配置し、/csp パスに送信される InterSystems IRIS のファイル・タイプ (.csp、.cls、.zen、および .cxw) に対する要求の CSP ルーティングを有効にします。

location /csp {
CSPFileTypes  csp cls zen cxw;
CSPNSD_pass localhost:7038;
}

Nginx と NSD の起動および停止

Nginx を起動する方法は、以下のとおりです。

C:\nginx\nginx

Nginx を停止する方法は、以下のとおりです。

C:\nginx\nginx –s stop

NSD の操作方法については、"NSD の操作" を参照してください。