About

The Gloo Gateway add-on for Amazon EKS streamlines the installation, configuration, and updates of Gloo Gateway on your EKS clusters. This add-on installs Gloo Gateway in a mode that fully supports the Kubernetes Gateway API, with all required Custom Resource Definitions (CRDs), including the Kubernetes Gateway API CRDs, packaged and deployed automatically. No additional setup is needed. Amazon ensures compatibility with EKS, delivering a secure and reliable release. Leveraging this add-on can help your organization meet internal compliance requirements and manage account spending effectively. For more details, refer to the AWS documentation.

Before you begin

  1. Create or use existing EKS clusters.

  2. Install any CLI tools that you might need to work with your cluster, such as the following:

    • aws cli, the Amazon Web Services command line tool.
    • eksctl, the AWS EKS command line tool.
    • kubectl, the Kubernetes command line tool. Download the kubectl version that is within one minor version of the Kubernetes clusters you plan to use.
    • istioctl, the Istio command line tool.
    • terraform, the infrastructure-as-code configuration language command line tool from HashiCorp.
  3. If you plan to install the add-on via automation such as Terraform, you must first accept the subscription terms in the AWS Marketplace console.

Install the EKS add-on

You can install the EKS add-on via the AWS console, the eksctl or aws CLI tools, or a GitOps tool such as Terraform.

Verify your installation

After the add-on is installed, verify that Gloo Gateway is working.

Verify that the pods have a status of Running and Completed.

  kubectl get pods -n gloo-system
  

Example output:

  NAME                             READY   STATUS      RESTARTS      AGE
apply-crds-h54qb                 0/1     Completed   0             53s
discovery-7fd979d499-p5q2j       1/1     Running     0             53s
gateway-proxy-64786d76b5-g79k8   1/1     Running     0             53s
gloo-c7fb5d8fd-j9c9n             1/1     Running     0             53s
gloo-resource-rollout-4vbg4      0/1     Completed   0             53s
  

Next steps

Now that Gloo Gateway is installed in your cluster, review the following next steps you can take.

Uninstall the add-on

You can uninstall Gloo Gateway from your EKS cluster by using AWS. For more information about removing an EKS add-on, see the AWS docs.

  1. Remove the Gloo Gateway add-on for EKS.

  2. Clean up the gloo-system namespace in your cluster.

      kubectl delete namespace gloo-system