您可以使用 SchedulerX 2.0 为您部署在 EDAS 上的独立 Java 应用、Spring 或 Spring Boot 应用实现分布式任务调度能力。

前提条件

由于 SchedulerX 是 EDAS 的组件,所以在使用 SchedulerX 为应用接入任务调度能力前,需要先在 EDAS 完成以下工作:

操作流程

应用接入任务调度能力的流程如下:

  1. 在 EDAS 控制台创建任务调度分组。
  2. 为应用接入任务调度。
  3. 将应用部署到 EDAS。

创建任务调度分组

您需要首先为应用创建任务调度分组。该分组的 Group ID 将作为应用接入任务调度的配置参数。

  1. 登录EDAS控制台
  2. 在左侧导航栏中选择组件中心 > 分布式任务调度2.0
  3. 分布式任务调度2.0左侧导航栏选择应用管理
  4. 应用管理页面选择地域命名空间,然后单击创建
    命名空间
  5. 创建应用分组对话框的应用名右侧的列表中选择应用,在 Group ID 右侧的文本框中输入应用分组名称,然后单击确定

    在选择应用后,Group ID 右侧的文本框中会填写一个默认 ID,格式为 <App name>.defaultGroup<App name>为已选择应用的应用名。可以使用该默认值,也可以重新输入。Group ID 要求在当前命名空间内唯一,否则将创建失败。

    创建应用分组
    创建完成后,自动返回应用管理页面,在应用列表中查看应用分组是否已存在。

为应用接入任务调度

您需要在应用程序中接入任务调度,主要包含以下 3 步:

  1. 初始化 SchedulerxWorker。
  2. 新建实现任务调度的类。
  3. 将应用部署到 EDAS。
  1. 初始化 SchedulerxWorker

    针对不同应用,在初始化 SchedulerxWorker 的时候会有所区别,下面分别说明:

    • 独立 Java 应用
      1. 在应用程序的pom.xml文件中添加 SchedulerxWorker 依赖。

        <dependency>
        <groupId>com.aliyun.schedulerx</groupId>
        <artifactId>schedulerx2-worker</artifactId>
        // 请参见客户端版本说明,使用最新客户端版本。
        <version>${schedulerx2.version}</version>
        </dependency>                   
      2. 在 main 函数中初始化 SchedulerxWorker。

        /**
        * 初始化 SchedulerX 客户端
        * @throws Exception 初始化失败异常
        */
        private static void initSchedulerxWorker() throws Exception{
         String groupId = "schedulerx-server.defaultGroup";
         SchedulerxWorker schedulerxWorker = new SchedulerxWorker();
         schedulerxWorker.setGroupId(groupId);
         schedulerxWorker.init();
         LOGGER.info("SchedulerxWorker init success. groupId={}", groupId);
        }                                       
        说明
        • 当一个应用有多个分组时,例如应用 animals 包含两个分组 animals.dogsanimals.cats。此时不用申请两批实例分别接入 2 个分组,一个应用可以同时接入 2 个分组,在客户端中将这 2 个分组配置到groupId=后面,用英文逗号(,)分隔即可,例如groupId=animals.dogs,animals.cats
        • 在初始化 SchedulerxWorker 客户端时,根据实际业务,如果还有其它配置需求,可以参考 SchedulerxWorker配置参数说明增加配置。
    • Spring 应用
      1. 在应用程序的pom.xml文件中添加 SchedulerxWorker 依赖。

        <dependency>
        <groupId>com.aliyun.schedulerx</groupId>
        <artifactId>schedulerx2-worker</artifactId>
        // 请参见客户端版本说明,使用最新客户端版本。
        <version>${schedulerx2.version}</version>
        </dependency>                    
      2. 在 xml 配置文件中初始化 SchedulerxWorker(注入 Bean)。

            <bean id="schedulerxWorker" class="com.alibaba.schedulerx.worker.SchedulerxWorker">
                <property name="groupId">
                //填写之前创建的分组的 Group ID。可以配置多个分组,以英文逗号(,)分隔。
                  <value>${groupId}</value>
                </property>
            </bean>                   
    • Spring Boot 应用
      1. 在应用程序的pom.xml文件中添加 SchedulerxWorker 依赖。

        schedulerx2.version 请使用客户端版本说明中最新客户端版本。

        <dependency>
        <groupId>com.aliyun.schedulerx</groupId>
        <artifactId>schedulerx2-spring-boot-starter</artifactId>
        <version>${schedulerx2.version}</version>
        </dependency>                   
      2. application.properties文件中添加之前创建的分组的 Group ID。

        spring.schedulerx2.groupId=${groupId}                   
        说明 当一个应用有多个分组时,例如应用 animals 包含两个分组 animals.dogsanimals.cats。此时不用申请两批实例分别接入 2 个分组,一个应用可以同时接入 2 个分组,在客户端中将这 2 个分组配置到groupId=后面,用英文逗号(,)分隔即可,例如groupId=animals.dogs,animals.cats
  2. 新建实现调度任务的类。

    在应用中增加类JobProcessor,实现任务调度。本文介绍如何实现最简单的定时打印“Hello SchedulerX2.0”,JobProcessor 的代码如下:

    说明 如果您想使用其它调度任务,请参见 Demo 示例。
    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);
        }
    }                        
  3. 将应用部署到 EDAS。

    将应用打包,并部署到 EDAS。详情请参见应用部署概述(ECS 集群)应用部署概述(K8s集群)

执行结果

  1. 登录 EDAS 控制台。
  2. 在左侧导航栏中选择组件中心 > 分布式任务调度2.0,然后在左侧导航栏单击应用管理
  3. 应用管理页面选择之前创建的分组所在地域命名空间,然后在之前创建的分组的操作列单击连接机器

    • 如果接入成功,可以看到机器列表。
    • 如果接入失败,会弹出暂无可用机器的提示信息。

后续步骤

在您的应用接入调度任务并部署到 EDAS 后,就可以创建调度任务了。详情请参见创建调度任务