v2.9.0

[nrb]

Release notes for Cluster API Provider AWS (CAPA) v2.9.0

Documentation

Changelog since v2.8.4

Urgent Upgrade Notes

(No, really, you MUST read this before you upgrade)

• Action required
  Add missing permissions for controller. Its recommended that you update your CloudFormation stack. (🐛 fix: missing controller permissions #5537, @richardcase)
• Action required
  Garbage collection graduated out of experimental. If you don't want this feature enabled please see the docs on how to disabled it. (🌱 chore: graduate garbage collection #5348, @richardcase)
• Action required
  Support setting role path and permissions boundary on managed IAM roles. If you want to use permission boundaries, then you will need to update your IAM permissions by running clusterawsadm bootstrap iam create-cloudformation-stack again. (✨ Support setting role path and permissions boundary on managed IAM roles #5286, @robinkb)
• Action required
  Support storing Ignition user data in S3 bucket for AWSMachinePool. If you plan to use this feature then you will need to update the permissions for CAPA using clusterawsadm. (✨ Support storing Ignition user data in S3 bucket for AWSMachinePool #5318, @AndiDog)

Changes by Kind

Support

• Add machine pool template for Flatcar Linux (🌱 Add machine pool template for Flatcar Linux #5522, @AndiDog)
• Bump calico used in e2e tests to newest version. (🌱 chore: bump calico for e2e tests #5459, @richardcase)
• Bump github.com/golang/glog to v1.2.5 (🌱 Bump github.com/golang/glog to v1.2.5 #5590, @damdo)
• Bump to go 1.23 (🌱 Bump to go 1.23 #5437, @damdo)

Deprecation

• Migrate ServiceLimiters to AWS SDK V2 (🌱 Migrate ServiceLimiters to AWS SDK V2 #5574, @punkwalker)
• Migrate autoscaling to AWS SDK V2 (✨Migrate autoscaling to AWS SDK V2 #5497, @alexander-demicev)
• Migrate elb to AWS SDK v2 (🌱Migrate elb to AWS SDK v2 #5572, @phuhung273)
• Migrate iam to aws sdk v2 (🌱 Migrate iam to aws sdk v2 #5526, @alexander-demicev)
• Migrate instancestate code to AWS SDK v2 (🌱Migrate instancestate to AWS SDK v2 #5562, @phuhung273)
• Migrate sts to sdk v2 (🌱 Migrate sts to sdk v2 #5601, @alexander-demicev)

API Change

• Add support for managed machine AMI types BottleRocket, AL2023 and Windows ( ✨ Add all ManagedMachineAMITypes supported by AWS API #5540, @afarbos)

Feature

• Add ClusterClass support for EKS clusters (✨ Add ClusterClass support for EKS clusters #5375, @alexander-demicev)
• Add support for 'fast' channelGroupType in ROSA provider (✨ Add support for 'fast' channelGroupType in ROSA provider #5587, @cblecker)
• Adds the capability of provisioning machines on to dedicated hosts. (✨ Initial dedicated hosts implementation #5548, @rvanderp3)
• Control plane load balancers are created concurrently, reducing cluster
  installation time when specifying a secondary control plane load balancer. (✨Create multiple control plane loadbalancers concurrently #5569, @mdbooth)
• Migrate EC2 packages to AWS SDK v2 (✨ Migrate ec2 to AWS SDK V2 #5521, @yiannistri)
• Migrate EKS packages to AWS SDK v2 (✨ Migrate EKS packages to AWS SDK v2 #5498, @punkwalker)
• Migrate Node packages to AWS SDK v2 (✨ Migrate Node packages to AWS SDK v2 #5584, @LiangquanLi930)
• Migrate secretsmanager code to AWS SDK v2 (✨ Migrate Secrets Manager packages to AWS SDK v2 #5615, @LiangquanLi930)
• Migrate ssm code to AWS SDK v2 (✨ Migrate ssm code to AWS SDK v2 #5529, @miyadav)
• Migrate the S3 service to aws-sdk-go-v2 (✨ Migrate S3, Sessions and Endpoints packages to AWS SDK v2 #5389, @punkwalker)
• Support additional security group ingress rules for all nodes (✨ Support additional security group ingress rules for all nodes #5224, @AndiDog)
• Support running EC2 instances with capacity reservation preferences. i.e. capacityReservationPreference: none (✨ Capacity reservation preferences #5609, @BraeTroutman)
• ✨ Added support for Amazon Linux 2023 and Amazon Linux 2023 GPU AMI lookup in EKS optimized AMI workflow. (✨ feat: add amazon-linux-2023 ami lookup parameters for ssm #5517, @matzegebbe)

Documentation

• Add feature gate environment variable for machine pool machines (✨ Add feature gate environment variable for machine pool machines #5575, @AndiDog)
• Update docs on generating clusterclass based test flavours. (📖 docs: update README for e2e templates and clusterclass notes #5466, @richardcase)

Bug or Regression

• Add Version to ROSA Control Plane Status (🐛 Add Version to ROSA Control Plane Status #5443, @PanSpagetka)
• Apply CAPI machinepool changes to ROSAMachinePool (🐛 ROSA: Apply CAPI machinepool changes to ROSAMachinePool #5386, @PanSpagetka)
• Don't overwrite subnet spec tags with tags from the subnet on AWS (🐛 Don't overwrite subnet spec tags with AWS tags #5474, @fiunchinho)
• Enable NLB target group connection draining to allow for graceful shutdown of apiserver processes (🐛 Enable NLB connection draining for graceful apiserver shutdown. #5589, @benluddy)
• Fix addition logic of getAttemptContextMiddleware (🐛 Fix addition logic of getAttemptContextMiddleware #5580, @punkwalker)
• Fix determined value for MinSize field of ASG, avoiding unnecessary updates to ASG (🐛 Fix determined value for MinSize field of ASG #5523, @AndiDog)
• Fix error message text in rosa control plane controller (🐛 Fix error message in rosa control plane controller #5456, @mzazrivec)
• Fix issue with creation of ec2 instances when specifying an existing network interface (🐛 do not set tags on existing network interfaces when creating ec2 instances #5595, @kylewuolle)
• Fix update ROSA-HCP version channel group (🐛 ROSA: Fix update channel group #5616, @serngawy)
• Fix: Ignore conflict resolution and correctly compare configuration for AddOn reconciliation (🐛 fix(addons): avoid infinite reconciliation loop #5458, @mloiseleur)
• Fix: disallow setting of CapacityReservationPreference: CapacityReservationsOnly when MarketType: Spot or SpotMarketOptions is set (🐛 Add validation to prevent Spot instances with CapacityReservationsOnly preference #5633, @BraeTroutman)
• Fixed the default AMI lookup when using a bastion. (🐛 fix: default bastion ami lookup #5531, @richardcase)
• LaunchTemplate needs to be updated if spot options are changed (🐛 Launchtemplate needs to be updated if spot options are changed #5496, @fiunchinho)
• Set conditions to true when reconciliation is successful (🐛 Set conditions to true when reconciliation is successful #5591, @fiunchinho)
• Update launch template if PrivateDnsName changes (🐛 Update launch template if PrivateDnsName changes #5508, @fiunchinho)
• Update launch template if capacity-block reservation id changes (🐛 Update launch template if capacity-block reservation id changes #5506, @fiunchinho)
• Update launch template if ssh key name changes (🐛 Update launch template if ssh key name changes #5507, @fiunchinho)
• Wire logger into machine scope (🐛 Wire logger into machine scope #5462, @fiunchinho)
• 🐛 Fix missing CRD validation for Amazon Linux 2023 eksLookupType enum values, completing the AL2023 support introduced in v2.8. ( 🐛 Fix missing CRD validation for Amazon Linux 2023 eksLookupType #5558, @AmitSahastra)

Other (Cleanup or Flake)

• AWS SDK V1 Cleanup (⚠️ AWS SDK V1 cleanup #5620, @punkwalker)
• Migrate ELB garbage collection to AWS SDK v2 (🌱 Migrate gc to aws sdk v2 #5518, @Danil-Grigorev)

Uncategorized

• Add Kubernetes API Linter to project. (🌱 feat: add kal linter #5392, @richardcase)
• Adding support for custom Lifecycle Hooks in AWSMachinePools for external hooks (e.g support for the aws-node-termination-handler with SQS) (✨feat(awsmachinepool): custom lifecyclehooks for machinepools #4875, @sebltm)
• Bump CAPI to v1.10.2 (🌱 Bump CAPI to v1.10.2 #5447, @tamalsaha)
• Skip adding reserved aws internal tags to resources as they are invalid (🐛 Skip adding reserved aws internal tags to resources as they are invalid #5461, @athiruma)
• Update documentation to refer to new e2e documentation link. (📖 Fixes 5544: update link to point to new e2e documentation location #5545, @rvanderp3)

The images for this release are:

registry.k8s.io/cluster-api-aws/cluster-api-aws-controller:v2.9.0

Thanks to all our contributors.

---

This discussion was created from the release v2.9.0.