Skip to content

Latest commit

 

History

History
60 lines (41 loc) · 2.98 KB

deploy_cluster.md

File metadata and controls

60 lines (41 loc) · 2.98 KB
Raw

Deploy an EKS cluster with eksctl

To test this sample repository you need an Amazon EKS cluster with AWS Load Balancer Controller installed. Follow the instructions below to create a new cluster.

NOTE: This sample creates an EKS cluster with 2 m6i.large nodes. The total cost of running the infrastructure for this sample in us-west-2 is approximately $0.40 / hour (considering EKS control plane, EC2 instances, Network Load Balancer and NAT Gateway costs). Remember to delete the cluster once you're finished testing.

Prerequisites:

  1. Download and install eksctl. You can find instructions here.

  2. Download and install the AWS CLI. You can find instructions here.

  3. Download and install helm. You can find instructions here.

Create the cluster

  1. Create an IAM Policy to grant permissions to AWS Load Balancer Controller to create and manage Load Balancers. We will use eksctl later to create an IAM Role for the aws-load-balancer-controller Service account.

    curl -o iam_policy.json https://raw.githubusercontent.com/kubernetes-sigs/aws-load-balancer-controller/v2.3.0/docs/install/iam_policy.json
aws iam create-policy \
  --policy-name AWSLoadBalancerControllerIAMPolicy \
  --policy-document file://iam_policy.json

  2. Clone this GitHub repository and change to the repository directory.

    git clone https://github.com/aws-samples/flux-eks-gitops-config.git
cd k8s-infra

  3. Within docs/examples/cluster.yaml, in the iam: section, we're defining an IAM Role for service account aws-load-balancer-controller in the kube-system namespace. Update line 24 with the IAM policy ARN of the policy you've created before.

    arn:aws:iam::(your_aws_account_number_here):policy/AWSLoadBalancerControllerIAMPolicy

  4. Create the EKS cluster running the following command. It will take 10-15 minutes to create the cluster.

    eksctl create cluster -f docs/examples/cluster.yaml

  5. Once the cluster has been created, install the AWS Load Balancer Controller with the following commands. (If you deploy to a region different to us-west-2, follow instructions here to deploy the AWS Load Balancer controller).

    helm repo add eks https://aws.github.io/eks-charts
helm repo update
    helm install aws-load-balancer-controller eks/aws-load-balancer-controller \
-n kube-system \
--set clusterName=my-eks-cluster \
--set serviceAccount.create=false \
--set serviceAccount.name=aws-load-balancer-controller

You're all set. You can now go to the deploy section.