AWS EBS CSI Driver

This module provides the CSI driver for provisioning AWS EBS volumes as PVs for pods in the cluster via aws-ebs-csi-driver.

Additionally, this creates two base Storage Classes:

ebs-standard: Uses EBS gp3 volumes. Is the default Storage Class if none is indicated.
ebs-standard-retained: Uses EBS gp3 volumes. Must be manually deleted which is useful for databases where you do not want to accidentally lose data.

Usage

Extra Storage Classes

You can create additional EBS-backed storage classes by providing the extra_storage_classes input.

See this reference document for descriptions of the various parameters.

All storage classes created by this module have the following properties:

Creates volumes that use the ext4 filesystem
Uses encrypted volumes
Allows volume expansions and creates volumes that are eligible for autoresizing by the PVC autoresizer
Have a volume binding mode of WaitForFirstConsumer
Creates volumes that are named {{ .PVCNamespace }}/{{ .PVCName }} in AWS (via the Name tag)

Providers

The following providers are needed by this module:

aws (5.39.1)
helm (2.12.1)
kubectl (2.0.4)
kubernetes (2.27.0)
random (3.6.0)

Required Inputs

The following input variables are required:

eks_cluster_name

Description: The name of the EKS cluster.

Type: string

extra_storage_classes

Description: Extra EBS-backed storage classes to add to the cluster. Keys are the name of the storage class and values are their configuration.

Type:

map(object({
    type             = optional(string, "gp3")
    reclaim_policy   = optional(string, "Delete")
    iops_per_gb      = optional(number, null)
    iops             = optional(number, null)
    throughput       = optional(number, 125)
    block_express    = optional(bool, false)
    block_size       = optional(number, null)
    inode_size       = optional(number, null)
    bytes_per_inode  = optional(number, null)
    number_of_inodes = optional(number, null)
    big_alloc        = optional(bool, false)
    cluster_size     = optional(number, null)
  }))