Container Job

The job action executes a container as a one-off job on Kubernetes. A Task is created by calling run() on the Function; task parameters are passed through that call.

Overview

The job action runs a container to completion and then terminates. It's ideal for batch processing, data transformations, or any workload that runs once and exits.

Quick example

function = dh.new_function(
    name="my-job",
    kind="container",
    image="my-image:latest",
    command="python script.py"
)

run = function.run(
    action="job",
    args=["arg1", "arg2"]
)

Parameters

Function Parameters

Must be specified when creating the function.

Name	Type	Description
project	str	Project name. Required only when creating from the library; otherwise MUST NOT be set.
name	str	Name that identifies the object. Required.
kind	str	Function kind. Required. Must be container
uuid	str	Object ID in UUID4 format.
description	str	Description of the object.
labels	list[str]	List of labels.
embedded	bool	Whether the object should be embedded in the project.
code_src	str	URI pointing to the source code.
code	str	Source code provided as plain text.
base64	str	Source code encoded as base64.
handler	str	Function entrypoint.
lang	str	Source code language (informational).
image	str	Container image to use for execution (name:tag).
base_image	str	Base image used when building the execution image.
image_pull_policy	str	Kubernetes image pull policy.
command	str	Command to run inside the container.

Task Parameters

Can only be specified when calling function.run().

Shared Parameters

Name	Type	Description
action	str	Task action. Required. Must be job
node_selector	list[dict]	Node selector.
volumes	list[dict]	List of volumes.
resources	dict	Resource limits/requests. Example: {"limits": {"cpu": "1", "memory": "512Mi"}, "requests": {"cpu": "250m", "memory": "128Mi"}}.
affinity	dict	Affinity configuration.
tolerations	list[dict]	Tolerations.
envs	list[dict]	Environment variables. Example: [{"name": "FOO", "value": "bar"}].
secrets	list[str]	List of secret names.
profile	str	Profile template.

Job-Specific Parameters

Name	Type	Description
fs_group	int	File system group ID.
run_as_user	int	User ID to run the container.
run_as_group	int	Group ID to run the container.

Run Parameters

Can only be specified when calling function.run().

Name	Type	Description
args	list[str]	Command-line arguments to pass to the container command.

Entity methods

Run methods

There are no runtime-specific helper methods for container runs.