This topic describes how to create and manage applications for XXL-JOB task scheduling. It covers basic configurations, advanced settings, and integration methods.
Create an application
Before you can use XXL-JOB scheduled tasks, you must first create an application.
Step 1: Configure basic task settings
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, under Application Management, click Create Application.
On the Create Application panel, enter an AppName and a Name. Configure advanced settings as needed, and then click OK.
Configuration Category
Configuration Item
Description
Default Value
Basic Application Information
AppName
A unique identifier that associates an executor with the application during registration. It must be globally unique.
None
Name
The name of the application. Chinese and English are supported.
None
AccessToken
The authentication token for executor registration. You can customize it or have the system generate it automatically. For security, we recommend using a different token for each application.
None
Application Type
Standard application: Requires an executor integrated using the XXL-JOB software development kit (SDK) for Java, Go, or Python.
HTTP application: Does not require SDK integration. Backend nodes are automatically discovered by configuring a domain name or a Kubernetes service. Scheduling uses the HTTP protocol. Requires engine version 2.3.0 or later.
Standard application
Advanced Application Configuration
Throttling
Application-level traffic shaping. When enabled, you can set the task concurrency to prevent the application from becoming unresponsive. 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
Tag-based Routing Policy
If a task does not have a specified tag, schedule all machines.
If a task does not have a specified tag, schedule only untagged machines.
For more information about how to add tags to an executor, see How to perform canary release for tasks using tag-based routing.
If no tags are specified for a job, it is scheduled on all machines.
Step 2: Configure integration
After you create the application, click Integration Configuration in the Actions column of the application to obtain the integration configuration for the executor.
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=xxxxxxxMethod 2: Restart the application with the -D parameter. This method does not require you to change the code or configuration files, or rebuild the image.
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, under Application Management, click Edit in the Actions column of the target application.
On the Edit Application panel, modify the Name, AccessToken, Application Type, Throttling, and Log Collection, and then click OK.
Delete an application
You can delete an application if you no longer need it for 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, under Application Management, click Delete in the Actions column of the target application.
In the Delete Application dialog box, enter the application name and click OK.