SchedulerX:Connect a Spring Boot application to SchedulerX

1.1 Basic configuration

1.2 Notification configuration

1. Add the required dependency to the pom.xml file.

   Add the required SchedulerxWorker dependency to the pom.xml file of your Spring Boot application to allow the Spring Boot application to use the features provided by SchedulerX.

   Note

   SchedulerX supports Spring Boot 2.x and 3.x applications.

   <dependency>
     <groupId>com.aliyun.schedulerx</groupId>
     <artifactId>schedulerx2-spring-boot-starter</artifactId>
     <version>${schedulerx2.version}</version>
     <!-- If you use Logback, you must exclude Log4j and Log4j 2. -->
     <exclusions>
       <exclusion>
         <groupId>org.apache.logging.log4j</groupId>
         <artifactId>log4j-api</artifactId>
       </exclusion>
       <exclusion>
         <groupId>org.apache.logging.log4j</groupId>
         <artifactId>log4j-core</artifactId>
       </exclusion>
       <exclusion>
         <groupId>log4j</groupId>
         <artifactId>log4j</artifactId>
       </exclusion>
     </exclusions>
   </dependency>                   

   Important

   Replace <version>${schedulerx2.version}</version> with the latest agent version. Example: <version>1.11.5</version>. For more information, see Agent release notes.

2. Configure parameters.

   In the application.properties configuration file of the Spring Boot application, add the parameters required by SchedulerxWorker, such as connection information and authentication information. Such parameters are required for the Spring Boot application to connect to the SchedulerX application.

   spring.schedulerx2.endpoint=${endpoint}
   spring.schedulerx2.namespace=${namespace}
   spring.schedulerx2.groupId=${groupId}
   # If your agent version is 1.2.1 or later, you must specify the application key.
   spring.schedulerx2.appKey=${appKey}
   
   # If your agent version is earlier than 1.2.1, you must specify an AccessKey ID and an AccessKey secret. To enable other special configurations, such as defining job synchronization and automatic synchronization of Spring jobs in the configuration file, you must configure the following parameters:
   #spring.schedulerx2.aliyunAccessKey=${aliyunAccessKey}
   #spring.schedulerx2.aliyunSecretKey=${aliyunSecretKey}                  

   Parameter sources:

   Log on to the SchedulerX console. In the left-side navigation pane, click Applications. On the Applications page, find the application that you want to manage and click AccessConfig in the Operation column. In the AccessConfig panel, select Spring Boot from the drop-down list.

   

   Important

   Check whether SchedulerX and the agent are in the same region. If not, the agent fails to connect to SchedulerX.

   If your Spring Boot application runs on a non-Alibaba Cloud server or in an on-premises environment, make sure that you have enabled Internet access to the Spring Boot application and created a SchedulerX application in the Internet region. For more information, see Connect to SchedulerX over the Internet from an on-premises environment.

   Note

   If your Spring Boot application contains multiple service modules or you want to isolate CRON jobs for permission management, you can create multiple applications in the SchedulerX console to implement fine-grained management of CRON jobs. For example, applications animals.dog and animals.cat are created for the application animals in the SchedulerX console. In this case, you do not need to separately apply for workers for the two applications. Instead, you can simply specify spring.schedulerx2.groupId=${groupId} in the application.properties configuration file. Replace ${groupId} with the application names. Separate multiple application names with commas (,). Example: spring.schedulerx2.groupId=animals.dog,animals.cat.

   Parameter description:

   • endpoint: the endpoint of SchedulerxWorker. The value of this parameter must match the endpoint of the region in which your application is deployed. For more information, see Endpoints.

   • namespace: the ID of the namespace to which the application belongs. You can view the namespace ID on the Namespaces page of the SchedulerX console.

   • groupId and appKey: the ID and key of the application. You can view the values on the Applications page of the SchedulerX console.

   • aliyunAccessKey and aliyunSecretKey: the AccessKey ID and AccessKey secret of your Alibaba Cloud account. You can view the AccessKey pair on the Security Management page of the User Management console.

   • The following table describes the parameters that you can configure based on your business requirements.

     Parameter	Description	Value	Initial version
     spring.schedulerx2.enabled	Specifies whether to enable the starter of SchedulerX 2.0. Default value: true. You do not need to configure this parameter.	true false	0.1.7
     spring.schedulerx2.endpoint	The endpoint of the specified region. For more information, see Endpoints.	N/A	0.1.7
     spring.schedulerx2.namespace	The UID of the namespace. You can view the namespace UID on the Namespaces page of the SchedulerX console.	N/A	0.1.7
     spring.schedulerx2.groupId	The ID of the application. You can view the application ID on the Applications page of the SchedulerX console.	N/A	0.1.7
     spring.schedulerx2.appKey	The key of the application. You can view the application key on the Applications page of the SchedulerX console.	N/A	1.2.1
     spring.schedulerx2.host	The actual IP addresses if multiple IP addresses exist. Multiple IP addresses may exist if the agent uses a VPN or multiple network interface cards (NICs).	N/A	0.1.7
     spring.schedulerx2.port	The port on which the agent listens. If you do not specify a port, the system randomly selects an available port.	N/A	0.1.7
     spring.schedulerx2.blockAppStart	Specifies whether to block the startup of the application if SchedulerX fails to complete the initialization. Default value: true.	true false	1.1.0
     spring.schedulerx2.shareContainerPool	Specifies whether to allow all jobs on agents to share the thread pool. Default value: false.	true false	1.2.1.2
     spring.schedulerx2.sharePoolSize	The size of the thread pool if you allow all jobs to share the pool. Default value: 64.	N/A	1.2.1.2
     spring.schedulerx2.label	The labels. You can add labels to agents so that you can use labels to specify workers for job management. This feature is suitable for canary release and stress testing scenarios.	N/A	1.2.2.2
     spring.schedulerx2.enableCgroupMetrics	Specifies whether to use the cgroup to collect the metrics of an agent. Default value: false. You must manually enable this feature in a Kubernetes environment.	true false	1.2.2.2
     spring.schedulerx2.cgroupPathPrefix	The path of the cgroup in the container.	The default path is /sys/fs/cgroup/cpu/. If the path already exists, you do not need to configure this parameter.	1.2.2.2
     spring.schedulerx2.enableHeartbeatLog	Specifies whether to display heartbeat logs in the ${user.home}/logs/schedulerx/heartbeat.log file. Default value: true.	true false	1.2.4
     spring.schedulerx2.mapMasterStatusCheckInterval	The interval at which SchedulerX checks whether all tasks are complete in the Map model. Unit: milliseconds. If you want to increase the scheduling frequency of second-granularity jobs, configure this parameter.	3000	1.2.5.2
     spring.schedulerx2.enableSecondDelayCycleIntervalMs	Specifies whether to enable millisecond precision for second-granularity jobs. Default value: false. If you set this parameter to true, the scheduling interval specified in the console for second-granularity jobs is interpreted in milliseconds instead of seconds. This increases the scheduling frequency of your jobs.	true false	1.2.5.2
     spring.schedulerx2.broadcastMasterExecEnable	Specifies whether the primary node is required to run a broadcast job. Default value: true.	true false	1.8.13
     spring.schedulerx2.broadcastDispatchRetryTimes	The maximum number of retries after broadcasting fails. By default, no retry is performed. The retry interval is fixed to 2 seconds.	3	1.8.13
     spring.schedulerx2.enableSecondDelayStandaloneDispatch	Specifies whether to enable dispatching of second-granularity standalone jobs. Default value: false.	true false	1.8.13

3. Create a JobProcessor class

   Create a JobProcessor class in the Spring Boot application to enable job scheduling.

   The following sample code shows how to schedule a simple JobProcessor class to periodically display a message. In this example, the message hello schedulerx2.0 is displayed.

   package com.aliyun.schedulerx.test.job;
   
   import com.alibaba.schedulerx.worker.domain.JobContext;
   import com.alibaba.schedulerx.worker.processor.JavaProcessor;
   import com.alibaba.schedulerx.worker.processor.ProcessResult;
   
   @Component
   public class MyHelloJob extends JavaProcessor {
   
       @Override
       public ProcessResult process(JobContext context) throws Exception {
           System.out.println("hello schedulerx2.0");
           return new ProcessResult(true);
       }
   }              

Log on to the Microservices Engine (MSE) console. In the left-side navigation pane, choose Task Scheduling > SchedulerX Version. On the SchedulerX Version page, click Applications in the left-side pane. Then, find the application that you want to manage and click View instances in the Operation column.