JS Task API Examples: working with results
This example has been designed to work with the following environments:
- OS X 10.14+, Ubuntu 20.04 or Windows
- Node.js 16.0.0 or above
Prerequisites
Yagna service is installed and running with the try_golem app-key configured.
How to run examples
Create a project folder, initialize a Node.js project, and install the @golem-sdk/golem-js library.
mkdir golem-example
cd golem-example
npm init
npm i @golem-sdk/golem-js
Some of the examples require a simple worker.mjs script that can be created with the following command:
echo console.log("Hello Golem World!"); > worker.mjs
Copy the code into the index.mjs file in the project folder and run:
node index.mjs
Introduction
For each command that is run, you can obtain a result object.
Single command task
Let's look at the simple example: we will run a task that consists of single command and will print the content of the result object:
import { TaskExecutor } from "@golem-sdk/golem-js";
(async () => {
const executor = await TaskExecutor.create({
package: "529f7fdaf1cf46ce3126eb6bbcd3b213c314fe8fe884914f5d1106d4",
yagnaOptions: { apiKey: 'try_golem' }
, isSubprocess: true
});
const result = await executor.run(async (ctx) => (await ctx.run("node -v")));
console.log("Task result:", result);
await executor.end();
})();
In this example, our task consists of a single command: node -v. ctx.run() which returns an object that is then passed to the result variable and printed.
Index refers to the sequential number of a command (we have just one, and counting starts from 0), status of the result is "ok" which indicates the command was completed successfully, and the actual results of the command are under stdout.
Multi-command task
When you run your tasks in a batch that is concluded with .end():
import { TaskExecutor } from "@golem-sdk/golem-js";
(async () => {
const executor = await TaskExecutor.create({
package: "529f7fdaf1cf46ce3126eb6bbcd3b213c314fe8fe884914f5d1106d4",
yagnaOptions: { apiKey: 'try_golem' }
});
const result = await executor.run(async (ctx) => {
const res = await ctx
.beginBatch()
.uploadFile("./worker.mjs", "/golem/input/worker.mjs")
.run("node /golem/input/worker.mjs > /golem/input/output.txt")
.run('cat /golem/input/output.txt')
.downloadFile("/golem/input/output.txt", "./output.txt")
.end()
.catch((error) => console.error(error));
return res;
});
console.log(result);
await executor.end();
})();
you will receive an array of result objects:
In case you end your batch with the endStream() method:
import { TaskExecutor } from "@golem-sdk/golem-js";
(async () => {
const executor = await TaskExecutor.create({
package: "529f7fdaf1cf46ce3126eb6bbcd3b213c314fe8fe884914f5d1106d4",
yagnaOptions: { apiKey: 'try_golem' }
});
const result = await executor.run(async (ctx) => {
const res = await ctx
.beginBatch()
.uploadFile("./worker.mjs", "/golem/input/worker.mjs")
.run("node /golem/input/worker.mjs > /golem/input/output.txt")
.run('cat /golem/input/output.txt')
.downloadFile("/golem/input/output.txt", "./output.txt")
.endStream();
res.on("data", (result) => console.log(result));
res.on("error", (error) => console.error(error));
res.on("close", () => executor.end());
});
})();
Each data chunk will contain a result object, in the sequence that the commands were in within the batch:
What to do if your command fails?
When your command fails, the ExeUnit (the component responsible for running your image on the remote computer) will terminate all remote processes. As a result, the entire task will be terminated.
What will happen in such a case depends on the way your task is composed. Let's see it in examples.
In the below case, the user's commands are chained in a batch. An error occurs as the user tries to download the output.txt file from /golem/output/ folder while the file was created in the golem/input folder. This command will raise an error and the whole task will be terminated. The next command, listing the content of /golem/ folder, will not be executed at all.
import { TaskExecutor } from "@golem-sdk/golem-js";
(async () => {
const executor = await TaskExecutor.create({
package: "529f7fdaf1cf46ce3126eb6bbcd3b213c314fe8fe884914f5d1106d4",
yagnaOptions: { apiKey: 'try_golem' }
});
const result = await executor.run(async (ctx) => {
const res = await ctx
.beginBatch()
.run('cat /golem/input/output.txt > /golem/input/output.txt')
.downloadFile("/golem/output/output.txt", "./output.txt") // there is no such file in output folder
.run("ls -l /golem/")
.end()
.catch((error) => console.error(error));
return res
});
console.log(result);
await executor.end();
})();
While the user will receive the error message, the output is only for the failing command, not for all commands in the task.
The level of detail in the message depends on the type of method that causes the error.
In the case of the data transfer method, you will receive a message describing the cause of the error.
Let's see another example:
import { TaskExecutor } from "@golem-sdk/golem-js";
(async () => {
const executor = await TaskExecutor.create({
package: "529f7fdaf1cf46ce3126eb6bbcd3b213c314fe8fe884914f5d1106d4",
yagnaOptions: { apiKey: 'try_golem' }
, isSubprocess: true
});
// there is a mistake and instead of 'node -v' we call 'node -w'
const result = await executor.run(async (ctx) => (await ctx.run("node -w")));
console.log("Task result:", result);
await executor.end();
})();
In the case of the failure in the run() method, we receive the result object with following attributes:
result: 'Error',stdout: null,stderr: 'node: bad option: -w\n',- the command outputmessage: 'ExeScript command exited with code 9', the exit code of the command that failed.- message from the system. Thenode.jsexit code 9 means:Exit Code 9, Invalid Argument: This is employed when an unspecified option was given.
Final note: If you run your tasks using the map() or forEach() methods, TaskExecutor will stop the whole Job and will not continue after failure of any Task.