This topic describes how to create and manage applications for XXL-JOB task scheduling. It covers basic configuration, advanced settings, and connection methods.
Create an application
Before using XXL-JOB scheduled tasks, you must create an application.
Step 1: Basic task configuration
Log on to the MSE XXL-JOB console, and select a region in the top navigation bar.
In the left navigation bar, select .
Click the target instance. In the navigation pane on the left, go to Application Management and click Create Application.
In the Create Application pane, enter an AppName and a Name. Configure advanced settings as needed, and then click OK.
Category
Item
Description
Default Value
Basic Application Information
AppName
The unique identifier that associates an executor with an application during registration. This identifier must be globally unique.
None
Name
The name of the application. The name can be in Chinese or English.
None
AccessToken
The authentication token for executor registration. You can specify a custom token or let the system generate one. For security, use a unique token for each application.
None
Application Type
Normal Application: Requires an executor connected using the XXL-JOB SDK for Java, Go, or Python.
HTTP Application: Does not require an SDK. Backend nodes are automatically discovered by configuring a domain name or a Kubernetes service. Scheduling is performed over the HTTP protocol. Requires engine version 2.3.0 or later.
Normal Application
Advanced Application Configuration
Traffic Shaping
Application-level traffic shaping. If you enable this feature, you can set the task concurrency to prevent the application from being overwhelmed. High-priority tasks are executed first.
Off
Task Execution Queue Size
The maximum number of task instances that can run concurrently for an application. Task instances that exceed this limit are not discarded. They are placed in a queue to wait for execution.
100
Log Collection
If you enable log collection, logs are pulled from the executor and saved in the cloud after each task execution. This helps with future troubleshooting. If tasks are scheduled frequently, do not enable this feature, because it may overload the executor.
Off
Tag-based Routing Policy
If a task has no tags, schedule all machines.
If a task has no tags, schedule only untagged machines.
For more information about how to add tags to an executor, see How to perform a grayscale release for tasks using tag-based routing.
If a task has no tags, schedule all machines
Step 2: Connection configuration
After creating the application, click Connection Configuration in the Actions column of the application to obtain the connection configuration for the executor.
Connection Method 1: Modify the Spring Boot configuration file.
xxl.job.admin.addresses=http://xxljob-xxxx.schedulerx.mse.aliyuncs.com xxl.job.accessToken=xxxxxxx xxl.job.executor.appname=xxxxxxxConnection Method 2: Restart the application with -D parameters (no changes to code or configuration files required). Rebuilding the image is not required.
java -Dxxl.job.admin.addresses=http://xxljob-xxxx.schedulerx.mse.aliyuncs.com -Dxxl.job.accessToken=xxxxxxx -Dxxl.job.executor.appname=xxxxxxx app.jar
Edit an application
Log on to the MSE XXL-JOB console, and select a region in the top navigation bar.
In the left navigation bar, select .
Click the target instance. In the navigation pane on the left, go to Application Management. In the Actions column of the target application, click Edit.
In the Edit Application pane, modify the Name, AccessToken, Application Type, Traffic Shaping, and Log Collection settings. Then, click OK.
Delete an application
You can delete an application if you no longer use XXL-JOB scheduled tasks.
Log on to the MSE XXL-JOB console, and select a region in the top navigation bar.
In the left navigation bar, select .
Click the target instance. In the navigation pane on the left, go to Application Management. In the Actions column of the target application, click Delete.
In the Delete Application dialog box, enter the application name and then click OK.