Files

2.1 KiB

Python client for KubeRay API server

This Python client is currently only supporting Ray cluster management through usage of the API server Ray API. It implements all of the current functionality of the API server (and the operator) and provide pythonic APIs to the capabilities.

The package supports Python objects (documented in the code ) that can be used to build and receive payloads for creation, listing and deleting of template and Ray clusters.

The main class of the package is KubeRayAPIs that implements all of the functionality. It leverages templates and cluster definitions, allowing to specify all required parameters as straight Python classes. Additional (intermediate) definitions are provided (see environment variables, volumes, head group and worker group)

Prerequisites

It is also expected that the kuberay operator (Installation instructions are here.) and api server (Installation instructions are here.) are installed

Development

Start by installing setup-tools

pip3 install -U setuptools

Now install our library locally. From the directory path/to/kuberay/clients/python_apiserver_client execute

pip3 install -e .

Testing

Test files parameters_test and api_test exercise the package functionality and can also be used as a guide for API usage.

Note that api_test requires installation of the package and creation of the additional configmap in the default namespace