API Reference

Packages

tensorstack.dev/v1beta1

Package v1beta1 contains API Schema definitions for the v1beta1 API group

Resource Types

Address

Appears in:

FieldDescription
url stringthe service's in-cluster url, e.g. managed-simplemlservice-41309.demo.svc.cluster.local
ports AddressPort arrayan array of serivce port & protocol

AddressPort

AddressPort stores ports defined in service of simplemlservice

Appears in:

FieldDescription
port integerThe port that will be exposed by this service.
nodePort integerThe port on each node on which this service is exposed when type=NodePort or LoadBalancer. Usually assigned by the system. If specified, it will be allocated to the service if unused or else creation of the service will fail. Default is to auto-allocate a port if the ServiceType of this Service requires one. More info: https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport
protocol ProtocolThe IP protocol for this port. Supports "TCP", "UDP", and "SCTP". Default is TCP.

Condition

Condition for simpleMLService

Appears in:

FieldDescription
lastTransitionTime Time
type SimpleMLServiceConditionType
status ConditionStatus
reason string
message string

CustomSpec

CustomSpec defines a pod template to run model serving

Appears in:

FieldDescription
spec PodSpec

DeploymentSpec

DeploymentSpec defines the configuration for replicas & scheduler

Appears in:

FieldDescription
scheduler SchedulePolicyScheduler responsible for handling resource allocation requests. default is default-scheduler
replicas integerReplicas of pods running model serving
strategy DeploymentStrategyThe deployment strategy to use to replace existing pods with new ones

PVCStorage

PVCStorage defines infos of pvc

Appears in:

FieldDescription
name stringPVC name
subPath stringDirectory path where model is located in PVC. Must be a relative path. e.g. "model/mnist"
mountPath stringDirectory path where model locates in container. Must be absolute path, default is "/var/lib/t9k/model"

PyTorchSpec

PyTorchSpec defines arguments for configuring PyTorch model serving

Appears in:

FieldDescription
modelsFlag stringValue of torchserve's flag --models
image stringImage of torchserve
resources ResourceRequirementsCompute Resources required by a replica

S3Storage

S3Storage defines infos of s3

Appears in:

FieldDescription
secretRef LocalObjectReferenceSecretRef is reference to the secret storing s3cmd config
uri stringDirectory path where model locates in s3. e.g. "s3://<bucket>/<dir>/"
mountPath stringDirectory path where model locates in container, default is "/var/lib/t9k/model"

SchedulePolicy

SchedulePolicy defines which scheduler is responsible for handling resource allocation requests

Appears in:

FieldDescription
t9kScheduler T9kSchedulerUse t9k-scheduler

ServiceSpec

ServiceSpec defines the desired state of Service created by Controller

Appears in:

FieldDescription
ports ServicePort arrayThe list of ports that are exposed by this service. More info: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies
type ServiceTypetype determines how the Service is exposed. Defaults to ClusterIP. Valid options are ExternalName, ClusterIP, NodePort, and LoadBalancer. "ExternalName" maps to the specified externalName. "ClusterIP" allocates a cluster-internal IP address for load-balancing to endpoints. Endpoints are determined by the selector or if that is not specified, by manual construction of an Endpoints object. If clusterIP is "None", no virtual IP is allocated and the endpoints are published as a set of endpoints rather than a stable IP. "NodePort" builds on ClusterIP and allocates a port on every node which routes to the clusterIP. "LoadBalancer" builds on NodePort and creates an external load-balancer (if supported in the current cloud) which routes to the clusterIP. More info: https://kubernetes.io/docs/concepts/services-networking/service/#publishing-services-service-types

SimpleMLService

SimpleMLService is the Schema for the simplemlservices API

Appears in:

FieldDescription
apiVersion stringtensorstack.dev/v1beta1
kind stringSimpleMLService
metadata ObjectMetaRefer to Kubernetes API documentation for fields of metadata.
spec SimpleMLServiceSpec
status SimpleMLServiceStatus

SimpleMLServiceConditionType

Underlying type: string

SimpleMLServiceConditionType is a type

Appears in:

SimpleMLServiceList

SimpleMLServiceList contains a list of SimpleMLService

FieldDescription
apiVersion stringtensorstack.dev/v1beta1
kind stringSimpleMLServiceList
metadata ListMetaRefer to Kubernetes API documentation for fields of metadata.
items SimpleMLService array

SimpleMLServiceSpec

SimpleMLServiceSpec defines the desired state of SimpleMLService

Appears in:

FieldDescription
tensorflow TensorflowSpecSpec for Tensorflow Serving (https://github.com/tensorflow/serving)
pytorch PyTorchSpecSpec for TorchServe
custom CustomSpecCustom Spec
storage StorageStorage of model
DeploymentSpec DeploymentSpecConfiguration for replicas & scheduler
service ServiceSpecConfiguration for service. Controller will create default service if spec.service not set

SimpleMLServiceStatus

SimpleMLServiceStatus defines the observed state of SimpleMLService

Appears in:

FieldDescription
address Address
conditions Condition array

Storage

Storage defines the storage where the model locates

Appears in:

FieldDescription
s3 S3StorageModel locates in S3
pvc PVCStorageModel locates in pvc

T9kScheduler

T9kScheduler defines SimpleMLService use t9k-scheduler.

Appears in:

FieldDescription
queue stringName of queue which SimpleMLService's pod belongs to

TensorflowSpec

TensorflowSpec defines arguments for configuring Tensorflow model serving

Appears in:

FieldDescription
image stringImage of Tensorflow Serving
resources ResourceRequirementsCompute Resources required by a replica