Kubetier
  1. This is EKS-specific and requires the cluster's authentication mode to be CONFIG_MAP or API_AND_CONFIG_MAP.

    A cluster fully migrated to API mode ignores this ConfigMap entirely.

  2. If aws-auth doesn't exist yet (self-managed clusters, or a fresh EKS cluster before it's applied), create it directly instead of patching.

  3. Patch or create the aws-auth ConfigMap in kube-system, mapping your AWS IAM ARN to the system:masters group

  4. Authenticate via AWS CLI as cluster-admin

Rights needed, any one set:

Note:

AWS now calls aws-auth deprecated in favor of EKS access entries.

Auth mode moves CONFIG_MAP -> API_AND_CONFIG_MAP -> API only, and never moves back.

Once on API mode, aws-auth is permanently inert.

K8s docs ↗