From f146f87ed2247c89259ecc9e0cabaab859a8ba90 Mon Sep 17 00:00:00 2001
From: Caleb Woodbine <calebwoodbine.public@gmail.com>
Date: Fri, 28 Jun 2024 06:16:37 +1200
Subject: [PATCH] feat: add docs for runtime-class-name feature (#6022)

adds docs for configuring runtime-class-name
---
 docs/serving/configuration/deployment.md | 44 ++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/docs/serving/configuration/deployment.md b/docs/serving/configuration/deployment.md
index 280a5820b1..37aaa7897b 100644
--- a/docs/serving/configuration/deployment.md
+++ b/docs/serving/configuration/deployment.md
@@ -133,3 +133,47 @@ data:
   # List of repositories for which tag to digest resolving should be skipped
   registries-skipping-tag-resolving: registry.example.com
 ```
+
+## Configuring selectable RuntimeClassName
+
+You can configure Knative Serving to configure deployments with a specified RuntimeClassName (`Pod.Spec.RuntimeClassName`) by modifying the `runtime-class-name` setting.
+
+The setting works with Service labels and will configure either a default or one where the most labels match.
+
+**Example:**
+
+=== "Global (ConfigMap)"
+    ```yaml
+    apiVersion: v1
+    kind: ConfigMap
+    metadata:
+      name: config-deployment
+      namespace: knative-serving
+    data:
+      runtime-class-name: |
+        kata: {}
+        gvisor:
+          selector:
+            my-label: selector
+    ```
+
+=== "Operator"
+    ```yaml
+    apiVersion: operator.knative.dev/v1beta1
+    kind: KnativeServing
+    metadata:
+      name: knative-serving
+      namespace: knative-serving
+    spec:
+      config:
+        deployment:
+          runtime-class-name: |
+            kata: {}
+            gvisor:
+              selector:
+                my-label: selector
+    ```
+
+See [Kubernetes RuntimeClass](https://kubernetes.io/docs/concepts/containers/runtime-class/) docs for more information.
+
+Separately, there is a feature flag to allow [manual configuration of RuntimeClassName](/docs/serving/configuration/feature-flags/#kubernetes-runtime-class).