이 페이지에서는 Google Kubernetes Engine(GKE)에서 Kubernetes 기능 게이트가 작동하는 방식을 설명합니다. 기능 게이트는 Kubernetes 기능을 전환하는 키-값 쌍 집합입니다. 알파 클러스터에서만 GKE에서 Kubernetes 기능 게이트를 수정할 수 있습니다. 자세한 내용은 알파 클러스터를 참조하세요.
Kubernetes 프로젝트는 시간이 지남에 따라 새로운 기능을 단계적으로 출시합니다. 기능은 알파, 베타, GA 버전일 수 있습니다.
버전 1.26 이상을 실행하는 클러스터에 사용 설정된 기능을 확인하려면 기능 게이트 상태를 확인하세요.
또는 클러스터의 컨트롤 플레인 또는 노드 버전에 해당하는 기능의 단계를 확인하려면 Kubernetes 문서의 알파 또는 베타 기능 기능 게이트 표를 확인하세요.
GKE의 GA Kubernetes 기능
GA(안정화 버전이라고도 부름) Kubernetes 기능은 GKE에서 기본적으로 사용 설정되며, 사용 중지할 수 없습니다.
GKE의 베타 Kubernetes 기능
베타 기능은 일반적으로 GKE에서 기본적으로 사용 설정됩니다.
GKE는 특정 기능과 관련하여 알려진 문제를 완화하거나 이전 버전과의 호환성을 보장하기 위해 또는 GKE에서 해당 기능의 통합 및 검증이 아직 완료되지 않았기 때문에 특정 버전의 특정 베타 기능을 사용 중지할 수 있습니다.
버전 1.26 이상을 실행하는 GKE 클러스터에서 베타 Kubernetes 기능을 사용하려면 기능 게이트 상태를 확인하여 이 기능이 사용 설정되어 있는지 확인하세요. 클러스터에서 1.26 이전 버전을 실행 중인 경우 기능을 테스트하여 기능이 사용 설정되어 있는지 확인할 수 있습니다.
베타 Kubernetes 기능 외에도 GKE 클러스터에서 Kubernetes 베타 API를 사용할 수 있습니다. 버전 1.24 이상에 도입된 베타 API의 경우 클러스터 및 리소스별로 베타 API를 구성해야 합니다.
자세한 내용은 GKE 클러스터에서 Kubernetes 베타 API 사용을 참조하세요.
GKE의 알파 Kubernetes 기능
알파 Kubernetes 기능은 알파 클러스터를 제외한 모든 GKE 클러스터에서 기본적으로 사용 중지됩니다. GKE는 특정 컨트롤 플레인 버전에서 특정 알파 기능을 사용 설정할 수 있습니다.
알파 클러스터에서는 Kubernetes 버전에서 사용 가능한 모든 알파 기능 게이트가 사용 설정되고 기본값에 따라 일부 베타 기능 게이트가 사용 설정됩니다. 특정 버전에서 사용 가능한 기능 게이트와 기본적으로 사용 설정되는 베타 기능에 대한 자세한 내용은 Kubernetes 문서의 알파 또는 베타 기능의 기능 게이트를 참조하세요. 특정 기능 게이트를 선택적으로 수정할 수도 있습니다. 자세한 내용은 기능 게이트 및 알파 클러스터를 참조하세요.
다음 예시와 같이 출력에 기능 게이트의 이름, 해당 단계(""은(는) GA 단계임), 기능 게이트가 사용 설정되었는지 여부가 표시됩니다. 1은(는) 사용 설정됨, 0은(는) 사용 안함을 의미합니다.
다음 출력 예시를 참조하세요.
# HELP kubernetes_feature_enabled [BETA] This metric records the data about the stage and enablement of a k8s feature.
# TYPE kubernetes_feature_enabled gauge
kubernetes_feature_enabled{name="APIListChunking",stage=""} 1
kubernetes_feature_enabled{name="APIPriorityAndFairness",stage=""} 1
kubernetes_feature_enabled{name="APIResponseCompression",stage="BETA"} 1
kubernetes_feature_enabled{name="APISelfSubjectReview",stage=""} 1
kubernetes_feature_enabled{name="APIServerIdentity",stage="BETA"} 1
kubernetes_feature_enabled{name="APIServerTracing",stage="BETA"} 1
kubernetes_feature_enabled{name="AdmissionWebhookMatchConditions",stage="BETA"} 1
...
이 출력은 예를 들어 APIResponseCompression 기능이 사용 설정되어 있고 베타 단계에 있음을 나타냅니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Feature gates\n\n[Autopilot](/kubernetes-engine/docs/concepts/autopilot-overview) [Standard](/kubernetes-engine/docs/concepts/choose-cluster-mode)\n\n*** ** * ** ***\n\nThis page explains how Kubernetes\n[feature gates](https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/)\nfunction in Google Kubernetes Engine (GKE). Feature gates are a set of key-value\npairs that toggle Kubernetes features. You can modify Kubernetes feature\ngates in GKE only with alpha clusters. For more information, see\n[Alpha clusters](/kubernetes-engine/docs/concepts/alpha-clusters).\n\nThe Kubernetes project releases new features in\n[stages](https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/#feature-stages)\nover time. Features can be in the *alpha* , *beta* , or *GA* stage.\n\nTo see what features are enabled for your cluster running version 1.26 or later,\n[check the feature gate state](#check-feature-gate-state).\n\nAlternatively, to verify the stage of a feature corresponding to the version of\nyour cluster's control plane or nodes, check the [Feature gates for Alpha or\nBeta\nfeatures](https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features)\ntable in the Kubernetes documentation.\n\n### GA Kubernetes features in GKE\n\nGA (also referred to as *stable* ) Kubernetes features are *enabled* on\nGKE by default and *cannot be disabled*.\n\n### Beta Kubernetes features in GKE\n\nBeta features are usually *enabled* by default in GKE.\nGKE might disable a specific beta feature for a particular\nversion to mitigate a known issue with the feature, to ensure backwards\ncompatibility, or because integration and qualification of the feature in\nGKE is not yet complete.\n\nIf you want to use a beta Kubernetes feature in your GKE cluster\nrunning version 1.26 or later, check that this feature is enabled by [checking\nthe feature gate state](#check-feature-gate-state). If your cluster is running a\nversion earlier than 1.26, you can check if the feature is enabled by testing\nthe feature.\n\n[Contact Cloud Customer Care](/support) if you can't verify whether the beta\nfeature is enabled for your GKE cluster's control plane or node\nversion.\n\n#### Kubernetes beta APIs with GKE clusters\n\nIn addition to beta Kubernetes features, you can also use Kubernetes beta APIs\nwith GKE clusters. For beta APIs that were introduced with\nversion 1.24 or later, you must configure beta APIs per resource per cluster.\nFor more information, see [Use Kubernetes beta APIs with GKE\nclusters](/kubernetes-engine/docs/how-to/use-beta-apis).\n\n### Alpha Kubernetes features in GKE\n\nAlpha Kubernetes features are disabled by default in all GKE\nclusters, except for [alpha\nclusters](/kubernetes-engine/docs/concepts/alpha-clusters). GKE\nmight enable a specific alpha feature in a specific control plane version.\n\nWith alpha clusters, all alpha feature gates available with the Kubernetes\nversion are enabled, and some beta feature gates, depending on the default\nvalue, are enabled. For more information about which feature gates are available\nwith specific versions, and which beta features are enabled by default, see\n[Feature gates for Alpha or Beta features](https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features)\nin the Kubernetes documentation. You can also selectively modify specific\nfeature gates. For more information, see [Feature gates and alpha\nclusters](/kubernetes-engine/docs/concepts/alpha-clusters#feature-gates).\n\nTo enable all alpha Kubernetes features, create an\n[alpha Standard cluster](/kubernetes-engine/docs/concepts/alpha-clusters).\n| **Warning:** Alpha clusters are intended for experimental purposes and not for production workloads.\n\nCheck feature gate state\n------------------------\n\nWith clusters running version 1.26 or later, you can run a `kubectl` command\nto check what features are enabled.\n\nCheck the feature gate state for your GKE cluster:\n\n1. [Install and configure kubectl access](/kubernetes-engine/docs/how-to/cluster-access-for-kubectl)\n2. Run the following command:\n\n kubectl get --raw /metrics | grep kubernetes_feature_enabled\n\n The output, like in the following example, shows you the name of the feature\n gate, the corresponding stage (`\"\"` is GA), and whether the feature gate is\n enabled. `1` means enabled and `0` means disabled.\n\n See the following example output: \n\n # HELP kubernetes_feature_enabled [BETA] This metric records the data about the stage and enablement of a k8s feature.\n # TYPE kubernetes_feature_enabled gauge\n kubernetes_feature_enabled{name=\"APIListChunking\",stage=\"\"} 1\n kubernetes_feature_enabled{name=\"APIPriorityAndFairness\",stage=\"\"} 1\n kubernetes_feature_enabled{name=\"APIResponseCompression\",stage=\"BETA\"} 1\n kubernetes_feature_enabled{name=\"APISelfSubjectReview\",stage=\"\"} 1\n kubernetes_feature_enabled{name=\"APIServerIdentity\",stage=\"BETA\"} 1\n kubernetes_feature_enabled{name=\"APIServerTracing\",stage=\"BETA\"} 1\n kubernetes_feature_enabled{name=\"AdmissionWebhookMatchConditions\",stage=\"BETA\"} 1\n ...\n\n This output indicates that, for example, the `APIResponseCompression`\n feature is enabled and in the beta stage.\n\nWhat's next\n-----------\n\n- For a complete list of current Kubernetes features, see [Feature\n gates](https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features).\n- For a full list of GKE features, refer to the [GKE release notes](/kubernetes-engine/docs/release-notes)."]]
