JS7® JobSchedulerクイックスタート

16803 ワード
JobScheduler ジョブ管理 js7 ジョブ管理システム SOS JobScheduler テキストリンク

JS7®JobSchedulerは独SOS社(Software- und Organisations-Service GmbH)によって開発されている、ジョブ管理システムです。
OSSジョブ管理ツールの定番JobSchedulerをリニューアルし、従来より耐障害性、大規模環境対応を強化し、ミッションクリティカルな要求に対応しています。
本記事では、JS7®JobSchedulerで初めてジョブを実行する方法までを記載しています。
参考：

詳細な情報については、以下をご覧下さい。

1. 前提条件

JS7® JobScheduler V.2.1以上がインストール済みであること
JS7® JobSchedulerの概要及びインストール方法については以下を参照ください
Dockerでのインストール手順　https://qiita.com/satoruf/items/360fee5293611433ed33
Windowsでのインストール手順　https://qiita.com/Yoshitami/items/6804584592956a483364
Linux/CLIでのインストール手順　https://qiita.com/satoruf/items/fa9846f4376d1a50a67e

2. はじめに

(1) デフォルトジョブリソースのインストール

デフォルトジョブリソースとは、定義済み共通ジョブリソース（JS7®インスタンス内でのグローバル変数）です。
ホスト名やエージェント名、ワークフロー名などをジョブ内から呼び出すことができます。
ジョブリソース :

画面右上のヘルプメニュー（？マーク）をクリックし、サンプル＞デフォルトジョブリソースを選択
メニューからサンプルダウンロードをクリック

ジョブ定義メニューをクリックし、画面右上のインポートボタンをクリック

ジョブ定義画面のインベントリーを選択し、左側のコントローラーを展開、ジョブリソースからDefaultをクリック

このままでは、未配置状態で使用できないので、配置ボタンをクリック

登録をクリックして、配置済みになることを確認

JobSchedulerからのメール送受信を設定する場合、eMailDefaultをクリックして、有効なアカウント/パスワード、smtpホストなどを入力し、配置をクリック

(2) ワークフローサンプルのインストール

SOS社サイトのオンラインデモでは様々なワークフローサンプルが用意されていますので、下記サイトからお試しできます。

各ワークフローサンプルの説明は以下をご参照ください

オンラインデモと同じワークフローサンプルをインストールします
画面右上のヘルプメニュー（？マーク）をクリックし、サンプルからジョブ実行環境に応じてUnix版かWindows版のワークフローサンプルを選択してダウンロード、

ジョブ定義メニューをクリックし、画面右上のインポートボタンをクリックし、ダウンロードしたExamples.tar.gz|.zipを選択

ジョブ定義画面のインベントリーを選択し、左側のコントローラーから展開、ワークフローをクリックすると、該当ワークフロー編集画面になります

3. サンプルワークフローの実行

(1) エージェント名の変更

サンプルワークフロージョブはすべて実行エージェント名が"primaryAgent"で登録されておりそのままでは配置・実行できません（ワークフローが「無効」になっている）ので、使用する登録済みのエージェント名（本記事では"js7-agent-primary"）に変更するか、エイリアス名を設定します。
エイリアス名とは、開発環境と本番環境でエージェント名が異なっても、ジョブ定義では共通のエイリアス名を使用するとワークフロージョブの定義内容を変える必要がありません。
ここではワークフロー内に多数のジョブ定義のエージェント名を一括で変更します。
変更元の"primaryAgent"が登録されていないと一括変更できませんので、最初に変更元の"primaryAgent"を管理メニューから登録

URLは登録済みのエージェントと異なるポートを適当に入れます。

ジョブ定義画面のインベントリーから、変更するワークフロー（ここでは"/Examples.Unix/01_HelloWorld/jduHelloWorld"）を選択し、ジョブ"job-hello-world"をクリックすると、エージェントが"primaryAgent"で登録されていることが確認できます。

変更するワークフローをジョブ定義画面の左側のインベントリーから選択、右側のプロパティペインの右上にある検索・置換ボタンをクリックすると、ワークフローのエージェント検索・置換ダイアログボックスが表示されますので、変換元エージェントを検索ボックス、変換先を置換ボックスで選択して、登録します。

(2) ワークフローの実行

有効なエージェントが登録されると、ワークフローが有効に変わるので、配置ボタンをクリックし登録すると、未配置から配置済に変わります。

ワークフローが配置済みになると、ワークフロー画面に配置済みワークフローが表示されます。

ワークフローを実行するには、アクションメニューからオーダー追加を選択

オーダー名は入力しないでも自動採番されますので、即時実行する場合は開始時間現在のまま登録

実行結果が下部のオーダー履歴に表示されます

オーダーIDをクリックすると、実行オーダーのログが表示されます

(3) ワークフローの定期実行

ワークフローを定期的に実行するには、実行計画を作成します。
JS7®ではJOCコックピットがバックグラウンドで実行する「デイリープランサービス」によって、ワークフロー実行のオーダーが作成され、コントローラーに配布します。
デイリープランサービスは、実行計画で定義した「スケジュール」を実行し、指定された開始時刻のオーダーを生成します。
オーダーの開始時刻を1つだけ指定するスケジュール（シングルスタート）と、周期的な開始時刻を指定するスケジュール（繰り返し実行）に適用されます。サイクル内の各開始時刻に対して、個々のオーダーが作成され、コントローラーに配布されます。
スケジュールの実行及びオーダーの生成は、デイリープランサービスによって指定したタイミングで自動的に実行されます。

1. カレンダーの作成

スケジュールを作成するために、まずカレンダーを作成します。
カレンダーは、オーダー、ジョブ、スケジュールを実行する予定の日のリストです。
カレンダーは、稼働日または非稼働日のいずれかとして定義でき、組み合わせや再利用が可能です。
カレンダーの組み合わせの例としては、月曜から金曜までの5日間を通常の稼働日とするカレンダーと、その年の祝祭日を指定するカレンダーを組み合わせて使用することができます。
再利用とは、例えば、稼働日カレンダーを一度定義して、拠点毎に休業日など必要に応じて非稼働日を指定することをいいます。

ジョブ定義画面の左側ペインから、実行計画＞カレンダーを選択し、右上の新規カレンダーボタンをクリックします

任意のカレンダー名を入力し、登録をクリック

カレンダー一覧に登録したものが表示されるので、カレンダー名をクリックし、タイトルなどを入力して、右下の周期追加ボタンをクリック

周期タイプを平日にして、月曜〜金曜をチェックして周期追加ボタンをクリック

これで平日カレンダーが登録できましたが、リリースしないと使用できないので、右上のリリースポタンをクリックすると未リリースからリリース済みに変わります

同様に休業日タイプの休日カレンダーを作成します。周期追加で周期タイプを国民の祝日で選択、全てにチェックを入れて周期追加します。

登録できたらリリースします

2. スケジュールの作成

次にジョブ定義画面でスケジュールを作成するワークフローを選択し、実行計画からスケジュールを選択、新規スケジュール作成をクリックします。

作成したスケジュール名を一覧から選択し、適用するワークフロー名を選択します。

チェックボックス「オーダー自動登録」は、実行計画の実行時にスケジュールを適用することを指定します。このステップで作成されたオーダーは、計画中状態で追加されます。
チェックボックス「計画時にコントローラーにオーダー登録」は、現在の実行計画の実行時または以前の実行時に作成された計画中のオーダーがコントローラーに送信され、オーダー保留状態になることを指定します。

ランタイム設定
右上のランタイムボタンをクリックし、まずカレンダーを指定します

登録したカレンダーの右側の開始時間のプラスボタンをクリックすると、開始時刻の設定ができます

指定した稼働日が休日だった場合、実行する、実行しない、翌稼働日または前稼働日に実行することも指定できます。
一番右側の制限のプラスボタンでは、さらに特定の曜日や日・週・月ごと、月初・月末から指定日数のみなど様々な実行タイミングを指定することができます。
ランタイムを設定後リリースボタンをクリックすると、スケジュールがリリース済みになります

実行計画の作成
実行計画画面の実行計画作成ボタンをクリックするとスケジュールが登録されます。

一部のジョブだけ特定の日時に実行する（しない）方法

特定の日にワークフロー中の一部のジョブだけ実行したい（したくない）場合などには、許可時間設定を使用できます。許可時間とは、ジョブごとに設定するジョブ実行可能な時間で、ジョブオプションで曜日、開始時間、実行時間帯を指定できます。

指定したジョブを実行しないでワークフロー実行を停止
ジョブオプションで「許可時間ではないときスキップ」をチェックせずに、定義されているスケジュールの実行日（例：月曜〜金曜）に含まれる曜日（金曜）を許可時間設定で指定すると、許可した金曜日以外はオーダーが停止し次の許可時間になるまで次のジョブは実行されません。

指定したジョブをスキップしてワークフロー実行を継続
ジョブオプションで「許可時間ではないときスキップ」をチェックし、定義されているスケジュールの実行日（例：月曜〜金曜）に含まれる曜日（金曜）を許可時間設定で指定、そのジョブは金曜日だけ実行され、他の日にはスキップされて次のジョブが実行継続されます。

サンプルワークフロー：15_AdmissionTimes

(4) ワークフローのイベント実行

ファイル検知などのイベントをきっかけに、ワークフローを実行することができます。

1. ファイル監視によるワークフロー実行

任意のエージェントが稼働するサーバーのディレクトリ及びファイルを監視して、ファイルが書き込まれたことをきっかけとしてワークフローを実行することができます。

ジョブ定義画面のインベントリーからファイルオーダーソースを選択し、新規作成で名称を入力ます。

タイトルは適当に入力し、実行するワークフローとエージェントを選択します。
監視するディレクトリーのフルパスを入力し、パターンに監視するファイル名を入力します。
ファイル名は、完全一致でも部分一致でも可能ですが、部分一致の場合はJava正規表現を使用します。
例：
すべてのファイル名に一致: .*
.csv拡張子のファイル名に一致: .*.csv$

遅延には、ファイル検知の間隔（秒）を入力します。
ファイル書き込みを検知してから、タイムスタンプとサイズを監視し、遅延で指定した間隔でもしどちらかが変化していたら再度次の遅延間隔で監視が続けられます。
Windowsの場合ファイル書き込み中は他のプロセスがファイルを開くことができませんが、Linux系の場合書き込み途中でもファイルが開けますので、書き込み途中のものを開かないようにするためです。
大きなファイルを書き込み終了までワークフロー実行させない確実な方法は、ファイル書き込みプログラム側で書き込み時は検知ファイル名とは異なる一時ファイル名を使用し、書き込み完了確認してから検知ファイル名に変更します。

サンプルワークフロー：08_FileWatching

ファイルオーダーソースでは、ファイル検知しワークフロー実行後に検知ファイルの処理はしません。
検知ファイルの移動・削除・リネームなどのためにJITLファイル操作ジョブが用意されています。

JITLファイル操作ジョブは、V.2.1.1以降が必要です

ワークフローにこれらのJITLジョブを組み込むによって、一連のファイル処理を穴埋め式で作成できます。

2. APIによるワークフロー実行

JS7® JobSchedulerでは、JOCコックピットからだけでなく、APIから操作を実行できますので、外部アプリケーションからJS7® JobSchedulerのすべての操作が可能です。
APIには、REST APIとPowerShell CLIが用意されていますので環境によって使い分けできます。
詳しくは以下をご参照ください。

4. オブジェクト命名規則

JS7®JobSchedulerでは下記のようなオブジェクトが使用できます。
ワークフロー、ジョブ、変数、ロック、ファイルオーダーソース、ジョブリソース、フォルダー、カレンダー、スケジュール
これらのオブジェクト名は、日本語を含むUnicodeで表現できる文字を使用できますが、基本Javaの識別子の命名規則に準じます。

主な制限としては

  • 制御文字は使えません：[^\x00-\x1F\x7F\x80-\x9F]
  • dots '.', underscore '_' and dash '-' 以外の句読点は使えません、
  • dots '.', dash '-'は先頭文字に使えません。
  • Javaの予約語は使えません。
  • オブジェクト名最大長は、ルートフォルダーからのパス名を含めて255 Unicode文字
  • オブジェクト名はオブジェクトタイプ（ワークフロー、ジョブ、スケジュールなど）毎に一意（ユニーク）である必要があります。

詳しくは以下をご参照ください。

5. その他ナレッジベースリンク

JS7® JobSchedulerワークフロー間連携　https://qiita.com/satoruf/items/64b185880f4ac0e05c5d