1.1.2 • Published 5 years ago

@aics/job-status-client v1.1.2

Weekly downloads
16
License
MIT
Repository
-
Last release
5 years ago

job-status-client

This is a JavaScript client to the Job Status Service (JSS). It will provide the API to create, update, and query jobs.

It can be installed like this:

npm i --save @aics/job-status-client

Level of Support

We are not currently supporting this code for external use, but simply releasing it to the community AS IS. It is used for within our organization. We are not able to provide any guarantees of support. The community is welcome to submit issues, but you should not expect an active response.

Example Usage

Client instantiation

const jssClient = new JobStatusClient(LIMS_HOST, LIMS_PORT);

Creating jobs

Creating a job only requires the following properties:

  • status ("UNRECOVERABLE" | "FAILED" | "WORKING" | "RETRYING" | "WAITING" | "BLOCKED" | "SUCCEEDED")
  • user (string)

Note that custom fields can be added to the serviceFields property.

jssClient.createJob({
  jobId: "f55dd53883a44cdaa6eff884a6b5266b",
  childIds: ["a0eaf0d41db848c8be5802432de327b9"],
  currentHost: "dev-aics-lhp-001",
  currentStage: "started",
  jobName: "Dinner",
  originationHost: "kitchen",
  parentId: null,
  service: "diner-service",
  serviceFields: {
     guestName: "goofy",    
  },
  status: "WAITING",
  user: "demo",
  updateParent: null,
})
.then(() => console.log("success!"))
.catch((e) => console.log("error", e));

Updating Jobs

There are only a subset of fields that can be updated:

  • jobName (string)
  • childIds (string[])
  • serviceFields (any)
  • currentHost (string)
  • currentStage (string)
  • status ("UNRECOVERABLE" | "FAILED" | "WORKING" | "RETRYING" | "WAITING" | "BLOCKED" | "SUCCEEDED")
jssClient.updateJob("f55dd53883a44cdaa6eff884a6b5266b", {
    currentStage: "queuing for SLURM",
    status:"WAITING",
    serviceFields: {
        files: ["file1.txt", "file2.txt"],
        favorites: {
            number: 1,
            color: "red",
        }
    }
});

This update will result in properties listed in the request getting replaced with the values they are set to.

To update only a specific property without overriding everything else, you can add a 3rd parameter to updateJob:

jssClient.updateJob("f55dd53883a44cdaa6eff884a6b5266b", {
    serviceFields: {
        favorites: { color: "blue" }
    }
}, true);

This should only update the service_fields.favorites.color property. Note that JSS does not make it possible to overwrite the property serviceFields.

Getting jobs

// get all blocked or waiting jobs owned by foo
jssClient.getJobs({
    user: "foo",
    status: {
       "$in": ["BLOCKED", "WAITING"] 
    }
})
.then((jobs) => console.log("success!", jobs))
.catch((e) => console.log("error", e));

Library development

Gradle Tasks

scriptcomments
buildcreate CommonJS, ES module, and UMD builds
bundlerun Webpack to create a UMD bundle
cleanremove generated artifacts
formatrun prettier on src directory
generateTypesgenerate type declarations
lintrun eslint on src directory
transpileCommonJsrun babel on src directory; transpile import/export statements for a CommonJS compatible build
transpileESrun babel on src directory; do not transpile import/export statements for an ES module compatible build (used by bundlers for tree-shaking)
testrun mocha; searches for any files matching the pattern "src/*/.test.js"
typeCheckrun tsc in type-check only mode

Simultaneously working on application and library

You can test a development copy of the library in another application using npm-link:

npm link creates a symlink for the library that points to your development copy.

  1. Run npm link in the root of this repository
  2. Run npm link aicsfiles in the root of your application

Publishing

After merging to master, create a release build specifying the type of release ('patch', 'minor', 'major') and checking PUBLISH. https://jenkins.corp.alleninstitute.org/job/node-packages/job/job-status-client/job/master/build?delay=0sec

1.1.2

5 years ago

1.1.1

5 years ago

1.1.0

6 years ago

1.0.10

6 years ago

1.0.9

6 years ago

1.0.8

6 years ago

1.0.7

6 years ago

1.0.6

6 years ago

1.0.5

6 years ago

1.0.4

6 years ago

1.0.3

6 years ago

1.0.2

6 years ago

1.0.1

6 years ago

1.0.0

6 years ago

0.0.1

6 years ago

0.0.0

6 years ago