Merge pull request #100640 from openshift-cherrypick-robot/cherry-pick-99801-to-enterprise-4.20

[enterprise-4.20] OSDOCS-16109# Add docs for tech preview of azure dedicated disk for etcd

Author: xenolinux

installing/installing_azure/ipi/installing-azure-customizations.adoc

@@ -38,6 +38,8 @@ include::modules/installation-azure-trusted-launch.adoc[leveloffset=+2]
 
 include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]
 
+include::modules/installation-azure-dedicated-disks.adoc[leveloffset=+2]
+
 include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
 
 include::modules/installation-configure-proxy.adoc[leveloffset=+2]

installing/installing_azure/ipi/installing-azure-network-customizations.adoc

@@ -36,6 +36,8 @@ include::modules/installation-azure-arm-tested-machine-types.adoc[leveloffset=+2
 include::modules/installation-azure-trusted-launch.adoc[leveloffset=+2]
 include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]
 
+include::modules/installation-azure-dedicated-disks.adoc[leveloffset=+2]
+
 include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
 
 include::modules/installation-configure-proxy.adoc[leveloffset=+2]

installing/installing_azure/ipi/installing-restricted-networks-azure-installer-provisioned.adoc

@@ -54,6 +54,8 @@ include::modules/installation-azure-arm-tested-machine-types.adoc[leveloffset=+2
 include::modules/installation-azure-trusted-launch.adoc[leveloffset=+2]
 include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]
 
+include::modules/installation-azure-dedicated-disks.adoc[leveloffset=+2]
+
 include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
 
 include::modules/installation-configure-proxy.adoc[leveloffset=+2]

modules/installation-azure-dedicated-disks.adoc

@@ -0,0 +1,58 @@
+// Module included in the following assemblies:
+//
+// * installing/installing_azure/ipi/installing-azure-customizations.adoc
+// * installing/installing_azure/ipi/installing-azure-network-customizations.adoc
+// * installing/installing_azure/ipi/installing-restricted-networks-azure-installer-provisioned.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="installation-azure-dedicated-disks_{context}"]
+= Configuring a dedicated disk for etcd
+
+You can install your {product-title} cluster on {azure-first} with a dedicated data disk for `etcd`. This configuration attaches a separate managed disk to each control plane node and uses it only for `etcd` data, which can improve cluster performance and stability.
+
+:FeatureName: Dedicated disk for etcd
+
+include::snippets/technology-preview.adoc[]
+
+.Prerequisites
+
+* You have created an `install-config.yaml` file.
+
+.Procedure
+
+* To configure a dedicated `etcd` disk, edit the `install-config.yaml` file and add the `diskSetup` and `dataDisks` parameters to the `controlPlane` stanza:
++
+[source,yaml]
+----
+# ...
+controlPlane:
+  architecture: amd64
+  hyperthreading: Enabled
+  name: master
+  platform:
+    azure:
+      type: Standard_D4s_v5
+      dataDisks:
+      - nameSuffix: etcddisk # <1>
+        cachingType: None # <2>
+        diskSizeGB: 20 # <3>
+        lun: 0 # <4>
+  diskSetup:
+  - type: etcd # <5>
+    etcd:
+      platformDiskID: etcddisk # <6>
+  replicas: 3
+# ...
+----
+
+<1> Specify the same value you defined for `platformDiskID`.
+<2> Specify `None`. Other caching requirements are not currently supported.
+<3> Specify a disk size in GB. This value can be any integer greater than `0`.
++
+[NOTE]
+====
+A minimum of 20 GB ensures enough space is available for defragmentation operations.
+====
+<4> Specify a logical unit number (LUN). This can be any integer from `0` through `63` that is not used by another disk.
+<5> Specify `etcd`. This identifies `etcd` as the node component type to receive a dedicated disk.
+<6> Specify a name to identify the disk. This value must not exceed 12 characters.

modules/installation-configuration-parameters.adoc

@@ -1752,6 +1752,58 @@ Supplying more than one user-assigned identity is an experimental feature, which
 
 *Value:* `VMGuestStateOnly` is the only supported value.
 
+|controlPlane:
+  diskSetup:
+|Specifies node component information for dedicated disk configuration.
+
+*Value:* Array of objects. Each object includes the `type` and `etcd` parameters as described in the following rows of the table.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
+|controlPlane:
+  diskSetup:
+  - type:
+|Specifies which node component type to assign a dedicated disk.
+
+*Value:* `etcd` is the only supported value.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
+|controlPlane:
+  diskSetup:
+  - etcd:
+|Specifies parameters for an `etcd` dedicated disk.
+
+*Value*: The `platformDiskID` object is the only supported value.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
+|controlPlane:
+  diskSetup:
+  - etcd:
+      platformDiskID:
+|Specifies a name to identify the dedicated disk.
+
+*Value:* String. Must not exceed 12 characters.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
 |controlPlane:
   platform:
     azure:
@@ -1813,6 +1865,80 @@ Supplying more than one user-assigned identity is an experimental feature, which
 
 *Value:* String.
 
+|controlPlane:
+  platform:
+    azure:
+      dataDisks:
+|Specifies dedicated disk parameters.
+
+*Value:* Array of objects. Each object includes `nameSuffix`, `cachingType`, `diskSizeGB`, and `lun` as described in the following rows of the table.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
+|controlPlane:
+  platform:
+    azure:
+      dataDisks:
+      - nameSuffix:
+|Specifies the same value you defined for `platformDiskID`.
+
+*Value:* String.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
+|controlPlane:
+  platform:
+    azure:
+      dataDisks:
+      - cachingType:
+|Specifies the caching requirements for the disk.
+
+*Value:* `None` is the only value currently supported.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
+|controlPlane:
+  platform:
+    azure:
+      dataDisks:
+      - diskSizeGB:
+|Specifies a dedicated disk size in GB.
+
+*Value:* Integer greater than `0`.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
+|controlPlane:
+  platform:
+    azure:
+      dataDisks:
+      - lun:
+|Specifies a logical unit number (LUN) for the dedicated disk.
+
+*Value:* Integer from `0` through `63` that is not used by another disk.
+
+[IMPORTANT]
+====
+Dedicated disk for `etcd` on {azure-full} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
+====
+
 |controlPlane:
   platform:
     azure: