Task

Tasks of kinds job, serve, and build allow you to execute a Python function, serve it as a service, or build its Docker image. A Task is created via the run() method and is not managed directly by the user. Task parameters are passed directly to the run() method and may vary depending on the task kind.

Parameters

Name	Type	Description
action	str	Task action. One of: job, build, serve. Required.
node_selector	list[dict]	Node selector configuration.
volumes	list[dict]	List of volumes.
resources	dict	Resource limits/requests.
affinity	dict	Affinity configuration.
tolerations	list[dict]	Tolerations.
envs	list[dict]	Environment variables.
secrets	list[str]	List of secret names.
profile	str	Profile template.

Action-Specific Parameters

Serve

Name	Type	Description
replicas	int	Number of replicas.
service_type	str	Service type.

Build

Name	Type	Description
instructions	list[str]	Build instructions executed as RUN lines in the generated Dockerfile.

Task Actions

Actions must be one of the following:

• job: Execute function as a one-off task
• build: Create Docker image with dependencies
• serve: Deploy function as a service

Serving

Use the serve action to deploy a function as a service on Kubernetes.

Warning

It may take time for the service to become ready. The platform will notify the client when ready.

After the service is ready, call the inference endpoint with run.invoke(). This method accepts the same keyword arguments as requests.request; by default, the url is taken from the run object but you may override it with an explicit url parameter.

run = function.run("serve", ...)

json_data = {
    "some-func-param": data
}

run.invoke(json=json_data)

Instructions

List of strings representing instructions to be executed as RUN instructions in the Dockerfile.

instructions = ["apt-get install -y git"]