本文檔將介紹如何使用 Java 版 SDK 來提交一個作業,目的是統計一個日志文件中“INFO”,”WARN”,”ERROR”,”DEBUG”出現的次數。
步驟
作業準備
上傳數據文件到 OSS
使用示例代碼
編譯打包
上傳到 OSS
使用 SDK 創建(提交)作業
查看結果
1. 作業準備
本作業是統計一個日志文件中“INFO”,”WARN”,”ERROR”,”DEBUG”出現的次數。
該作業包含 3 個任務:split,count 和 merge:
split 任務會把日志文件分成 3 份。
count 任務會統計每份日志文件中“INFO”,”WARN”,”ERROR”,”DEBUG”出現的次數(count 任務需要配置 InstanceCount 為 3,表示同時啟動 3 臺機器運行 count 程序)。
merge 任務會把 count 任務的結果統一合并起來。
DAG圖例:
(1) 上傳數據文件到OSS
下載本例所需的數據:log-count-data.txt
將 log-count-data.txt 上傳到:oss://your-bucket/log-count/log-count-data.txt
your-bucket 表示您自己創建的 bucket,本例假設 region 為:cn-shenzhen.
(2) 使用示例代碼
本示例將采用 Java 來編寫作業任務,使用 Maven 來編譯,推薦使用 IDEA:https://www.jetbrains.com/idea/download/ 選擇 Community 版本(免費)。
示例程序下載:java-log-count.zip
這是一個 Maven 工程。
無需修改代碼。
(3) 編譯打包
運行命令編譯打包:
mvn package
即可在 target 得到下面 3 個 jar 包:
batchcompute-job-log-count-1.0-SNAPSHOT-Split.jar
batchcompute-job-log-count-1.0-SNAPSHOT-Count.jar
batchcompute-job-log-count-1.0-SNAPSHOT-Merge.jar
再將 3 個 jar 包,打成一個 tar.gz 壓縮包,命令如下:
> cd target #進入 target 目錄
> tar -czf worker.tar.gz *SNAPSHOT-*.jar #打包
運行以下命令,查看包的內容是否正確:
> tar -tvf worker.tar.gz
batchcompute-job-log-count-1.0-SNAPSHOT-Split.jar
batchcompute-job-log-count-1.0-SNAPSHOT-Count.jar
batchcompute-job-log-count-1.0-SNAPSHOT-Merge.jar
BatchCompute 只支持以 tar.gz 為后綴的壓縮包,請注意務必用以上方式(gzip)打包,否則將會無法解析。
(4) 上傳到OSS
本例將 worker.tar.gz 上傳到 OSS 的 your-bucket 中:oss://your-bucket/log-count/worker.tar.gz
如要運行本例子,您需要創建自己的 bucket,并且把 worker.tar.gz 文件上傳至您自己創建的 bucket 路徑下。
2. 使用SDK創建(提交)作業
(1) 新建一個Maven工程
在 pom.xml 中增加以下 dependencies:
<dependencies>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-batchcompute</artifactId>
<version>5.2.0</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>3.2.3</version>
</dependency>
</dependencies>
請確定使用最新版本的 SDK:Java 版 SDK
(2) 新建一個Java類: Demo.java
提交作業需要指定集群 ID 或者使用匿名集群參數。本例子使用匿名集群方式進行。匿名集群需要配置2個參數,其中:
可用的鏡像 ID,可以使用系統提供的 Image,也可以自行制作鏡像。
實例規格(InstanceType,實例類型),請看 目前支持類型 。
在 OSS 中創建存儲 StdoutRedirectPath(程序輸出結果)和 StderrRedirectPath(錯誤日志)的文件路徑,本例中創建的路徑為oss://your-bucket/log-count/logs/
如需運行本例,請按照上文所述的變量獲取以及與上文對應的您的 OSS 路徑對程序中注釋中的變量進行修改。
Java SDK 提交程序模板如下,程序中具體參數含義請參照SDK接口說明。
Demo.java:
/*
* IMAGE_ID:ECS 鏡像,由上文所述獲取
* INSTANCE_TYPE: 實例類型,由上文所述獲取
* REGION_ID:提交作業的地域,此項需與上文 OSS 存儲 worker 的bucket 地域一致
* ACCESS_KEY_ID: AccessKeyId 可以由上文所述獲取
* ACCESS_KEY_SECRET: AccessKeySecret 可以由上文所述獲取
* WORKER_PATH:由上文所述打包上傳的 worker 的 OSS 存儲路徑
* LOG_PATH:錯誤反饋和 task 輸出的存儲路徑,logs 文件需事先自行創建
*/
import com.aliyuncs.batchcompute.main.v20151111.*;
import com.aliyuncs.batchcompute.model.v20151111.*;
import com.aliyuncs.batchcompute.pojo.v20151111.*;
import com.aliyuncs.exceptions.ClientException;
import java.util.ArrayList;
import java.util.List;
public class Demo {
static String IMAGE_ID = "img-ubuntu";; //這里填寫您的 ECS 鏡像 ID
static String INSTANCE_TYPE = "ecs.sn1.medium"; //根據 region 填寫合適的 InstanceType
static String REGION_ID = "cn-shenzhen"; //這里填寫 region
static String ACCESS_KEY_ID = ""; //"your-AccessKeyId"; 這里填寫您的 AccessKeyId
static String ACCESS_KEY_SECRET = ""; //"your-AccessKeySecret"; 這里填寫您的 AccessKeySecret
static String WORKER_PATH = ""; //"oss://your-bucket/log-count/worker.tar.gz"; // 這里填寫您上傳的 worker.tar.gz 的 OSS 存儲路徑
static String LOG_PATH = ""; // "oss://your-bucket/log-count/logs/"; // 這里填寫您創建的錯誤反饋和 task 輸出的 OSS 存儲路徑
static String MOUNT_PATH = ""; // "oss://your-bucket/log-count/";
public static void main(String[] args){
/** 構造 BatchCompute 客戶端 */
BatchCompute client = new BatchComputeClient(REGION_ID, ACCESS_KEY_ID, ACCESS_KEY_SECRET);
try{
/** 構造 Job 對象 */
JobDescription jobDescription = genJobDescription();
//創建 Job
CreateJobResponse response = client.createJob(jobDescription);
//創建成功后,返回 jobId
String jobId = response.getJobId();
System.out.println("Job created success, got jobId: "+jobId);
//查詢 job 狀態
GetJobResponse getJobResponse = client.getJob(jobId);
Job job = getJobResponse.getJob();
System.out.println("Job state:"+job.getState());
} catch (ClientException e) {
e.printStackTrace();
System.out.println("Job created failed, errorCode:"+ e.getErrCode()+", errorMessage:"+e.getErrMsg());
}
}
private static JobDescription genJobDescription(){
JobDescription jobDescription = new JobDescription();
jobDescription.setName("java-log-count");
jobDescription.setPriority(0);
jobDescription.setDescription("log-count demo");
jobDescription.setJobFailOnInstanceFail(true);
jobDescription.setType("DAG");
DAG taskDag = new DAG();
/** 添加 split task */
TaskDescription splitTask = genTaskDescription();
splitTask.setTaskName("split");
splitTask.setInstanceCount(1);
splitTask.getParameters().getCommand().setCommandLine("java -jar batchcompute-job-log-count-1.0-SNAPSHOT-Split.jar");
taskDag.addTask(splitTask);
/** 添加 count task */
TaskDescription countTask = genTaskDescription();
countTask.setTaskName("count");
countTask.setInstanceCount(3);
countTask.getParameters().getCommand().setCommandLine("java -jar batchcompute-job-log-count-1.0-SNAPSHOT-Count.jar");
taskDag.addTask(countTask);
/** 添加 merge task */
TaskDescription mergeTask = genTaskDescription();
mergeTask.setTaskName("merge");
mergeTask.setInstanceCount(1);
mergeTask.getParameters().getCommand().setCommandLine("java -jar batchcompute-job-log-count-1.0-SNAPSHOT-Merge.jar");
taskDag.addTask(mergeTask);
/** 添加 Task 依賴: split-->count-->merge */
List<String> taskNameTargets = new ArrayList();
taskNameTargets.add("merge");
taskDag.addDependencies("count", taskNameTargets);
List<String> taskNameTargets2 = new ArrayList();
taskNameTargets2.add("count");
taskDag.addDependencies("split", taskNameTargets2);
//dag
jobDescription.setDag(taskDag);
return jobDescription;
}
private static TaskDescription genTaskDescription(){
AutoCluster autoCluster = new AutoCluster();
autoCluster.setInstanceType(INSTANCE_TYPE);
autoCluster.setImageId(IMAGE_ID);
//autoCluster.setResourceType("OnDemand");
TaskDescription task = new TaskDescription();
//task.setTaskName("Find");
//如果使用 VPC,需要配置 cidrBlock, 請確保 IP 段不沖突
Configs configs = new Configs();
Networks networks = new Networks();
VPC vpc = new VPC();
vpc.setCidrBlock("192.168.0.0/16");
networks.setVpc(vpc);
configs.setNetworks(networks);
autoCluster.setConfigs(configs);
//打包上傳的作業的 OSS 全路徑
Parameters p = new Parameters();
Command cmd = new Command();
//cmd.setCommandLine("");
//打包上傳的作業的 OSS 全路徑
cmd.setPackagePath(WORKER_PATH);
p.setCommand(cmd);
//錯誤反饋存儲路徑
p.setStderrRedirectPath(LOG_PATH);
//最終結果輸出存儲路徑
p.setStdoutRedirectPath(LOG_PATH);
task.setParameters(p);
task.addInputMapping(MOUNT_PATH, "/home/input");
task.addOutputMapping("/home/output",MOUNT_PATH);
task.setAutoCluster(autoCluster);
//task.setClusterId(clusterId);
task.setTimeout(30000); /* 30000 秒*/
task.setInstanceCount(1); /** 使用 1 個實例來運行 */
return task;
}
}
正常輸出樣例:
Job created success, got jobId: job-01010100010192397211
Job state:Waiting
3. 查看作業狀態
您可以用 SDK 中的 獲取作業信息方法獲取作業狀態:
//查詢 job 狀態
GetJobResponse getJobResponse = client.getJob(jobId);
Job job = getJobResponse.getJob();
System.out.println("Job state:"+job.getState());
Job 的 state 可能為:Waiting、Running、Finished、Failed、Stopped.
4. 查看結果
您可以登錄 batchcompute 控制臺 查看 job 狀態。
Job 運行結束,您可以登錄 OSS 控制臺 查看your-bucket 這個 bucket 下面的這個文件:/log-count/merge_result.json。
內容應該如下:
{"INFO": 2460, "WARN": 2448, "DEBUG": 2509, "ERROR": 2583}
您也可以使用OSS 的 SDK來獲取結果。