AWS Module

AWS Module provides support AWS packages for SIGHUP Distribution (SD).

If you are new to SD please refer to the official documentation on how to get started with SD.

Overview

AWS Module uses a collection of open source tools to make an EKS cluster on AWS production grade.

Packages

The following packages are included in AWS Module:

Package	Version	Description
cluster-autoscaler	v1.29.0 - v1.35.0	A component that automatically adjusts the size of a Kubernetes Cluster
IAM role for cluster-autoscaler	-	Terraform module to manage IAM role used by cluster-autoscaler
aws-node-termination-handler	v1.25.6	Automatically manage graceful termination of pods in the event that one node is retired by AWS
aws-load-balancer-controller	v3.4.0	AWS Load Balancer Controller is a controller to help manage Elastic Load Balancers for a Kubernetes cluster
IAM role for aws-load-balancer-controller	-	Terraform module to manage IAM role used by aws-load-balancer-controller
IAM role for aws-ebs-csi-driver	-	Terraform module to manage IAM role used by EBS CSI driver
EKS Addons	-	Terraform module to install the main EKS Addons (coredns, EBS CSI Driver, snapshot controller, VPC cni)

Click on each package to see its full documentation.

Compatibility

Kubernetes Version	Compatibility	Notes
1.30.x	✅	No known issues
1.31.x	✅	No known issues
1.32.x	✅	No known issues
1.33.x	✅	No known issues
1.34.x	✅	No known issues
1.35.x	✅	No known issues

Check the compatibility matrix for additional informations about previous releases of the modules.

Usage

AWS Module is part of SIGHUP Distribution (SD) and is deployed automatically by furyctl when you create an EKS cluster. You don't need to download, vendor or install its packages manually.

Configuration

When the provider is EKS, the module is deployed with sensible defaults. Configuration is optional: you can customize its packages under spec.distribution.modules.aws in your furyctl.yaml. If you omit the block, the defaults are applied.

apiVersion: kfd.sighup.io/v1alpha2
kind: EKSCluster
spec:
  distribution:
    modules:
      aws:
        clusterAutoscaler:
          overrides:
            nodeSelector:
              node.kubernetes.io/role: infra
        loadBalancerController:
          overrides:
            iamRoleName: aws-load-balancer-controller
        ebsCsiDriver: {}
        ebsSnapshotController: {}

See the EKSCluster configuration reference for the full list of available options.

To install SD on EKS from scratch, follow the Getting started on EKS guide.

Contributing

Before contributing, please read first the Contributing Guidelines.

Reporting Issues

In case you experience any problem with the module, please open a new issue.

License

This module is open-source and it's released under the following LICENSE.