Metadata for Custom ML Runtimes

This topic addresses the metadata for custom Runtimes.

All new custom Runtimes must override the Edition metadata of existing Runtimes. The rest of the metadata can be overriden to communicate the expectations for the consumers of the image. Both the Docker label and the environment variable match in a custom Runtime image. In order to add or register a custom Runtime to a deployment, the user facing metadata combination should be unique in that deployment. For example, of the following, Editor, Edition, Kernel, Version, and Maintenance Version, at least the later should be incremented for adding a next iteration of the same image.

See the following reference table for more details on ML Runtime metadata.

Environment variable Docker Label Description Override in custom non-PBJ runtime Value in PBJ Runtimes
ML_RUNTIME_METADATA_VERSION com.cloudera.ml.runtime.runtime-metadata-version Metadata version Not allowed Must be set to 2
ML_RUNTIME_EDITOR com.cloudera.ml.runtime.editor CDSW/CML Editor installed in the image. Allowed Required
ML_RUNTIME_EDITION com.cloudera.ml.runtime.edition Edition of the image, a notion of the Runtime capabilities. Required Required
ML_RUNTIME_DESCRIPTION com.cloudera.ml.runtime.description Longer description of the Runtime image capabilities. Recommended Required
ML_RUNTIME_KERNEL com.cloudera.ml.runtime.kernel Main kernel included in the image, e.g., Python 3.8 Not allowed Required
ML_RUNTIME_SHORT_VERSION com.cloudera.ml.runtime.short-version Main version of the image, e.g., 1.0. This shows up as Version in the selection screen. Recommended Required
ML_RUNTIME_FULL_VERSION com.cloudera.ml.runtime.full-version Full version consists of the short version + maintenance version, e.g., 1.0.1 Optional Optional
ML_RUNTIME_MAINTENANCE_VERSION com.cloudera.ml.runtime.maintenance-version Maintenance version must be an integer, e.g., 1. Only the largest maintenance version of the set of the same short version images are visible for users to select. Increment this number if you create a drop in replacement of an existing Runtime. Start with 1 with a new version or edition. Recommended Required
ML_RUNTIME_CUDA_VERSION com.cloudera.ml.runtime.cuda-version CUDA version installed in the image. Not allowed Do not set
ML_RUNTIME_GIT_HASH com.cloudera.ml.runtime.git-hash Git hash of runtime source Not allowed Do not set
ML_RUNTIME_GBN com.cloudera.ml.runtime.gbn Cloudera internal build number Not allowed Do not set