ウェブサイト検索

Debian 12にNginxリバースプロキシを使用してWildFlyアプリケーションサーバーをインストールする方法

Debian 12にNginxリバースプロキシを使用してWildFlyアプリケーションサーバーをインストールする方法

このチュートリアルはこれらのOSバージョンのために存在します

  • Debian 12 (ブックワーム)
  • Debian 11 (バルセイヤ)
  • Debian 10 (バスター)

このページで

  1. 前提条件
  2. Java OpenJDKのインストール

  3. WildFlyのインストールと構成

    1. WildFlyのユーザーとグループを追加する
    2. WildFlyバイナリパッケージのダウンロード
    3. WildFlyのインストールを構成する
    4. SystemdサービスとしてWildFlyを実行する
  4. WildFly ユーザー管理の追加
  5. Nginxをリバースプロキシとして設定する
  6. クライアントを介してWildFlyにアクセスする
  7. 結論

WildFlyは以前のJBossであり、Javaウェブアプリケーションの構築と展開を支援する無料かつオープンソースのアプリケーションサーバーです。Javaで書かれており、Java EE（エンタープライズ版）仕様に準拠しています。WildFlyはJBossによって作成されましたが、現在はRedHatによって開発されています。それは強力で、商用利用に適した、モジュール式で軽量なアプリケーションサーバーであり、Javaウェブアプリケーションを実行し展開するために必要なすべてのツールと機能を提供します。

WildFlyは、EJB、JPA、サーブレット、JAX-RS、バッチ、およびセキュリティなどのJavaアプリケーションのためのツールを提供するクロスプラットフォームのアプリケーションサーバーです。

このガイドでは、Debian 12 サーバーに WildFly または JBoss アプリケーションランタイムを段階的にインストールする方法を学びます。WildFly をインストールし、管理コンソールを有効にし、WildFly 管理ユーザーを作成し、Nginx をリバースプロキシとしてインストールおよび設定します。

前提条件

進む前に、次のものを集めてください:

  • 4GB以上のメモリを搭載したDebian 12サーバー。
  • sudo管理者権限を持つ非ルートユーザー。

Java OpenJDKのインストール

WildFlyはアプリケーションを構築するための柔軟で軽量なJavaアプリケーション実行環境です。このセクションでは、DebianサーバーにWildFlyをインストールするためにJava OpenJDK 17をインストールして使用します。

まず、次のコマンドを実行してDebianリポジトリを更新します。

sudo apt update

では、以下のコマンドを実行してJava OpenJDKパッケージをインストールします。これにより、Java OpenJDK 17 LTS（Long Term Support）バージョンに相当するdefault-jdkパッケージがインストールされます。

sudo apt install default-jdk

インストールを続行するにはyを入力してください。

Javaをインストールした後、以下のコマンドを使用してJavaのバージョンを確認してください。Java OpenJDK 17がインストールされていることがわかるはずです。

java -version

WildFlyのインストールと設定

Java OpenJDKをインストールした後は、次の作業を完了することでWildFlyのインストールを開始できます:

  • WildFlyのユーザーとグループを追加する
  • WildFlyバイナリパッケージのダウンロード
  • WildFlyのインストールを構成する
  • SystemdサービスとしてWildFlyを実行する

始めましょう。

WildFlyのユーザーとグループを追加する

まず、WildFlyのインストールを実行するために使用される新しいシステムユーザーとグループwildflyを作成します。

以下のコマンドを実行して新しいグループとユーザーをwildflyという名前で追加します。この操作によって、wildflyユーザーのデフォルトのホームディレクトリを/opt/wildflyに設定し、これをWildFlyのインストールディレクトリとして使用します。

sudo groupadd -r wildfly
sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

WildFlyバイナリパッケージのダウンロード

systemdユーザーを追加した後、wgetを使用してWildFlyのバイナリパッケージをダウンロードします。最新バージョンを入手するには、WildFlyのダウンロードページを訪問することを忘れないでください。

それ以前に、以下のaptコマンドを使ってunzipをインストールしてください。

sudo apt install unzip -y

その後、WildFlyのダウンロードページにアクセスして、WildFlyの最新バージョンへのリンクをコピーします。次に、以下のようにwgetコマンドを使ってWildFlyのバイナリパッケージをダウンロードします。この例では、WildFly 30.0.0をインストールします。

wget https://github.com/wildfly/wildfly/releases/download/30.0.0.Final/wildfly-30.0.0.Final.zip

次に、WildFlyのバイナリパッケージの解凍を行い、抽出したディレクトリを/opt/wildflyに移動します。

unzip wildfly-30.0.0.Final.zip
sudo mv wildfly-30.0.0.Final /opt/wildfly

最後に、次のコマンドを実行して/opt/wildflyディレクトリの所有権をユーザーwildflyに変更します。

sudo chown -RH wildfly: /opt/wildfly

WildFlyのインストールを構成する

この例では、単一のマシンにスタンドアロンモードでWildFlyをインストールします。したがって、ここで変更するすべての設定は、WildFlyスタンドアロンの設定に関連しています。

/opt/wildfly/bin/standalone.confというファイルを開くには、次のnanoエディターコマンドを実行してください。

sudo nano /opt/wildfly/bin/standalone.conf

WildFlyのデフォルトの最大ヒープメモリサイズを増やすには、JBOSS_JAVA_SIZING 環境変数内のXmx512mの値を次のように変更してください。

現在のサーバーに合わせて、最大ヒープメモリサイズを調整してください。以下の例では、最大ヒープメモリを4GBに設定しています。

  JBOSS_JAVA_SIZING="-Xms64m -Xmx4096m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m"

作業が完了したら、ファイルを保存して終了してください。

以下のコマンドを使用して、新しい構成ディレクトリ/etc/wildflyを作成してください。

sudo mkdir -p /etc/wildfly

/etc/wildfly/wildfly.conf にWildFlyの設定ファイルをコピーし、次のnanoエディタコマンドを使用して開いてください。

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/
sudo nano /etc/wildfly/wildfly.conf

WILDFLY_BINDのデフォルトを127.0.0.1に変更し、WildFlyコンソール管理を有効にするための変数WILDFLY_CONSOLE_BINDを追加してください。WildFlyと管理コンソールは、両方ともローカルホストで実行されます。

The address to bind to
WILDFLY_BIND=127.0.0.1
Enable Admin
WILDFLY_CONSOLE_BIND=127.0.0.1

完了したら、ファイルを保存して終了します。

次に、WildFlyの起動スクリプトを/opt/wildfly/bin/launch.shにコピーし、以下のchmodコマンドで実行可能にします。

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/
sudo chmod +x /opt/wildfly/bin/*.sh

次の nano エディターコマンドを使用して、WildFly の起動スクリプト /opt/wildfly/bin/launch.sh を開きます。

sudo nano /opt/wildfly/bin/launch.sh

-bmanagement $4の新しいコマンドオプションを挿入して、WildFly管理コンソールをこのように有効にしてください。

if [[ "$1" == "domain" ]]; then
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4
else
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4
fi

作業が完了したら、ファイルを保存して閉じてください。

最後に、以下のコマンドを実行してWildFlyのインストールディレクトリ/opt/wildflyの所有権をユーザーwildflyに変更します。

sudo chown -RH wildfly: /opt/wildfly

SystemdサービスとしてWildFlyを実行する

WildFlyをスタンドアロンモードに設定した後、WildFly用のsystemdサービスファイルをセットアップします。これにより、WildFlyをバックグラウンドで実行し、systemctlユーティリティを介してWildFlyを簡単に管理できます。

WildFlyのsystemdサービスファイルを/etc/systemd/system/wildfly.serviceにコピーし、以下のnanoエディターコマンドを使用して修正します。

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/
sudo nano /etc/systemd/system/wildfly.service

ExecStart オプション内に、新しい開始パラメータ $WILDFLY_CONSOLE_BIND を追加して、WildFly 管理コンソールを有効にします。

ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

完了したら、ファイルを保存してエディタを終了してください。

次に、以下のsystemctlコマンドを実行してsystemdマネージャを再読み込みします。

sudo systemctl daemon-reload

次に、以下のコマンドを使用してwildflyサービスを開始および有効にします。

sudo systemctl start wildfly
sudo systemctl enable wildfly

以下のコマンドを実行して、WildFlyサービスが実行中であることを確認してください。

sudo systemctl status wildfly

WildFlyサービスが実行中の場合、以下の出力が表示されます。

システム上のオープンポートのリストは、次のコマンドを実行することで確認できます。

ss -antpl | grep -i java

WildFlyが使用する複数のポート8080、8443、9990が表示されるはずです。

WildFly ユーザー管理の追加

WildFlyをインストールした後、スクリプト/opt/wildfly/bin/add-user.shを使用してWildFlyの新しい管理ユーザーを作成します。

/opt/wildfly/bin/add-user.sh スクリプトを次のように実行します。

sh /opt/wildfly/bin/add-user.sh

これから次のことを尋ねられます:

  • 新しいWildFly管理ユーザーを作成するには、入力してください。
  • 管理ユーザーとパスワードを入力し、その後繰り返してください。
  • グループ構成を尋ねられたらENTERを押してください。
  • ユーザーをManagementRealmに追加するには「はい」と入力してください。

プロセスが完了すると、新しいユーザーがWildFlyの設定に追加されたことがわかるはずです。

Nginxをリバースプロキシとして設定する

この時点で、WildFlyのインストールを完了し、管理コンソールを有効にし、管理ユーザーを作成しました。次のステップは、Nginxをインストールし、WildFlyのリバースプロキシとして設定することです。

以下のaptコマンドを実行して、DebianサーバーにNginxをインストールしてください。インストールを進めるにはyと入力してください。

sudo apt install nginx

Nginxがインストールされたら、WildFlyのリバースプロキシとして設定します。

次のnanoエディタコマンドを使用して、新しいNginxプロキシヘッダー設定/etc/nginx/conf.d/proxy_headers.confを作成してください。

sudo nano /etc/nginx/conf.d/proxy_headers.conf

次の設定をファイルに挿入してください。

```
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
add_header Front-End-Https on;
add_header Cache-Control no-cache;
```

作業が終わったら、ファイルを保存して終了してください。

次に、以下のnanoエディターコマンドを実行して、新しいNginxサーバーブロック構成/etc/nginx/sites-available/wildflyを作成します。

sudo nano /etc/nginx/sites-available/wildfly

以下の設定を挿入して、WildFlyインストール用のリバースプロキシとしてNginxをセットアップしてください。server_nameオプション内のドメインを必ず変更してください。ローカルドメイン名を使用することもできます。

server {
    listen          80;
    server_name     wildfly.howtoforge.local;
    location / {
        include conf.d/proxy_headers.conf;
        proxy_pass http://127.0.0.1:8080;
    }
    location /management {
        include conf.d/proxy_headers.conf;
        proxy_pass http://127.0.0.1:9990/management;
    }
    location /console {
        include conf.d/proxy_headers.conf;
        proxy_pass http://127.0.0.1:9990/console;
    }
    location /logout {
        include conf.d/proxy_headers.conf;
        proxy_pass http://127.0.0.1:9990/logout;
    }
    location /error {
        include conf.d/proxy_headers.conf;
        proxy_pass http://127.0.0.1:9990;
    }
}

作業が完了したら、ファイルを保存して閉じてください。

以下のコマンドを実行して、wildflyの仮想ホストファイルを有効にし、Nginxの構文を確認してください。

sudo ln -s /etc/nginx/sites-available/wildfly /etc/nginx/sites-enabled/
sudo nginx -t

正しいNginx構文がある場合、出力「構文は正常—テスト成功」が表示されます。

最後に、以下のコマンドを実行してNginxサービスを再起動し、作成した変更を適用します。その後、Nginxサービスを確認して、サービスが正常に動作していることを確認してください。

sudo systemctl restart nginx
sudo systemctl status nginx

Nginxが実行中であれば、出力はアクティブ (実行中)であるべきです。

クライアント経由でWildFlyにアクセスする

クライアントマシンで、テキストエディタを使ってhostsファイルを開きます。Windowsユーザーの場合、ファイル C:\Windows\System32\drivers\etc\hosts を管理者として開きます。一方、LinuxまたはmacOSユーザーの場合は、/etc/hostsファイルをsudo権限で開いてください。

次の設定を挿入し、必ずローカルドメイン名とIPアドレスをあなたの情報に変更してください。

192.168.5.15  wildfly.howtoforge.local

作業が完了したら、ファイルを保存して閉じてください。

ウェブブラウザを起動し、WildFlyのローカルドメイン（例： http:wildfly.howtoforge.local/ ）にアクセスしてください。インストールが成功していれば、デフォルトのWildFlyインデックスページが表示されるはずです。

今、管理コンソールリンクをクリックして、WildFlyの管理コンソールにアクセスしてください。新しいタブが開き、URLパス/consoleを使ってWildFlyの管理コンソールにリダイレクトされます。

WildFly 管理コンソールに管理者ユーザー名とパスワードを入力し、サインインをクリックします。

正しいユーザー名とパスワードがある場合は、以下のようなWildFly管理コンソールが表示されるはずです。

次に、ランタイム メニューをクリックし、サーバーを選択します。WildFly が起動していることを確認するメッセージが表示されるはずです。

最後に、ステータスメニューを選択すると、4GBに変更されたヒープ構成を含むWildFlyインストールの詳細なステータスが表示されるはずです。

結論

結論として、あなたはDebian 12におけるWildFlyのインストールを段階的に完了しました。WildFlyをインストールし、管理コンソールを有効にし、WildFly管理ユーザーを作成しました。それに加えて、WildFly用のリバースプロキシとしてNginxを設定しました。これからは、WildFlyアプリケーションランタイムを使用してJBossアプリケーションをデプロイし、実行することができます。

関連記事: