From 5402ff10b9b010cf39051241f4be7c7360b9fe79 Mon Sep 17 00:00:00 2001 From: Ben Scott Date: Thu, 27 Apr 2023 14:39:42 -0400 Subject: [PATCH] OCPBUGS#5852 updating minimum storage requirements --- .../installing-azure-account.adoc | 5 +++++ .../installing-azure-user-infra.adoc | 6 ++++++ .../installing-azure-stack-hub-account.adoc | 5 +++++ .../installing-azure-stack-hub-user-infra.adoc | 6 ++++++ modules/installation-azure-limits.adoc | 4 +--- modules/optimizing-storage-azure.adoc | 16 ++++++++++++++++ .../optimizing-storage.adoc | 2 ++ 7 files changed, 41 insertions(+), 3 deletions(-) create mode 100644 modules/optimizing-storage-azure.adoc diff --git a/installing/installing_azure/installing-azure-account.adoc b/installing/installing_azure/installing-azure-account.adoc index 03046f9be4..9129b04f3a 100644 --- a/installing/installing_azure/installing-azure-account.adoc +++ b/installing/installing_azure/installing-azure-account.adoc @@ -20,6 +20,11 @@ in the Azure documentation. include::modules/installation-azure-limits.adoc[leveloffset=+1] +[role="_additional-resources"] +.Additional resources + +* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage]. + include::modules/installation-azure-network-config.adoc[leveloffset=+1] include::modules/installation-azure-increasing-limits.adoc[leveloffset=+1] diff --git a/installing/installing_azure/installing-azure-user-infra.adoc b/installing/installing_azure/installing-azure-user-infra.adoc index 68f71a09a5..0a0d467ac6 100644 --- a/installing/installing_azure/installing-azure-user-infra.adoc +++ b/installing/installing_azure/installing-azure-user-infra.adoc @@ -43,6 +43,12 @@ All Azure resources that are available through public endpoints are subject to r ==== include::modules/installation-azure-limits.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage]. + include::modules/installation-azure-network-config.adoc[leveloffset=+2] You can view Azure's DNS solution by visiting this xref:installation-azure-create-dns-zones_{context}[example for creating DNS zones]. diff --git a/installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc b/installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc index 023bf49491..c0e23f7c45 100644 --- a/installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc +++ b/installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc @@ -15,6 +15,11 @@ All Azure resources that are available through public endpoints are subject to r include::modules/installation-azure-limits.adoc[leveloffset=+1] +[role="_additional-resources"] +.Additional resources + +* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage]. + include::modules/installation-azure-stack-hub-network-config.adoc[leveloffset=+1] include::modules/installation-azure-stack-hub-permissions.adoc[leveloffset=+1] diff --git a/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc b/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc index 80e5c87a99..88892d16b6 100644 --- a/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc +++ b/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc @@ -42,6 +42,12 @@ All Azure Stack Hub resources that are available through public endpoints are su ==== include::modules/installation-azure-limits.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage]. + include::modules/installation-azure-stack-hub-network-config.adoc[leveloffset=+2] You can view Azure's DNS solution by visiting this xref:installation-azure-create-dns-zones_{context}[example for creating DNS zones]. diff --git a/modules/installation-azure-limits.adoc b/modules/installation-azure-limits.adoc index 8f41e9250b..57fa173ca2 100644 --- a/modules/installation-azure-limits.adoc +++ b/modules/installation-azure-limits.adoc @@ -106,9 +106,7 @@ ifndef::ash[] |OS Disk |7 | -|VM OS disk must be able to sustain a tested and recommended minimum throughput of 5000 IOPS / 200MBps for control plane machines. This throughput can be provided by having a minimum of 1 TiB Premium SSD (P30). In {cp}, disk performance is directly dependent on SSD disk sizes, so to achieve the throughput supported by `Standard_D8s_v3`, or other similar machine types available, and the target of 5000 IOPS, at least a P30 disk is required. - -Host caching must be set to `ReadOnly` for low read latency and high read IOPS and throughput. The reads performed from the cache, which is present either in the VM memory or in the local SSD disk, are much faster than the reads from the data disk, which is in the blob storage. +|Each cluster machine must have a minimum of 100 GB of storage and 300 IOPS. While these are the minimum supported values, faster storage is recommended for production clusters and clusters with intensive workloads. For more information about optimizing storage for performance, see the page titled "Optimizing storage" in the "Scalability and performance" section. endif::ash[] |VNet diff --git a/modules/optimizing-storage-azure.adoc b/modules/optimizing-storage-azure.adoc new file mode 100644 index 0000000000..d81a7c29dc --- /dev/null +++ b/modules/optimizing-storage-azure.adoc @@ -0,0 +1,16 @@ +// Module included in the following assembly: +// +// * ../scalability_and_performance/optimizing-storage.adoc + +:_content-type: REFERENCE + +[id="optimizing-storage-azure_{context}"] += Optimizing storage performance for Microsoft Azure + +{product-title} and Kubernetes are sensitive to disk performance, and faster storage is recommended, particularly for etcd on the control plane nodes. + +For production Azure clusters and clusters with intensive workloads, the virtual machine operating system disk for control plane machines should be able to sustain a tested and recommended minimum throughput of 5000 IOPS / 200MBps. +This throughput can be provided by having a minimum of 1 TiB Premium SSD (P30). +In Azure and Azure Stack Hub, disk performance is directly dependent on SSD disk sizes. To achieve the throughput supported by a `Standard_D8s_v3` virtual machine, or other similar machine types, and the target of 5000 IOPS, at least a P30 disk is required. + +Host caching must be set to `ReadOnly` for low latency and high IOPS and throughput when reading data. Reading data from the cache, which is present either in the VM memory or in the local SSD disk, is much faster than reading from the disk, which is in the blob storage. diff --git a/scalability_and_performance/optimizing-storage.adoc b/scalability_and_performance/optimizing-storage.adoc index cc7e8ab891..c75d49950c 100644 --- a/scalability_and_performance/optimizing-storage.adoc +++ b/scalability_and_performance/optimizing-storage.adoc @@ -30,6 +30,8 @@ include::modules/recommended-configurable-storage-technology.adoc[leveloffset=+1 include::modules/data-storage-management.adoc[leveloffset=+1] +include::modules/optimizing-storage-azure.adoc[leveloffset=+1] + [role="_additional-resources"] [id="admission-plug-ins-additional-resources"] == Additional resources