Overview: Developer Documentation¶
Developers can access Run:ai through various programmatic interfaces.
Run:ai is composed of a single, multi-tenant control plane (also called 'backend'). Each tenant can be connected to one or more GPU clusters. See Run:ai system components for detailed information.
Below is a diagram of the Run:ai API Architecture. A developer may:
- Access the control plane via the Administrator API.
- Access any one of the GPU clusters via Cluster API.
- Access cluster metrics via the Metrics API.
Add, delete, modify and list Run:ai meta-data objects such as Projects, Departments, Users, and more.
The API is provided as REST and is accessible via the control plane (backend) endpoint.
For more information see Administrator REST API.
Submit and delete Workloads.
The API is provided as Kubernetes API.
Cluster API is accessible via the GPU cluster itself. As such, multiple clusters may have multiple endpoints.
The same functionality is also available via the Run:ai Command-line interface. The CLI provides an alternative for automating with shell scripts.
Retrieve metrics from multiple GPU clusters.
See the Metrics API document.
See API Authentication for information on how to gain authenticated access to Run:ai APIs.