Managing the compute grid

Overview

Users in Domino assign their Runs to Domino Hardware Tiers. A hardware tier defines the type of machine a job will run on, and the resource requests and limits for the pod that the Run will execute in. When configuring a hardware tier, you will specify the machine type by providing a Kubernetes node label.

You should create a Kubernetes node label for each type of node you want available for compute workloads in Domino, and apply it consistently to compute nodes that meet that specification. Nodes with the same label become a node pool, and they will be used as available for Runs assigned to a Hardware Tier that points to their label.

Which pool a Hardware Tier is configured to use is determined by the value in the Node Pool field of the Hardware Tier editor. In the screenshot below, the large-k8s Hardware Tier is configured to use the default node pool.

../_images/hardware-tier-config.png

The diagram below shows a cluster configured with two node pools for Domino, one named default and one named default-gpu. You can make additional node pools available to Domino by labeling them with the same scheme: dominodatalab.com/node-pool=<node-pool-name>. The arrows in this diagram represent Domino requesting that a node with a given label be assigned to a Run. Kubernetes will then assign the Run to a node in the specified pool that has sufficient resources.

../_images/node-pools.png

By default, Domino creates a node pool with the label dominodatalab.com/node-pool=default and all compute nodes Domino creates in cloud environments are assumed to be in this pool. Note that in cloud environments with automatic node scaling, you will configure scaling components like AWS Auto Scaling Groups or Azure Scale Sets with these labels to create elastic node pools.




Kubernetes pods

Every Run in Domino is hosted in a Kubernetes pod on a type of node specified by the selected Hardware Tier.

The pod hosting a Domino Run contains three containers:

  1. The main Run container where user code is executed
  2. An NGINX container for handling web UI requests
  3. An executor support container which manages various aspects of the lifecycle of a Domino execution, like transferring files or syncing changes back to the Domino file system



Resourcing requests

The amount of compute power required for your Domino cluster will fluctuate over time as users start and stop Runs. Domino relies on Kubernetes to find space for each execution on existing compute resources. In cloud autoscaling environments, if there’s not enough CPU or memory to satisfy a given execution request, the Kubernetes cluster autoscaler will start new compute nodes to fulfill that increased demand. In environments with static nodes, or in cloud environments where you have reached the autoscaling limit, the execution request will be queued until resources are available.

Autoscaling Kubernetes clusters will shut nodes down when they are idle for more than a configurable duration. This reduces your costs by ensuring that nodes are used efficiently, and terminated when not needed.

Cloud autoscaling resources have properties like the minimum and maximum number of nodes they can create. You should set the node maximum to whatever you are comfortable with given the size of your team and expected volume of workloads. All else equal, it is better to have a higher limit than a lower one, as nodes are cheap to start up and shut down, while your data scientists’ time is very valuable. If the cluster cannot scale up any further, your users’ executions will wait in a queue until the cluster can service their request.

The amount of resources Domino will request for a Run is determined by the selected Hardware Tier for the Run. Each Hardware Tier has five configurable properties that configure the resource requests and limits for Run pods.

  • Cores

    The number of requested CPUs.

  • Cores limit

    The maximum number of CPUs. Recommended to be the same as the request.

  • Memory

    The amount of requested memory.

  • Memory limit

    The maximum amount of memory. Recommended to be the same as the request.

  • Number of GPUs

    The number of GPU cards available.

The request values, Cores and Memory, as well as Number of GPUs, are thresholds used to determine whether a node has capacity to host the pod. These requested resources are effectively reserved for the pod. The limit values control the amount of resources a pod can use above and beyond the amount requested. If there’s additional headroom on the node, the pod can use resources up to this limit.

However, if resources are in contention, and a pod is using resources beyond those it requested, and thereby causing excess demand on a node, the offending pod may be evicted from the node by Kubernetes and the associated Domino Run is terminated. For this reason, Domino strongly recommends setting the requests and limits to the same values.




Common questions


How do I view the current nodes in my compute grid?

From the top menu bar in the admin UI, click Infrastructure. You will see both Platform and Compute nodes in this interface. Click the name of a node to get a complete description, including all applied labels, available resources, and currently hosted pods. This is the full kubectl describe for the node. Non-Platform nodes in this interface with a value in the Node Pool column are compute nodes that can be used for Domino Runs by configuring a Hardware Tier to use the pool.

../_images/infrastructure-ui.png

How do I view details on currently active executions?

From the top menu of the admin UI, click Executions. This interface lists active Domino execution pods and shows the type of workload, the Hardware Tier used, the originating user and project, and the status for each pod. There are also links to view a full kubectl describe output for the pod and the node, and an option to download the deployment lifecycle log for the pod generated by Kubernetes and the Domino application.

../_images/executions-ui.png

How do I create or edit a Hardware Tier?

From the top menu of the admin UI, click Advanced > Hardware Tiers, then on the Hardware Tiers page click New to create a new Hardware Tier or Edit to modify an existing Hardware Tier.

Keep in mind that your a Hardware Tier’s CPU, memory, and GPU requests should not exceed the available resources of the machines in the target node pool after accounting for overhead. If you need more resources than are available on existing nodes, you may need to add a new node pool with different specifications. This may mean adding individual nodes to a static cluster, or configuring new auto-scaling components that provision new nodes with the required specifications and labels.

../_images/create-edit-hwt.png