Merge pull request #39 from fixpoint/feature/extra-jobmngrd

外部 jobmngrd 構成 (ke2/extra/jobmngrd) を追加しました

ChangeLog

@@ -1,3 +1,7 @@
+2024-08-01  Ichiro TAKAHASHI  <[email protected]>
+
+	* 外部 jobmngrd 構成 (ke2/extra/jobmngrd) を追加しました。
+
 2024-07-26  Ichiro TAKAHASHI  <[email protected]>
 
 	* nginx コンテナのバージョンを 1.27-alpine にアップデートしました。(#30)

ke2/extra/jobmngrd/README.md

@@ -0,0 +1,38 @@
+# Kompira Enterprise 2.0: 外部 jobmngrd 構成
+
+KE2.0 の外部に jobmngrd だけを配置する構成の Docker Compose ファイルが含まれています。
+
+## KE2.0 側での準備
+
+事前に KE2.0 システム側で、AMQPS 接続を許可するファイヤーウォールの設定と、rabbitmq に外部接続用のユーザの追加とパーミッションの設定が必要になります。
+
+まず OS ごとの手順で AMQPS (5671番ポート) の許可設定を行なってください。firewall-cmd を使う場合の例は以下のようになります。KE2.0 がクラスタ構成の場合は全てのノードで許可設定を行なってください。
+
+    $ sudo firewall-cmd --add-service=amqps --permanent
+    $ sudo firewall-cmd --reload
+
+続けて rabbitmq に外部 jobmngrd から接続するためのユーザーを追加し、パーミッションを設定してください。
+ユーザ名 `kompira` / パスワード `kompira` で設定する場合の例を以下に示します。
+
+    $ docker exec $(docker ps -q -f name=rabbitmq) rabbitmqctl add_user kompira kompira
+    $ docker exec $(docker ps -q -f name=rabbitmq) rabbitmqctl set_permissions --vhost / kompira '.*' '.*' '.*'
+
+## 外部 jobmngrd の起動
+
+以降の説明はこのディレクトリで作業することを前提としていますので、このディレクトリに移動してください。
+
+    $ cd ke2/extra/jobmngrd
+
+まず、コンテナイメージの取得を行なうために、以下のコマンドを実行します。
+
+    $ docker compose pull
+
+続けて、以下のコマンドを実行して外部 jobmngrd を開始をします。
+
+    $ AMQP_URL=... docker compose up -d
+
+このとき KE2.0 が動作しているシステムの rabbitmq に接続できるように、rabbitmq に追加したユーザやパスワードに合わせて AMQP_URL を指定してください。
+
+    $ AMQP_URL=amqps://kompira:kompira@{{rabbitmqのアドレス}}:5671 docker compose up -d
+
+ブラウザで KE2.0 の「管理領域設定 > デフォルト」 (/config/realms/default) を確認して、「ジョブマネージャ状態」一覧にこのホストがステータス「動作中」として表示されていれば、外部 jobmngrd 構成のセットアップは成功です。

ke2/extra/jobmngrd/docker-compose.override.yml

@@ -0,0 +1,7 @@
+services:
+  jobmngrd:
+    logging:
+      driver: local
+    environment:
+      - AMQP_URL=${AMQP_URL:-amqps://kompira:kompira@${AMQP_HOST:-rabbitmq}:5671}
+    restart: always

ke2/extra/jobmngrd/docker-compose.yml

@@ -0,0 +1,4 @@
+# 外部 jobmngrd 構成
+name: ke2
+include:
+  - ../../services/jobmngrd.yml