Skip to content

Update warning on EKS Local Clusters in AWS Outposts AMI Compatibility #1127

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: mainline
Choose a base branch
from
Open

Update warning on EKS Local Clusters in AWS Outposts AMI Compatibility #1127

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions latest/ug/outposts/eks-outposts-self-managed-nodes.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,17 @@ include::../attributes.txt[]
Learn how to launch Auto Scaling groups of Amazon Linux nodes on an Outpost that register with your Amazon EKS cluster. The cluster can be on the {aws} Cloud or on an Outpost.
--

[IMPORTANT]
====
Amazon EKS Local Clusters on Outposts currently supports only nodes created from Amazon EKS-optimized Amazon Linux 2 AMIs, which include:

* Standard Amazon Linux 2 (`amazon-linux-2`)
* GPU-enabled Amazon Linux 2 (`amazon-linux-2-gpu`)
* Arm64-based Amazon Linux 2 (`amazon-linux-2-arm64`)

Nodes based on Amazon Linux 2023 (`AL2023`) AMIs are not currently supported and will fail to join the cluster. Support for `AL2023`-based nodes is planned for a future release, and this documentation will be updated when the feature becomes available.
====

This topic describes how you can launch Auto Scaling groups of Amazon Linux nodes on an Outpost that register with your Amazon EKS cluster. The cluster can be on the {aws} Cloud or on an Outpost.

* An existing Outpost. For more information, see link:outposts/latest/userguide/what-is-outposts.html[What is {aws} Outposts,type="documentation"].
Expand Down
2 changes: 1 addition & 1 deletion latest/ug/outposts/eks-outposts-troubleshooting.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -271,7 +271,7 @@ The most common issues are the following:

* AMI issues:
+
** You're using an unsupported AMI. You must use https://github.com/awslabs/amazon-eks-ami/releases/tag/v20220620[v20220620] or later for the <<eks-optimized-ami,Create nodes with optimized Amazon Linux AMIs>> Amazon EKS optimized Amazon Linux.
** You may be using an incompatible AMI. Only Amazon EKS optimized Amazon Linux 2 AMIs are currently supported (`amazon-linux-2`,`amazon-linux-2-gpu`, `amazon-linux-2-arm64`), attempting to join `AL2023`-based AMIs to EKS LocalClusters on {aws} Outposts will fail until the compatibility is added in a future release. See <<eks-outposts-self-managed-nodes,Create Amazon Linux nodes on {aws} Outposts>>)
** If you used an {aws} CloudFormation template to create your nodes, make sure it wasn't using an unsupported AMI.
* Missing the {aws} IAM Authenticator `ConfigMap` – If it's missing, you must create it. For more information, see <<aws-auth-configmap>> .
* The wrong security group is used – Make sure to use `eks-cluster-sg-[.replaceable]``cluster-name``-[.replaceable]``uniqueid``` for your worker nodes' security group. The selected security group is changed by {aws} CloudFormation to allow a new security group each time the stack is used.
Expand Down