DOC-328: Rename K8s/EKS config variables to cloud-agnostic names#745
Merged
quetzalliwrites merged 3 commits intoJul 1, 2026
Merged
Conversation
The Kubernetes runtime configuration variables were renamed to cloud-agnostic names (K8S_*, K3S_*, K3D_*) in localstack-pro#7642, since they are shared across all services that run workloads on Kubernetes (EKS, Lambda, ECS, ...). Update the config reference and Kubernetes guides to the new names, note the deprecated aliases, and document the CLI v1 LOCALSTACK_-prefix behaviour. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Deploying localstack-docs with
|
| Latest commit: |
0643035
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://5590c389.localstack-docs.pages.dev |
| Branch Preview URL: | https://rename-k8s-eks-config-vars.localstack-docs.pages.dev |
alexrashed
changed the title
alexrashed
changed the title
alexrashed
requested review from
HarshCasper,
nik-localstack,
pinzon,
quetzalliwrites and
remotesynth
as code owners
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
nik-localstack
approved these changes
Jul 1, 2026
nik-localstack
left a comment
nik-localstack
left a comment
Contributor
There was a problem hiding this comment.
LGTM 🙌
Thanks @alexrashed for addressing the comments
Member
Author
|
Thanks, @quetzalliwrites! I think me and @nik-localstack sorted everything out and the updated name already landed in the dev tag of localstack/localstack-pro. So from my perspective this is ready to be merged! 🥳 |
Collaborator
|
ty for your contribution @alexrashed 😸 |
quetzalliwrites
approved these changes
Jul 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
The Kubernetes configuration variables have been renamed to cloud-agnostic names so they apply consistently across both (a) all emulated services that run workloads on Kubernetes (Lambda, ECS, …) and (b) services that run Kubernetes clusters (AWS EKS, Azure AKS). This updates the docs to match.
Changes
aws/configuration/config/configuration.md): renamed the six affected EKS variables in the table, each annotated with its former name as a deprecated alias, and added a note explaining the rename + the CLI v1LOCALSTACK_-prefix behaviour.EKS_LOADBALANCER_PORTandEKS_PERSIST_CLUSTER_CONTENTSare left as-is — they remain AWS/EKS-specific and were not renamed.aws/services/eks.mdx) and Kubernetes enterprise guides (kubernetes-executor.md,pod-configuration.md,configuration.md): updated prose and examples to the new names.LOCALSTACK_K8S_NAMESPACEK8S_NAMESPACELOCALSTACK_K8S_LABELS/LAMBDA_K8S_LABELSK8S_LABELSLOCALSTACK_K8S_ANNOTATIONSK8S_ANNOTATIONSLOCALSTACK_K8S_POD_CONFIGK8S_POD_CONFIGLAMBDA_K8S_SECURITY_CONTEXTK8S_CONTAINER_SECURITY_CONTEXTEKS_K8S_PROVIDERMANAGED_K8S_PROVIDEREKS_STARTUP_TIMEOUTMANAGED_K8S_STARTUP_TIMEOUTEKS_K3S_IMAGE_REPOSITORYK3S_IMAGE_REPOSITORYEKS_K3S_IMAGE_TAGK3S_IMAGE_TAGEKS_K3S_FLAGSK3S_FLAGSEKS_K3D_CLUSTER_TOKENK3D_CLUSTER_TOKENEKS_K3D_VERSIONK3D_VERSIONEKS_START_K3D_LB_INGRESSK3D_START_LB_INGRESSThe old names continue to work as deprecated fallbacks and emit a warning at startup.
Fixes DOC-328
🤖 Generated with Claude Code