Deploy your Amazon EKS Clusters Regionally on AWS Outposts

Voiced by Polly

I’m happy to announce the provision of native clusters for Amazon Elastic Kubernetes Service (Amazon EKS) on AWS Outposts. It signifies that beginning immediately, you may deploy your Amazon EKS cluster solely on Outposts: each the Kubernetes management airplane and the nodes.

Amazon EKS is a managed Kubernetes service that makes it straightforward so that you can run Kubernetes on AWS and on premises. AWS Outposts is a household of absolutely managed options delivering AWS infrastructure and providers to just about any on-premises or edge location for a very constant hybrid expertise.

To totally perceive the advantages of native clusters for Amazon EKS on Outposts, I must first share a little bit of background.

Some prospects use Outposts to deploy Kubernetes cluster nodes and pods near the remainder of their on-premises infrastructure. This enables their purposes to profit from low latency entry to on-premises providers and knowledge whereas managing the cluster and the lifecycle of the nodes utilizing the identical AWS API, CLI, or AWS console as they do for his or her cloud-based clusters.

Till immediately, whenever you deployed Kubernetes purposes on Outposts, you usually began by creating an Amazon EKS cluster within the AWS cloud. Then you definately deployed the cluster nodes in your Outposts machines. On this hybrid cluster situation, the Kubernetes management airplane runs within the guardian Area of your Outposts, and the nodes are operating in your on-premises Outposts. The Amazon EKS service communicates by means of the community with the nodes operating on the Outposts machine.

However, bear in mind: the whole lot fails on a regular basis. Prospects informed us the principle problem they’ve on this situation is to handle web site disconnections. That is one thing we can not management, particularly whenever you deploy Outposts on tough edges: areas with poor or intermittent community connections. When the on-premises facility is briefly disconnected from the web, the Amazon EKS management airplane operating within the cloud is unable to speak with the nodes and the pods. Though the nodes and pods work completely and proceed to serve the appliance on the on-premises native community, Kubernetes could think about them unhealthy and schedule them for alternative when the connection is reestablished (see pod eviction in Kubernetes documentation). This will result in utility downtimes when connectivity is restored.

I talked with Chris, our Kubernetes Product Supervisor and professional, whereas getting ready this weblog publish. He informed me there are no less than seven distinct choices to configure how a management airplane reconnects to its nodes. Until you grasp all these choices, the system standing at re-connection is unpredictable.

To simplify this, we’re providing you with the flexibility to host your complete Amazon EKS cluster on Outposts. On this configuration, each the Kubernetes management airplane and your employee nodes run regionally on premises in your Outposts machine. That method, your cluster continues to function even within the occasion of a short lived drop in your service hyperlink connection. You possibly can carry out cluster operations akin to creating, updating, and scaling purposes throughout community disconnects to the cloud.

EKS Local Cluster DiagramNative clusters are equivalent to Amazon EKS within the cloud and mechanically deploy the most recent safety patches to make it straightforward so that you can preserve an up-to-date, safe cluster. You should utilize the identical tooling you utilize with Amazon EKS within the cloud and the AWS Administration Console for a single interface on your clusters operating on Outposts and in AWS Cloud.

Let’s See It In Motion
Let’s see how we are able to use this new functionality. For this demo, I’ll deploy the Kubernetes management airplane on Amazon Elastic Compute Cloud (Amazon EC2) situations operating on premises on an Outposts rack.

I exploit an Outposts rack already configured. If you wish to learn to get began with Outposts, you may learn the steps on the Get Began with AWS Outposts web page.

AWS Outposts Configuration

This demo has two elements. First, I create the cluster. Second, I hook up with the cluster and create nodes.

Creating Cluster
Earlier than deploying the Amazon EKS native cluster on Outposts, I be sure that I created an IAM cluster function and hooked up the AmazonEKSLocalOutpostClusterPolicy managed coverage. This IAM cluster function will likely be utilized in cluster creation.

Then, I change to the Amazon EKS dashboard, and I choose Add Cluster, then Create.

On the next web page, I selected the placement of the Kubernetes management airplane: the AWS Cloud or AWS Outposts. I choose AWS Outposts and specify the Outposts ID.

EKS Configure Cluster on Outposts

The Kubernetes management airplane on Outposts is deployed on three EC2 situations for top availability. That’s why I see three Replicas. Then, I select the occasion sort in keeping with the variety of employee nodes wanted for workloads. For instance, to deal with 0–20 employee nodes, it’s endorsed to make use of m5d.giant EC2 situations.

Setting Instance Type

On the identical web page, I specify configuration values for the Kubernetes cluster, akin to its Title, Kubernetes model, and the Cluster service function that I created earlier.

Cluster Configuration

On the subsequent web page, I configure the networking choices. Since Outposts is an extension of an AWS Area, I would like to make use of the VPC and Subnets utilized by Outposts to allow communication between Kubernetes management airplane and employee nodes. For Safety Teams, Amazon EKS creates a safety group for native clusters that allows communication between my cluster and my VPC. I may outline extra safety teams in keeping with my utility necessities.


As we run the Kubernetes management airplane inside Outposts, the Cluster endpoint entry can solely be accessed privately. This implies I can solely entry the Kubernetes cluster by means of machines which are deployed in the identical VPC or over the native community by way of the Outposts native gateway with Direct VPC Routing.

Private Cluster Endoint Access
On the subsequent web page, I outline logging. Logging is disabled by default, and I could allow it as wanted. For extra particulars about logging, you may learn the Amazon EKS management airplane logging documentation.

Configure Logging

The final display permits me to evaluate all configuration choices. After I’m happy with the configuration, I choose Create to create the cluster.


The cluster creation takes a couple of minutes. To examine the cluster creation standing, I can use the console or the terminal with the next command:

$ aws eks describe-cluster  
--region <REGION_CODE>  
--name <CLUSTER_NAME>  
--query "cluster.standing"

The Standing part tells me when the cluster is created and lively.

EKS Cluster on Outposts

Along with utilizing the AWS Administration Console, I may create a neighborhood cluster utilizing the AWS CLI. Right here is the command snippet to create a neighborhood cluster with the AWS CLI:

$ aws eks create-cluster  
--region <REGION_CODE>  
--name <CLUSTER_NAME>  
--resources-vpc-config subnetIds=<SUBNET_ID> 
--role-arn <ARN_CLUSTER_ROLE>  
--outpost-config controlPlaneInstanceType=<INSTANCE_TYPE>  

Connecting to the Cluster
The endpoint entry for a neighborhood cluster is personal; subsequently, I can entry it from a neighborhood gateway with Direct VPC Routing or from machines which are in the identical VPC. To learn the way to make use of native gateways with Outposts, you may observe the knowledge on the Working with native gateways web page. For this demo, I exploit an EC2 occasion as a bastion host, and I handle the Kubernetes cluster utilizing kubectl command.

The very first thing I do is edit Safety Teams to open site visitors entry from the bastion host. I’m going to the element web page of the Kubernetes cluster and choose the Networking tab. Then I choose the hyperlink in Cluster safety group.

Networking & Security Group

Then, I add inbound guidelines, and I present entry for the bastion host by specifying its IP handle.

Adding Inbound Rule in Security Group

As soon as I’ve allowed the entry, I create kubeconfig within the bastion host by operating the command:

$ aws eks update-kubeconfig --region <REGION_CODE> --name <CLUSTER_NAME>

Lastly, I exploit kubectl to work together with the Kubernetes API server, similar to regular.

$ kubectl get nodes -o huge
NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME NotReady control-plane,grasp 10h v1.21.13 10.X.Y.Z <none> Bottlerocket OS 1.8.0 (aws-k8s-1.21) 5.10.118 containerd://1.6.6+bottlerocket NotReady control-plane,grasp 10h v1.21.13 10.X.Y.Z <none> Bottlerocket OS 1.8.0 (aws-k8s-1.21) 5.10.118 containerd://1.6.6+bottlerocket NotReady control-plane,grasp 9h v1.21.13 10.X.Y.Z <none> Bottlerocket OS 1.8.0 (aws-k8s-1.21) 5.10.118 containerd://1.6.6+bottlerocket

Kubernetes native clusters operating on AWS Outposts run on three EC2 situations. We see on the output above that the standing of three nodes is NotReady. It’s because they’re utilized by the management airplane solely, and we can not use them to schedule pods.

From this stage, you may deploy self-managed node teams utilizing the Amazon EKS native cluster.

Pricing and Availability
Amazon EKS native clusters are charged on the similar value as conventional EKS clusters. It begins at $0.10/hour. The EC2 situations required to deploy the Kubernetes management airplane and nodes on Outposts are included within the value of the Outposts. As regular, the pricing web page has the small print.

Amazon EKS native clusters can be found within the following AWS Areas: US East (Ohio), US East (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific (Seoul), Asia Pacific (Tokyo), Europe (Frankfurt), Europe (London), Center East (Bahrain), and South America (São Paulo).

Go construct and create your first EKS native cluster immediately!

— seb and Donnie.

Leave a Reply