AWS EKS Installation

Summary

This installation covers the steps involved in setting up an AWS EKS cluster, configuring NFS storage, creating a node group, installing the AWS CLI, accessing the EKS cluster, and finally installing the Lamini platform on the EKS cluster.

Create EKS Cluster

• Search for EKS on AWS console
• Create a new cluster
• Configure cluster details (name, IAM role, networking)
• Create the cluster

Set Up NFS

• Create AWS S3 File Gateway
• Configure gateway settings (name, timezone, instance key pair)
• Launch gateway instance
• Activate and configure gateway
• Create file share and note the NFS IP and path

Create Node Group

• Select the created EKS cluster
• Add a node group
• Create an instance role with necessary policies
• Configure node group details (name, role, instance type, disk size)
• Create the node group and note the node names

Install AWS CLI

• Follow AWS instructions to install the AWS CLI
• Verify installation

Access EKS Cluster

• Create AWS Access Key ID and Secret Access Key
• Configure AWS credentials
• Update kubeconfig for the EKS cluster

Install Lamini Installer

• Follow the "Installing Lamini Platform on Kubernetes" guide
• Complete Lamini installation on EKS

Create EKS Cluster

• Type EKS in the AWS search bar of the AWS landing page. Select the EKS.

• Click Add Cluster and then Create, to create a cluster.

• Enter a cluster name.

• Create an IAM role for EKS.

• Select the EKS service and check the EKS - Cluster

• Enter the role name.

• Select networking and specify the default security groups.

• Create the EKS cluster.

• It will show the creating status.

Set Up NFS

• Create AWS S3 File Gateway. Type Storage Gateway in the search bar of AWS Console.

• Click on Create gateway.

• Enter gateway name and timezone.

• Select EC2 as platform option and create the instance key pair.

• Enter the key pair name and create the key pair. Download the pem file to be used for accessing the instance for deployment later.

• Launch the instance.

• Connect to AWS - select the IP address connection option and publicly accessible endpoint option.

• Activate gateway.

• Configure after activating the gateway.

• Create file share.

• Select the gateway that just created, set NFS protocol, and then create the S3 bucket.

• Select the S3 that was just created.

• Create the file share.

• Note down the NFS IP and path that will be used in the NFS setup for Lamini installation.

Create Node Group

• Select the EKS cluster that was just created.

• Select the Compute.

• Select Add Node Group.

• Create an instance role with policy.

• Select EC2.

• Ensure to select the following policies: AmazonEC2ContainerRegistryReadOnly AmazonEKSWorkerNodePolicy AmazonEKS_CNI_Policy

• Enter a role name and create the role.

• Enter the node group name and the role that was created.

• Set Amazon Linux 2 GPU Enabled AMI type, select the desired instance type with GPU, typically the G and P types. Set disk size to at least 100 G.

• Specify the desired node size.

• Create the node group.

• Once the node group has been created, note down the node names that will be used in the lamini installer configuration.

Install AWS CLI

• Follow the AWS instruction to install the AWS CLI https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html

• Check the AWS CLI installation.

aws --version

Access EKS Cluster

• Create and get the AWS Access Key ID and AWS Secret Access Key.

• Configure AWS credential.

aws configure

aws eks update-kubeconfig --name <eks-cluster-name>

Install Lamini Installer

• Follow the Installing Lamini Platform on Kubernetes section in Kube installer README.md to complete the Lamini installation on EKS.