目的

NGINX+Tomcat+Docker構成でサーバ環境を構築できるようになる

背景

過去PJにおいて、アプリケーションコードを書いたことはあるが、サーバ側の構築などのインフラ関連作業を行なったことがなかったため、実際に構築体験し身につけたかった。それと、最近勉強したDockerも活用してみたいと思った。

各種概要

NGINXとは

静的コンテンツを高速に配信するように設計されているWebサーバ。リバースプロキシ機能を持つため、背後にWebアプリケーションサーバを配置して動的なコンテンツを配信したり、ソフトウェアロードバランサやHTTPキャッシュとしても機能する。
Apacheで問題だったC10K問題を克服したWebサーバ。

Tomcatとは

正式名称Apache Tomcat（本投稿記事内ではTomcatと表記）。
JavaサーブレットやJSPを実行するためのWebコンテナ。

Dockerとは

アプリケーションを開発（developing）、移動（shipping）、実行（running）するためのオープンなプラットフォーム。

コンテナの中にアプリケーション開発環境を構築し開発を行う、サーバ環境を構築、テスト環境を構築するなど、様々な使い方がある。
ローカル環境を汚さない、インフラがコード化されているため他環境への移行、新規入場者への環境提供が楽、構築手順ミスによる環境不正を防げる等といったメリットもある。

全体像

こんな感じの構成です。

環境

os: macOS Monterey 12.5
machine: MacBook Air(Retina, 13-inch, 2018)
cpu: 1.6GHz デュアルコアIntel Core i5

Dockerデスクトップをインストール済みです。

% brew list --version | grep docker
docker 4.11.1,84025

今回のファイル

全てGitHubにあります。

内容

Dockerfileの作成

NGINX、Tomcatサーバコンテナを作るためのDockerfileを作成します。

NGINX

80ポートで待ち受け、初期状態で作成されている/etc/nginx/conf.dディレクトリを削除します。
後に作成するdocker-compose.ymlで、設定ファイルが格納されたディレクトリがconf.dという名称でマウントされるように指定されます。

nginx-server/Dockerfile

FROM nginx:latest

EXPOSE 80

RUN rm -rf /etc/nginx/conf.d

EXPOSEは、指定されたポートで待ち受けるよう命令するものです。

Tomcat

tomcat-server/Dockerfile

FROM tomcat:latest

EXPOSE 8080

docker-compose.ymlの作成

NGINX、Tomcatコンテナをビルド、マウントするディレクトリを指定したdocker-compose.ymlを作成します。

ビルドするDockerfileの指定は各Dockerfileが配置されているディレクトリを指定します。
マウントするディレクトリは、各コンテナごとで下記となります。

NGINX
- NGINX設定が入ったディレクトリ
- ログディレクトリ
Tomcat
- アプリケーションが入ったディレクトリ
- ログディレクトリ

ディレクトリ構成

% tree
.
├── docker-compose.yml
├── nginx-server
│   ├── Dockerfile
│   ├── conf.d            # NGINX設定ディレクトリ
│   │   └── nginx.conf
│   └── log               # NGINXログディレクトリ
└── tomcat-server
    ├── Dockerfile
    ├── log               # Tomcatログディレクトリ
    └── webapps           # アプリケーションディレクトリ
        └── sample
            └── sample.html

docker-compose.yml

version: "3"
services:
    nginx-server:
        build:
            context: ./nginx-server
        volumes:
            - ./nginx-server/conf.d:/etc/nginx/conf.d
            - ./nginx-server/log:/var/log/nginx
        ports:
            - 80:80

    tomcat-server:
        build:
            context: ./tomcat-server
        volumes:
            - ./tomcat-server/webapps:/usr/local/tomcat/webapps
            - ./tomcat-server/log:/usr/local/tomcat/logs
        ports:
          - 8080:8080

Webサーバ（NGINX）からWebコンテナ（Tomcat）への転送設定を追加

NGINX側ポート80へリクエストが来た際に、Tomcat側ポート8080へリクエストを転送するように設定をします。
proxy_passのアドレスにローカルアドレスを設定してください。

nginx-server/conf.d/nginx.conf

server {
    listen 80;
    server_name localhost;

    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;
    location / {
        proxy_pass http://192.168.x.x:8080;
        # proxy_pass http://host.docker.internal:8080;
    }
}

WinやMacでDockerデスクトップを利用している場合、proxy_passのアドレスにhost.docker.internalを指定しdocker-composeで立ち上げた他のコンテナへアクセスすることが可能ですが、Dockerデスクトップを利用していないLinuxの場合、host.docker.internalが使えません。DockerデスクトップforLinuxが出たようですが、同様にhost.docker.internalが使えるかは不明、かつ、環境によっては修正しないといけないのはあまり好まれないので、IP指定が良いかと思います。

アプリケーションコンテンツを作成

実際はWebアプリを配置しますが、本投稿では静的なhtmlを配置するに留めます。

tomcat-server/webapps/sample/sample.html

<h1>hello sample.html</h1>

コンテナをビルド

% docker-compose build

コンテナを起動

% docker-compose up -d

アクセス

ブラウザを立ち上げるのも面倒なので、curlコマンドで確認します。

% curl http://localhost/sample/sample.html
<h1>hellotouch sample.html</h1>

意図通りHTMLが返ってきてますね。

コンテナの起動を終了

% docker-compose down

何かおかしいなと思ったら

コンテナ起動後に下記コマンドでコンテナ内に入り操作できます。

% docker exec -it コンテナ /bin/bash

ログフォルダについてもマウントしてあるので、コンテナ外から確認が可能です。

最後に

公式が用意しているDockerイメージを再利用できたこともあり、簡単に構築することができた。様々なサイトを参考にさせてもらったが、設定周りも特に苦しむことなく進められた。

proxy_passのアドレス指定でhost.docker.internalを指定すべきか、ローカルIPを指定すべきか、お試しなので当初はどちらでも良かったが、Docker環境によっては使える使えないがあるため、実際利用した時に困らないよう、より良い指定方法を探り、知れたのは良かったと思う。

他にも、リバプロの設定やロードバランサ機能など、今後この投稿を応用し知識を蓄えていきたい。
2022/10/01 追加投稿しました。

NGINX+Tomcat+DockerでWebサーバを構築する。

目的

背景