Merge pull request #40074 from jkhelil/build-275

BUILD-275: add support for build csi volume source

Author: abrennan89

modules/builds-using-build-volumes.adoc

@@ -46,11 +46,29 @@ spec:
           type: ConfigMap <3>
           configMap:
             name: my-config <4>
+      - name: my-csi-volume <1>
+        mounts:
+        - destinationPath: /opt/app-root/src/some_path  <2>
+        source:
+          type: CSI <3>
+          csi:
+            driver: csi.sharedresource.openshift.io <5>
+            readOnly: true <6>
+            volumeAttributes: <7>
+              attribute: value
 ----
 <1> Required. A unique name.
 <2> Required. The absolute path of the mount point. It must not contain `..` or `:` and doesn't collide with the destination path generated by the builder. The `/opt/app-root/src` is the default home directory for many Red Hat S2I-enabled images.
-<3> Required. The type of source, `ConfigMap` or `Secret`.
+<3> Required. The type of source, `ConfigMap`, `Secret`, or `CSI`.
 <4> Required. The name of the source.
+<5> Required. The driver that provides the ephemeral CSI volume.
+<6> Optional. If true, this instructs the driver to provide a read-only volume.
+<7> Optional. The volume attributes of the ephemeral CSI volume. Consult the CSI driver's documentation for supported attribute keys and values.
+
+[NOTE]
+====
+The shared resource CSI driver is supported as **Tech Preview** only.
+====
 
 endif::dockerstrategy[]
 
@@ -77,12 +95,30 @@ spec:
           type: ConfigMap <3>
           configMap:
             name: my-config <4>
+      - name: my-csi-volume <1>
+        mounts:
+        - destinationPath: /opt/app-root/src/some_path  <2>
+        source:
+          type: CSI <3>
+          csi:
+            driver: csi.sharedresource.openshift.io <5>
+            readOnly: true <6>
+            volumeAttributes: <7>
+              attribute: value
 ----
 
 <1> Required. A unique name.
 <2> Required. The absolute path of the mount point. It must not contain `..` or `:` and doesn't collide with the destination path generated by the builder. The `/opt/app-root/src` is the default home directory for many Red Hat S2I-enabled images.
-<3> Required. The type of source, `ConfigMap` or `Secret`.
+<3> Required. The type of source, `ConfigMap`, `Secret`, or `CSI`.
 <4> Required. The name of the source.
+<5> Required. The driver that provides the ephemeral CSI volume.
+<6> Optional. If true, this instructs the driver to provide a read-only volume.
+<7> Optional. The volume attributes of the ephemeral CSI volume. Consult the CSI driver's documentation for supported attribute keys and values.
+
+[NOTE]
+====
+The shared resource CSI driver is supported as **Tech Preview** only.
+====
 
 endif::sourcestrategy[]