Skip to content

Add eks-version-upgrade-readiness custom transformation#72

Open
brunokktro wants to merge 5 commits into
aws-samples:mainfrom
brunokktro:add-eks-version-upgrade-readiness
Open

Add eks-version-upgrade-readiness custom transformation#72
brunokktro wants to merge 5 commits into
aws-samples:mainfrom
brunokktro:add-eks-version-upgrade-readiness

Conversation

@brunokktro

@brunokktro brunokktro commented Jul 18, 2026

Copy link
Copy Markdown

Summary

Adds a new community-sourced custom transformation for AWS Transform: EKS Version Upgrade Readiness.

Analyzes and transforms Kubernetes manifests, Helm charts, Kustomize overlays, Terraform, and AWS CDK code for compatibility with a target Amazon EKS/Kubernetes version. It detects removed/deprecated APIs, updates apiVersion fields and resource structures, validates addon compatibility, and generates a MIGRATION_REPORT.md with manual action items and a documented sequential upgrade path.

This complements (does not duplicate) cluster-upgrade orchestration tools — it focuses exclusively on the code that runs on the cluster, not the cluster upgrade execution itself.

What's included

community-sourced-transformations/eks-version-upgrade-readiness/
├── README.md                              # Overview, usage, atx publish/exec commands
├── SKILL.md                                # Skill definition (objective, scope, workflow, exit criteria)
└── references/
    ├── api-removals-by-version.md          # K8s API removal table, v1.16-v1.36 + quick lookup
    ├── eks-specific-changes.md             # Amazon EKS-specific changes, addon compatibility matrix
    └── examples-before-after.md            # 8 concrete before/after transformation examples

Testing

  • Content validated against the official Kubernetes API deprecation guide and Amazon EKS release notes for version-specific changes (AL2 AMI deprecation, StorageClass defaults, IAM requirements, addon minimum versions).
  • Followed the same README/SKILL.md/references structure as the existing jboss-to-springboot and kubernetes-readiness-migration samples in this directory.
  • Not yet run end-to-end via atx custom def exec against a live customer repo — happy to iterate on structure/content based on maintainer feedback.

Notes

  • No breaking changes to existing samples; this is a new, isolated directory under community-sourced-transformations/.

brunokktro and others added 4 commits July 18, 2026 08:31
Analyzes and transforms Kubernetes manifests, Helm charts, Kustomize
overlays, Terraform, and CDK code for Amazon EKS version upgrade
compatibility. Detects removed/deprecated APIs, updates apiVersions
and resource fields, validates addon compatibility, and generates a
migration report with manual action items and a sequential upgrade
path. Complements the Upgrade Controller for Amazon EKS (cluster-side
execution) by handling the code-side readiness.
- api-removals-by-version.md: Kubernetes API removal table (1.16-1.36)
  plus quick upgrade-path lookup
- eks-specific-changes.md: EKS-specific changes per version and addon
  compatibility matrix
- examples-before-after.md: 8 concrete before/after transformations
…oubleshooting, and Repository Structure

- Replace internal GitLab tool references with public EKS upgrade docs
  (cluster upgrade best practices + EKS Upgrade Insights)
- Add BENCHMARKS.md with end-to-end test results: 3 repositories
  (K8s manifests, Terraform, Helm) run via atx custom def exec,
  14/14 detections, 13/13 transformations, all validators passing
- Add Troubleshooting section (6 scenarios)
- Add Repository Structure tree at the bottom of the README
kubectl apply --dry-run=server against a real EKS 1.35 control plane:
6/6 transformed resources accepted. Negative confirmation included:
the flag-only PSP correctly fails (API removed), validating the design.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant