Set up an Elastic Kubernetes Service (EKS) cluster

Learn how to set up an EKS Cluster

This guide walks you through installing an Elastic Kubernetes Service (EKS) cluster. If you need more information, refer to Create an Amazon EKS cluster

Prerequisites

• Install:
  • kubectl
  • AWS CLI
  • eksctl
  • An existing VPC and subnets

Deploy an EKS cluster

1. In the terminal, log into AWS.

   aws configure

2. Create an EKS cluster. To use a specific version of Kubernetes, use --version (1.13.x or newer version required).

   eksctl create cluster --name [your_eks_cluster_name] --region [your_aws_region] --version [kubernetes_version] --vpc-private-subnets [subnet_list_seprated_by_comma] --without-nodegroup

   Change the values for vpc-private-subnets to meet your requirements. You can also add additional IDs. You must specify at least two subnet IDs. If you’d rather specify public subnets, you can change --vpc-private-subnets to --vpc-public-subnets.

3. Verify kubectl context:

   kubectl config current-context

4. Update the security group rule to allow the EKS cluster to communicate with the Dapr Sidecar by creating an inbound rule for port 4000.

   aws ec2 authorize-security-group-ingress --region [your_aws_region] \
   --group-id [your_security_group] \
   --protocol tcp \
   --port 4000 \
   --source-group [your_security_group]

Troubleshooting

Access permissions

If you face any access permissions, make sure you are using the same AWS profile that was used to create the cluster. If needed, update the kubectl configuration with the correct profile:

aws eks --region [your_aws_region] update-kubeconfig --name [your_eks_cluster_name] --profile [your_profile_name]

Related links

• Learn more about EKS clusters
• Learn more about eksctl
• Try out a Dapr quickstart
• Learn how to deploy Dapr on your cluster
• Kubernetes production guidelines

Last modified October 11, 2024: Fixed typo (#4389) (fe17926)