From 26efeefccd65a8ad479b6f26139095ca416cab94 Mon Sep 17 00:00:00 2001 From: dfitzmau Date: Fri, 24 Mar 2023 17:28:44 +0000 Subject: [PATCH] Added a module to detail AWS LZ cluster limitations --- .../installing-aws-localzone.adoc | 7 +++++++ modules/cluster-limitations-local-zone.adoc | 19 +++++++++++++++++++ 2 files changed, 26 insertions(+) create mode 100644 modules/cluster-limitations-local-zone.adoc diff --git a/installing/installing_aws/installing-aws-localzone.adoc b/installing/installing_aws/installing-aws-localzone.adoc index df223a2c4db9..1ff02399f379 100644 --- a/installing/installing_aws/installing-aws-localzone.adoc +++ b/installing/installing_aws/installing-aws-localzone.adoc @@ -40,6 +40,13 @@ Be sure to also review this site list if you are configuring a proxy. ==== * If the cloud identity and access management (IAM) APIs are not accessible in your environment, or if you do not want to store an administrator-level credential secret in the `kube-system` namespace, you can xref:../../installing/installing_aws/manually-creating-iam.adoc#manually-creating-iam-aws[manually create and maintain IAM credentials]. +include::modules/cluster-limitations-local-zone.adoc[leveloffset=+1] + +[role="_additional-resources"] +.Additional resources + +* xref:../../storage/understanding-persistent-storage.html#pvc-storage-class_understanding-persistent-storage[Storage classes] + include::modules/cluster-entitlements.adoc[leveloffset=+1] include::modules/installation-aws-add-local-zone-locations.adoc[leveloffset=+1] diff --git a/modules/cluster-limitations-local-zone.adoc b/modules/cluster-limitations-local-zone.adoc new file mode 100644 index 000000000000..c2e83896622f --- /dev/null +++ b/modules/cluster-limitations-local-zone.adoc @@ -0,0 +1,19 @@ +// Module included in the following assemblies: +// +// * installing/installing-aws-localzone.adoc + +:_content-type: CONCEPT + +[id="cluster-limitations-local-zone_{context}"] += Cluster limitations in AWS Local Zones + +Some limitations exist when you attempt to deploy a cluster with a default installation configuration in Amazon Web Services (AWS) Local Zones. + +[IMPORTANT] +==== +The following list details limitations when deploying a cluster in AWS Local Zones: + +- The Maximum Transmission Unit (MTU) between an Amazon EC2 instance in a Local Zone and an Amazon EC2 instance in the Region is `1300`. This causes the cluster-wide network MTU to change according to the network plugin that is used on the deployment. +- Network resources such as Network Load Balancer (NLB), Classic Load Balancer, and Network Address Translation (NAT) Gateways are not supported in AWS Local Zones. +- For an {product-title} cluster on AWS, the AWS Elastic Block Storage (EBS) `gp3` type volume is the default for node volumes and the default for the storage class. This volume type is not globally available on Local Zone locations. By default, the nodes running in Local Zones are deployed with the `gp2` EBS volume. The `gp2-csi` `StorageClass` must be set when creating workloads on Local Zone nodes. +====