アプリケーションは SchedulerX における最上位の組織単位です。ジョブを作成する前にアプリケーションを作成し、その後、[アプリケーション] ページから接続済みワーカーのモニター、アクセス権限の管理、およびアプリケーションの削除を行います。
アプリケーションの作成
作成ウィザードは [基本構成] と [通知構成] の 2 ステップで構成されます。
前提条件
対象リージョンおよび名前空間内に SchedulerX インスタンスが存在すること
操作手順
SchedulerX コンソール にログインします。
トップナビゲーションバーからリージョンを選択します。
左側ナビゲーションウィンドウで [アプリケーション] をクリックします。
[アプリケーション] ページで名前空間を選択し、[アプリケーションの作成] をクリックします。
[基本構成] ステップで以下のパラメーターを設定し、[次のステップ] をクリックします。
基本情報
| パラメーター | 説明 | デフォルト |
|---|---|---|
| Application Name | アプリケーションの名前です。 | N/A |
| Application ID | 名前空間内での一意の識別子です。また、アプリケーションが SchedulerX に接続後、タスクグループ ID としても使用されます。名前空間内で一意である必要があります。一意でない場合、アプリケーションの作成は失敗します。Application Name の値を再利用できます。 | N/A |
| Description | アプリケーションのオプションの説明(64 文字以内)です。 | N/A |
| app type | 標準的なデプロイメントには general app を、Kubernetes ジョブ対応の Kubernetes クラスター内にデプロイする場合は k8s App を選択します。 | general app |
| Edition | このアプリケーションで使用する SchedulerX のエディションです。要件に応じて選択してください。 | Professional |
| Log Server | 有効にすると、Log4j または Logback を設定して、分散タスクを含むすべてのタスクのスケジューリングログをコンソール上で直接確認できます。 | Enabled |
[Log Server] パラメーターは、[Basic] エディションの [general app] アプリケーションでは利用できません。この機能は、1 年間書き込み操作がない場合に自動的に無効化されます。必要に応じて、手動で再有効化してください。
マシンインスタンスのビジー状態構成
これらのしきい値により、ワーカーが「ビジー」とみなされるタイミングが決定されます。
| パラメーター | 説明 | デフォルト値 |
|---|---|---|
| load5 | 5 分間の CPU 負荷しきい値です。直近 5 分間における vCPU 使用率がこの値を超えると、ワーカーは「ビジー」としてマークされます。0 を設定すると、このチェックを無効化できます。 | 0 |
| メモリ使用量 | 直近 5 分間の平均メモリ使用率がこのパーセンテージを超えると、ワーカーは「ビジー」としてマークされます。 | 90% |
| ディスク使用率 | ディスク使用率がこのパーセンテージを超えると、ワーカーは「ビジー」としてマークされます。 | 95% |
| ビジーマシンのトリガー有効化 | ワーカーが「ビジー」状態のときに、タスクの実行を継続するかどうかを指定します。 | 有効 |
詳細構成
| パラメーター | 説明 | デフォルト |
|---|---|---|
| [タスクの最大数] | インスタンスグループがサポートするジョブの最大数です。 | 1000 |
| 自動拡張 | 自動スケーリングを有効化します。有効化すると、[グローバルタスク数] パラメーターを設定します。 | 無効 |
| フロー制御 | トラフィックの速度制限を有効化します。有効化すると、[同時実行タスクインスタンス数] パラメーターを設定します。 | 無効 |
| [同時実行タスクインスタンス数] | 本アプリケーションに対して同時に実行可能なジョブインスタンスの最大数です。この上限を超えるインスタンスはキューに待機します。 | 0 |
| カレンダー | このパラメーターを [カレンダーを指定] に設定した場合、ドロップダウンリストから [金融営業日](金融業務向けの取引日)または [営業日](標準的な営業日)を選択します。 | 毎日スケジュール |
通知の構成
[通知構成] ステップで、[通知チャネル] および [通知先連絡先] のパラメーターを設定します。通知受信者:
[連絡先グループ] — グループ内の全連絡先が通知を受信します。連絡先グループを作成するには、「通知連絡先および通知連絡先グループの作成」をご参照ください。
[連絡先] — 個別の連絡先を 1 人以上追加します。連絡先が存在しない場合は、[連絡先の追加] をクリックしてから、[連絡先の作成へ移動] をクリックして連絡先を作成します。
[通知チャネル]:
チャネル 説明 SMS テキストメッセージによるアラート Mail メールによるアラート webhook Webhook を使用したアラート(DingTalk、WeCom、Lark、またはカスタム) Telephone 電話呼び出しによるアラート [完了] をクリックします。アプリケーション一覧は、作成後に自動的にリフレッシュされます。
作成後に、アプリケーション一覧に表示される以下の値を確認してください:
[アプリケーション ID] — エージェントの初期化に必要です。また、この値はジョブグループのユニークな識別子でもあります。
[アプリケーションキー] — SDK リクエストによる API 呼び出しの認証に必要です。他のユーザーとこのキーを共有しないでください。
Webhook の構成
SchedulerX では、WeCom、Lark、DingTalk の Webhook をサポートしています。複数の Webhook ボット URL を指定する場合は、カンマ (,) で区切ります。
Webhook のセットアップ手順については、以下をご参照ください:
DingTalk チャットボットの Webhook の場合、キーワード SchedulerX(大文字小文字を区別)を指定する必要があります。このキーワードが指定されていないと、アラートは配信されません。
カスタム Webhook の場合、エンドポイントが以下の JSON フォーマットを解析できることを確認してください:
curl 'https://oapi.xxxxxxx' \
-H 'Content-Type: application/json' \
-d '{
"msgtype": "text",
"text": {
"content": "SchedulerX でトリガーされたアラートの詳細"
},
"at": {
"isAtAll": false
}
}'接続済みワーカーの表示
アプリケーションを SchedulerX に接続した後は、[アプリケーション] ページの [エグゼクーター] 列を確認して、ワーカーの接続性を検証します。
[アプリケーション] ページで、[Executors] 列の数を確認します。
値が
0の場合、ワーカーがアプリケーションに接続されていません。[アクセス構成] をクリックして、ワーカーを接続するために必要なエージェント構成を表示します。[エグゼキューター] 列の数字をクリックするか、[アクセス設定] をクリックすると、接続されているワーカーとその構成が表示されます。
ワーカーのステータス詳細
各ワーカーの IP アドレスの後に括弧で示される数字は、そのワーカー上で実行中の SchedulerX エージェントの数を表します。通常はワーカーあたり 1 つのエージェントが実行されますが、複数のエージェントもサポートされています。
ワーカーは「正常」または「ビジー」(1 つ以上のしきい値を超えている状態)のいずれかの状態になります。
デフォルトでは、SchedulerX はビジー状態のワーカーにジョブをスケジュールしません。すべてのワーカーがビジー状態の場合、ジョブはスケジュールされません。
ビジー状態のワーカーにもジョブをスケジュール可能にするには、アプリケーションの [操作] 列にある [編集] をクリックします。表示されるペインで、[マシンインスタンスのビジー状態構成] セクション内の [ビジーマシンのトリガー有効化] スイッチを無効化します。
RAM ユーザーへの権限付与
Alibaba Cloud アカウントまたは十分な権限を持つ RAM ユーザーを使用して、RAM ユーザーにアプリケーションへのアクセス権限を付与します。
[アプリケーション] ページで対象アプリケーションを見つけ、[操作] 列の [承認] をクリックします。
画面の指示に従って、RAM ユーザーの権限を構成します。
システムが 必要な権限がありません と表示した場合、[承認] をクリックした後、次のカスタムポリシーを Alibaba Cloud アカウントを通じて RAM ユーザーにアタッチします:{
"Version": "1",
"Statement": [
{
"Action": "ram:ListUsers",
"Resource": "*",
"Effect": "Allow"
}
]
}アプリケーションの削除
アプリケーションが不要になった場合は、削除できます。
アプリケーションを削除すると、アプリケーションおよび関連するすべてのタスクおよびワークフローが完全に削除されます。誤って削除したアプリケーションを復元するには、DingTalk グループ (23103656) を通じてテクニカルサポートまでお問い合わせください。
[アプリケーション] ページで対象アプリケーションを見つけ、[操作] 列の [削除] をクリックします。
[アプリケーションの削除] ダイアログボックスでアプリケーション情報を確認し、アプリケーション名を入力して、[OK] をクリックします。