Amazon EKS add-on

Install the EKS add-on by using the eksctl command line tool. For complete EKS add-on instructions, see the AWS docs (eksctl Tab).

1. Get the name and region of the cluster that you want to install the add-on in. If you do not have an $AWS_REGION environment variable set, replace the variable with any region in the following command.

   eksctl get clusters -A --region $AWS_REGION

2. Set the name and region of the cluster that you want to install the add-on in. Replace <your-cluster-region> and <name-of-your-EKS-cluster> with the values that you got in the previous step.

   # Set your cluster region (for example, us-west-2)
   export REGION=<your-cluster-region>
   
   # Set the name of your EKS cluster
   export CLUSTER=<name-of-your-EKS-cluster>

3. Install the add-on, replacing the cluster and region with the values that you got in the previous step. For more options, such as specific version of the add-on, run eksctl create addon --help.

   eksctl create addon --name solo-io_gloo-gateway --cluster $CLUSTER --region $REGION --version v1.18.2-eksbuild.1

4. Check that the status of the addon is ACTIVE with null issues. If the installation takes more than a few minutes, review the add-on status. Common issues include a lack of compute resources to run the deployment, such as no nodes.

   eksctl get addon --name solo-io_gloo-gateway --cluster $CLUSTER --region $REGION -oyaml

   Example output:

     IAMRole: ""
     Issues: null
     Name: solo-io_gloo-gateway
     NewerVersion: ""
     PodIdentityAssociations: null
     Status: ACTIVE
     Version: v1.18.2-eksbuild.1     

Install the EKS add-on by using the aws command line tool. For complete AWS command line tool add-on instructions, see the AWS docs (AWS CLI tab).

1. Specify the region of the cluster and confirm the cluster name where you want to install the add-on. Replace <your-cluster-region> with the EKS clusters region.

   # Set your cluster region (for example, us-west-2)
   export REGION=<your-cluster-region>
   aws eks list-clusters --region $REGION

2. Set the name of the cluster that you want to install the add-on in. Replace <name-of-your-EKS-cluster> with the value that you got in the previous step.

   # Set the name of your EKS cluster
   export CLUSTER=<name-of-your-EKS-cluster>

3. Install the add-on. For more options, such as to set a specific version of the add-on, run eksctl create addon --help.

   aws eks create-addon --cluster-name $CLUSTER --region $REGION \
     --addon-name solo-io_gloo-gateway \
     --addon-version v1.18.2-eksbuild.1

4. Check that the status of the addon is ACTIVE with empty [] in Issues section. If the installation takes more than a few minutes, review the add-on status. Common issues include a lack of compute resources to run the deployment, such as no nodes.

   aws eks describe-addon --cluster-name $CLUSTER --region $REGION --addon-name solo-io_gloo-gateway

   Example output:

   {
       "addon": {
           "addonName": "solo-io_gloo-gateway",
           "clusterName": "<...omitted...>",
           "status": "ACTIVE",
           "addonVersion": "v1.18.2-eksbuild.1",
           "health": {
               "issues": []
           },
           "addonArn": "arn:aws:eks:us-west-2:123456789012:addon/<...omitted...>/solo-io_gloo-gateway/e6c89977-fb1c-3dda-a2b2-455b239b15ec",
           "createdAt": "2025-01-15TXX:XX:XX.000000-07:00",
           "modifiedAt": "2025-01-15TXX:XX:XX.000000-07:00",
           "tags": {}
       }
   }   

Install the EKS add-on by using Terraform, such as for a GitOps pipeline.

1. Get the cluster name, cluster region, and EKS add-on version that you want to install.

2. Use the following example inside of your Terraform project, or directly by saving the example as main.tf. Replace the region, cluster_name and addon_version with the values that you previously got. (The configuration_values sub-section is provided as an example. Decide on the values that you want to customize or remove the section entirely if the default values are sufficient.)

   provider "aws" {
     region = local.region
   }
   
   terraform {
     required_version = ">= 1.0.0"
   
     required_providers {
       aws = {
         source  = "hashicorp/aws"
         version = ">= 4.47"
       }
     }
   }
   
   locals {
     region        = "<your-cluster-region>"      # Replace with your cluster region (for example, us-west-2)
     cluster_name  = "<name-of-your-EKS-cluster>" # Replace with the name of your EKS cluster
     addon_version = "v1.18.2-eksbuild.1"         # Replace with your desired addon version; for Ambient add extra '0' *(for example, v1.21.20-eksbuild.1)
   }
   
   resource "aws_eks_addon" "solo-io_gloo-gateway" {
     cluster_name                = local.cluster_name
     addon_name                  = "solo-io_gloo-gateway"
     resolve_conflicts_on_update = "OVERWRITE"
     addon_version               = local.addon_version
   }   

3. From the directory of the main.tf file, run the Terraform commands to build the EKS add-on infrastructure.

   terraform init
   terraform plan
   terraform apply