Overview
Cluster Templates provide pre-configured environments for consistent, repeatable cluster deployments. Templates include Docker images, environment variables, system configurations, and resource specifications that can be used to quickly spin up standardized development, training, or production environments.Endpoints
List Templates
Get Template Details
Create Template
Update Template
Delete Template
List Templates
Query Parameters
Parameter | Type | Required | Description |
---|---|---|---|
category | string | No | Filter by category: ml , dev , production , custom |
framework | string | No | Filter by ML framework: pytorch , tensorflow , huggingface , sklearn |
gpu_compatible | boolean | No | Filter GPU-compatible templates |
official | boolean | No | Filter official TensorOne templates |
project_id | string | No | Filter by project (for custom templates) |
search | string | No | Search templates by name or description |
sort_by | string | No | Sort by: name , created_at , usage_count , rating |
include_deprecated | boolean | No | Include deprecated templates (default: false) |
Request Examples
Create Template
Request Body
Parameter | Type | Required | Description |
---|---|---|---|
name | string | Yes | Template name (unique within project) |
description | string | Yes | Template description |
category | string | Yes | Template category |
docker_image | string | Yes | Base Docker image |
framework | string | No | ML framework if applicable |
default_configuration | object | Yes | Default hardware configuration |
environment_variables | object | No | Default environment variables |
startup_script | string | No | Script to run on cluster start |
port_mappings | array | No | Default port configurations |
required_packages | array | No | Additional packages to install |
gpu_compatible | boolean | No | Whether template supports GPUs |
min_resources | object | No | Minimum resource requirements |
max_resources | object | No | Maximum resource limits |
tags | array | No | Template tags for organization |
is_public | boolean | No | Make template publicly available (default: false) |
Request Examples
Get Template Details
Template Response Schema
Use Cases
Standardized Development Environment
Create consistent development environments across teams.Production Inference Template
Create optimized templates for production model serving.Template Versioning and Updates
Manage template versions and updates.Template Management Best Practices
Template Organization
Error Handling
Security Considerations
- Docker Image Security: Only use trusted Docker images from verified sources
- Environment Variables: Never store secrets in templates; use the secrets management system
- Public Templates: Carefully review public templates before use
- Access Control: Restrict template modification permissions appropriately
Best Practices
- Version Control: Always increment versions for template updates
- Documentation: Include comprehensive descriptions and usage examples
- Testing: Test templates thoroughly before making them available to teams
- Resource Optimization: Set appropriate resource limits to prevent overprovisioning
- Standardization: Use templates to enforce consistent environments across projects
- Maintenance: Regularly update templates with security patches and dependency updates
Authorizations
API key authentication. Use 'Bearer YOUR_API_KEY' format.
Response
200 - application/json
List of cluster templates
The response is of type object[]
.