OpenPAI JS SDK

The JavaScript SDK is designed to facilitate the developers of OpenPAI to offer user friendly experience.

The SDK mainly provides client side sharable functions such as RESTful API wrapping, error handling, storage accessing and processing of job protocol. Now the OpenPAI RESTful API is updating, please waiting for our stable release.

It could be used to support existing or future front-ends (e.g. Web Portal, VS Code extension, Command Line Interface, Jupyter Notebook extension, and 3rd party clients), and also could be used to simplify the design of kube runtime plugins, which are executed in init containers.

Now we are porting some of the functions from existing Python SDK and command line tool. The whole functionality of this SDK will be ready soon.

Installation

npm install --save @microsoft/openpai-js-sdk

Initialize the openPAIClient

import { PAIV2 } from '@microsoft/openpai-js-sdk';

const cluster: PAIV2.IPAICluster = {
    username: '<username>',
    token: '<token>',
    rest_server_uri: '<The host>/rest-server'
};
const openPAIClient = new PAIV2.OpenPAIClient(cluster);

Installation of CLI tool

The SDK offers a command line interface (CLI) prefixed by pai. For end users that use CLI only, we provide an easy way to install it via pip and the Python package nodeenv.

pip install nodeenv
nodeenv myenv
source myenv/bin/activate # use `myenv/Scripts/activate` instead on Windows
npm i -g @microsoft/openpai-js-sdk

This installation commands will generate a virtual environment with latest node in the directory ./myenv, and install the CLI in it. Then user could use pai command by any of below methods

• activate the virtual environment first

  source myenv/bin/activate # use `myenv/Scripts/activate` instead on Windows
  pai -h

• use a absolute path to pai

  myenv/bin/pai -h # use `myenv/Scripts/pai` instead on Windows

• add myenv/bin to environment variable path

RESTful API

The SDK provides ease-of-use JavaScript and TypeScript wrapping of OpenPAI RESTful APIs.

Details are in rest-api.md.

Storage Operations

Multiple types of storages are supported by OpenPAI, however, the end user and developers should not be bothered by too much details of it. The SDK provides an abstract storage accessing methods to let users access the storages.

User could get the IStorageNode object for each cluster provisioned storage by

// get a storage object with its name
let storageDetail: IStorageDetail = await opanPAIClient.storage.getStorageByName(name)
let storageNode: IStorageNode = new StorageNode(storageDetail)

It would provide storage accessing methods (getinfo, listdir, makedir, upload, download, delete) and CLI storage operations.

Details are in storage.md.

Local Cluster Management

In some scenarios (e.g. cli or notebook extension), it is required to store the cluster information locally.

Unified error handling

The SDK will center the error handling, thus all front ends depending on it could share the same way to warn users.

Common job config processing

The interoperation of OpenPAI components depends on the job protocol, and there have been some common operations of it, such as validation, preprocessing before submission (e.g. embedding essential user information). The SDK will provide essential common operations for all the front ends.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.