Skip to main content
← back to extensions

@swamp/aws/eks

v2026.04.23.3

AWS EKS infrastructure models

Repository

https://github.com/systeminit/swamp-extensions

Platforms

linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64

Labels

awsekscloudinfrastructure

Contents

models

Quality score

Verified by Swamp

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @swamp/aws/eks

@swamp/aws/eks/access-entryv2026.04.23.2access_entry.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
ClusterNamestringThe cluster that the access entry is created for.
PrincipalArnstringThe principal ARN that the access entry is created for.
Username?stringThe Kubernetes user that the access entry is associated with.
Tags?arrayAn array of key-value pairs to apply to this resource.
KubernetesGroups?arrayThe Kubernetes groups that the access entry is associated with.
AccessPolicies?arrayAn array of access policies that are associated with the access entry.
Type?stringThe node type to associate with the access entry.
createCreate a EKS AccessEntry
getGet a EKS AccessEntry
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS AccessEntry
updateUpdate a EKS AccessEntry
deleteDelete a EKS AccessEntry
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS AccessEntry
syncSync EKS AccessEntry state from AWS

Resources

state(infinite)— EKS AccessEntry resource state
@swamp/aws/eks/addonv2026.04.23.2addon.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
ClusterNamestringName of Cluster
AddonNamestringName of Addon
AddonVersion?stringVersion of Addon
PreserveOnDelete?booleanPreserveOnDelete parameter value
ResolveConflicts?enumResolve parameter value conflicts
ServiceAccountRoleArn?stringIAM role to bind to the add-on's service account
PodIdentityAssociations?arrayAn array of pod identities to apply to this add-on.
ConfigurationValues?stringThe configuration values to use with the add-on
NamespaceConfig?objectThe custom namespace configuration to use with the add-on
Tags?arrayAn array of key-value pairs to apply to this resource.
createCreate a EKS Addon
getGet a EKS Addon
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS Addon
updateUpdate a EKS Addon
deleteDelete a EKS Addon
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS Addon
syncSync EKS Addon state from AWS

Resources

state(infinite)— EKS Addon resource state
@swamp/aws/eks/capabilityv2026.04.23.2capability.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
ClusterNamestringThe name of the EKS cluster where you want to create the capability.
CapabilityNamestringA unique name for the capability. The name must be unique within your cluster and can contain alphanumeric characters, hyphens, and underscores.
TypeenumThe type of capability to create. Valid values are: ACK (AWS Controllers for Kubernetes, which lets you manage AWS resources directly from Kubernetes), ARGOCD (Argo CD for GitOps-based continuous delivery), or KRO (Kube Resource Orchestrator for composing and managing custom Kubernetes resources).
RoleArnstringThe Amazon Resource Name (ARN) of the IAM role that the capability uses to interact with AWS services. This role must have a trust policy that allows the EKS service principal to assume it, and it must have the necessary permissions for the capability type you're creating.
DeletePropagationPolicyenumSpecifies how Kubernetes resources managed by the capability should be handled when the capability is deleted. Currently, the only supported value is RETAIN which retains all Kubernetes resources managed by the capability when the capability is deleted.
Configuration?objectThe configuration settings for the capability. The structure of this object varies depending on the capability type. For Argo CD capabilities, you can configure IAM Identity Center integration, RBAC role mappings, and network access settings.
Tags?arrayAn array of key-value pairs to apply to this resource.
createCreate a EKS Capability
getGet a EKS Capability
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS Capability
updateUpdate a EKS Capability
deleteDelete a EKS Capability
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS Capability
syncSync EKS Capability state from AWS

Resources

state(infinite)— EKS Capability resource state
@swamp/aws/eks/clusterv2026.04.23.2cluster.ts

Global Arguments

ArgumentTypeDescription
Force?booleanForce cluster version update
AccessConfig?objectAn object representing the Access Config to use for the cluster.
EncryptionConfig?array
KubernetesNetworkConfig?objectThe Kubernetes network configuration for the cluster.
Name?stringThe unique name to give to your cluster.
Version?stringThe desired Kubernetes version for your cluster. If you don't specify a value here, the latest version available in Amazon EKS is used.
ControlPlaneScalingConfig?objectConfiguration for provisioned control plane scaling.
OutpostConfig?objectAn object representing the Outpost configuration to use for AWS EKS outpost cluster.
Tags?arrayAn array of key-value pairs to apply to this resource.
Logging?objectEnable exporting the Kubernetes control plane logs for your cluster to CloudWatch Logs based on log types. By default, cluster control plane logs aren't exported to CloudWatch Logs.
ComputeConfig?objectTodo: add description
StorageConfig?objectTodo: add description
BootstrapSelfManagedAddons?booleanSet this value to false to avoid creating the default networking add-ons when the cluster is created.
DeletionProtection?booleanSet this value to true to enable deletion protection for the cluster.
ZonalShiftConfig?objectThe current zonal shift configuration to use for the cluster.
RoleArnstringThe Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to AWS API operations on your behalf.
UpgradePolicy?objectAn object representing the Upgrade Policy to use for the cluster.
RemoteNetworkConfig?objectConfiguration fields for specifying on-premises node and pod CIDRs that are external to the VPC passed during cluster creation.
ResourcesVpcConfigobjectAn object representing the VPC configuration to use for an Amazon EKS cluster.
createCreate a EKS Cluster
getGet a EKS Cluster
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS Cluster
updateUpdate a EKS Cluster
deleteDelete a EKS Cluster
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS Cluster
syncSync EKS Cluster state from AWS

Resources

state(infinite)— EKS Cluster resource state
@swamp/aws/eks/fargate-profilev2026.04.23.2fargate_profile.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
ClusterNamestringName of the Cluster
FargateProfileName?stringName of FargateProfile
PodExecutionRoleArnstringThe IAM policy arn for pods
Subnets?array
Selectorsarray
Tags?arrayAn array of key-value pairs to apply to this resource.
createCreate a EKS FargateProfile
getGet a EKS FargateProfile
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS FargateProfile
updateUpdate a EKS FargateProfile
deleteDelete a EKS FargateProfile
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS FargateProfile
syncSync EKS FargateProfile state from AWS

Resources

state(infinite)— EKS FargateProfile resource state
@swamp/aws/eks/identity-provider-configv2026.04.23.2identity_provider_config.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
ClusterNamestringThe name of the identity provider configuration.
TypeenumThe type of the identity provider configuration.
IdentityProviderConfigName?stringThe name of the OIDC provider configuration.
Oidc?objectAn object representing an OpenID Connect (OIDC) configuration.
Tags?arrayAn array of key-value pairs to apply to this resource.
createCreate a EKS IdentityProviderConfig
getGet a EKS IdentityProviderConfig
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS IdentityProviderConfig
updateUpdate a EKS IdentityProviderConfig
deleteDelete a EKS IdentityProviderConfig
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS IdentityProviderConfig
syncSync EKS IdentityProviderConfig state from AWS

Resources

state(infinite)— EKS IdentityProviderConfig resource state
@swamp/aws/eks/nodegroupv2026.04.23.2nodegroup.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
AmiType?stringThe AMI type for your node group.
CapacityType?stringThe capacity type of your managed node group.
ClusterNamestringName of the cluster to create the node group in.
DiskSize?numberThe root device disk size (in GiB) for your node group instances.
ForceUpdateEnabled?booleanForce the update if the existing node group's pods are unable to be drained due to a pod disruption budget issue.
InstanceTypes?arraySpecify the instance types for a node group.
Labels?recordThe Kubernetes labels to be applied to the nodes in the node group when they are created.
LaunchTemplate?objectAn object representing a node group's launch template specification.
NodegroupName?stringThe unique name to give your node group.
NodeRolestringThe Amazon Resource Name (ARN) of the IAM role to associate with your node group.
ReleaseVersion?stringThe AMI version of the Amazon EKS-optimized AMI to use with your node group.
RemoteAccess?objectThe remote access (SSH) configuration to use with your node group.
ScalingConfig?objectThe scaling configuration details for the Auto Scaling group that is created for your node group.
SubnetsarrayThe subnets to use for the Auto Scaling group that is created for your node group.
Tags?recordThe metadata, as key-value pairs, to apply to the node group to assist with categorization and organization. Follows same schema as Labels for consistency.
Taints?arrayThe Kubernetes taints to be applied to the nodes in the node group when they are created.
UpdateConfig?objectThe node group update configuration.
NodeRepairConfig?objectThe node auto repair configuration for node group.
WarmPoolConfig?objectThe warm pool configuration details for the Auto Scaling group that is created for the node group.
Version?stringThe Kubernetes version to use for your managed nodes.
createCreate a EKS Nodegroup
getGet a EKS Nodegroup
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS Nodegroup
updateUpdate a EKS Nodegroup
deleteDelete a EKS Nodegroup
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS Nodegroup
syncSync EKS Nodegroup state from AWS

Resources

state(infinite)— EKS Nodegroup resource state
@swamp/aws/eks/pod-identity-associationv2026.04.23.2pod_identity_association.ts

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
ClusterNamestringThe cluster that the pod identity association is created for.
RoleArnstringThe IAM role ARN that the pod identity association is created for.
NamespacestringThe Kubernetes namespace that the pod identity association is created for.
ServiceAccountstringThe Kubernetes service account that the pod identity association is created for.
TargetRoleArn?stringThe Target Role Arn of the pod identity association.
Policy?stringThe policy of the pod identity association.
DisableSessionTags?booleanThe Disable Session Tags of the pod identity association.
Tags?arrayAn array of key-value pairs to apply to this resource.
createCreate a EKS PodIdentityAssociation
getGet a EKS PodIdentityAssociation
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS PodIdentityAssociation
updateUpdate a EKS PodIdentityAssociation
deleteDelete a EKS PodIdentityAssociation
ArgumentTypeDescription
identifierstringThe primary identifier of the EKS PodIdentityAssociation
syncSync EKS PodIdentityAssociation state from AWS

Resources

state(infinite)— EKS PodIdentityAssociation resource state