Information in this document may be out of date

This document has an older update date than the original, so the information it contains may be out of date. If you're able to read English, see the English version for the most up-to-date information: Feature Gates

기능 게이트

이 페이지에는 관리자가 다른 쿠버네티스 컴포넌트에서 지정할 수 있는 다양한 기능 게이트에 대한 개요가 포함되어 있다.

기능의 단계(stage)에 대한 설명은 기능 단계를 참고한다.

개요

기능 게이트는 쿠버네티스 기능을 설명하는 일련의 키=값 쌍이다. 각 쿠버네티스 컴포넌트에서 --feature-gates 커맨드 라인 플래그를 사용하여 이러한 기능을 켜거나 끌 수 있다.

각 쿠버네티스 컴포넌트를 사용하면 해당 컴포넌트와 관련된 기능 게이트 집합을 활성화 또는 비활성화할 수 있다. 모든 컴포넌트에 대한 전체 기능 게이트 집합을 보려면 -h 플래그를 사용한다. kubelet과 같은 컴포넌트의 기능 게이트를 설정하려면, 기능 쌍 목록에 지정된 --feature-gates 플래그를 사용한다.

--feature-gates=...,GracefulNodeShutdown=true

다음 표는 다른 쿠버네티스 컴포넌트에서 설정할 수 있는 기능 게이트를 요약한 것이다.

"도입" 열에는 기능이 소개되거나 릴리스 단계가 변경될 때의 쿠버네티스 릴리스가 포함된다.
"종료" 열이 비어 있지 않으면, 여전히 기능 게이트를 사용할 수 있는 마지막 쿠버네티스 릴리스가 포함된다.
기능이 알파 또는 베타 상태인 경우, 알파/베타 기능 게이트 테이블에서 나열된 기능을 찾을 수 있다.
기능이 안정된 경우 해당 기능에 대한 모든 단계를 승급(graduated)/사용 중단(deprecated) 기능 게이트 테이블에 나열할 수 있다.
승급/사용 중단 기능 게이트 테이블에는 사용 중단된 기능과 철회(withdrawn) 기능의 목록도 있다.

참고: 제거된 옛 기능 게이트의 레퍼런스를 보려면, 제거된 기능 게이트 페이지를 참고한다.

알파 또는 베타 기능을 위한 기능 게이트

알파 또는 베타 단계에 있는 기능을 위한 기능 게이트
기능	디폴트	단계	도입	종료
`APIListChunking`	`false`	알파	1.8	1.8
`APIListChunking`	`true`	베타	1.9
`APIPriorityAndFairness`	`false`	알파	1.18	1.19
`APIPriorityAndFairness`	`true`	베타	1.20
`APIResponseCompression`	`false`	알파	1.7	1.15
`APIResponseCompression`	`true`	베타	1.16
`APISelfSubjectAttributesReview`	`false`	알파	1.26
`APIServerIdentity`	`false`	알파	1.20	1.25
`APIServerIdentity`	`true`	베타	1.26
`APIServerTracing`	`false`	알파	1.22
`AllowInsecureBackendProxy`	`true`	베타	1.17
`AnyVolumeDataSource`	`false`	알파	1.18	1.23
`AnyVolumeDataSource`	`true`	베타	1.24
`AppArmor`	`true`	베타	1.4
`CPUManagerPolicyAlphaOptions`	`false`	알파	1.23
`CPUManagerPolicyBetaOptions`	`true`	베타	1.23
`CPUManagerPolicyOptions`	`false`	알파	1.22	1.22
`CPUManagerPolicyOptions`	`true`	베타	1.23
`CSIMigrationPortworx`	`false`	알파	1.23	1.24
`CSIMigrationPortworx`	`false`	베타	1.25
`CSIMigrationRBD`	`false`	알파	1.23
`CSINodeExpandSecret`	`false`	알파	1.25
`CSIVolumeHealth`	`false`	알파	1.21
`CrossNamespaceVolumeDataSource`	`false`	알파	1.26
`ContainerCheckpoint`	`false`	알파	1.25
`ContextualLogging`	`false`	알파	1.24
`CustomCPUCFSQuotaPeriod`	`false`	알파	1.12
`CustomResourceValidationExpressions`	`false`	알파	1.23	1.24
`CustomResourceValidationExpressions`	`true`	베타	1.25
`DisableCloudProviders`	`false`	알파	1.22
`DisableKubeletCloudCredentialProviders`	`false`	알파	1.23
`DownwardAPIHugePages`	`false`	알파	1.20	1.20
`DownwardAPIHugePages`	`false`	베타	1.21	1.21
`DownwardAPIHugePages`	`true`	베타	1.22
`DynamicResourceAllocation`	`false`	알파	1.26
`EndpointSliceTerminatingCondition`	`false`	알파	1.20	1.21
`EndpointSliceTerminatingCondition`	`true`	베타	1.22
`ExpandedDNSConfig`	`false`	알파	1.22
`ExperimentalHostUserNamespaceDefaulting`	`false`	베타	1.5
`GRPCContainerProbe`	`false`	알파	1.23	1.23
`GRPCContainerProbe`	`true`	베타	1.24
`GracefulNodeShutdown`	`false`	알파	1.20	1.20
`GracefulNodeShutdown`	`true`	베타	1.21
`GracefulNodeShutdownBasedOnPodPriority`	`false`	알파	1.23	1.23
`GracefulNodeShutdownBasedOnPodPriority`	`true`	베타	1.24
`HPAContainerMetrics`	`false`	알파	1.20
`HPAScaleToZero`	`false`	알파	1.16
`HonorPVReclaimPolicy`	`false`	알파	1.23
`InTreePluginAWSUnregister`	`false`	알파	1.21
`InTreePluginAzureDiskUnregister`	`false`	알파	1.21
`InTreePluginAzureFileUnregister`	`false`	알파	1.21
`InTreePluginGCEUnregister`	`false`	알파	1.21
`InTreePluginOpenStackUnregister`	`false`	알파	1.21
`InTreePluginPortworxUnregister`	`false`	알파	1.23
`InTreePluginRBDUnregister`	`false`	알파	1.23
`InTreePluginvSphereUnregister`	`false`	알파	1.21
`IPTablesOwnershipCleanup`	`false`	알파	1.25
`JobMutableNodeSchedulingDirectives`	`true`	베타	1.23
`JobPodFailurePolicy`	`false`	알파	1.25	1.25
`JobPodFailurePolicy`	`true`	베타	1.26
`JobReadyPods`	`false`	알파	1.23	1.23
`JobReadyPods`	`true`	베타	1.24
`JobTrackingWithFinalizers`	`false`	알파	1.22	1.22
`JobTrackingWithFinalizers`	`false`	베타	1.23	1.24
`JobTrackingWithFinalizers`	`true`	베타	1.25
`KMSv2`	`false`	알파	1.25
`KubeletInUserNamespace`	`false`	알파	1.22
`KubeletPodResources`	`false`	알파	1.13	1.14
`KubeletPodResources`	`true`	베타	1.15
`KubeletPodResourcesGetAllocatable`	`false`	알파	1.21	1.22
`KubeletPodResourcesGetAllocatable`	`true`	베타	1.23
`KubeletTracing`	`false`	알파	1.25
`LegacyServiceAccountTokenTracking`	`false`	알파	1.26
`LocalStorageCapacityIsolationFSQuotaMonitoring`	`false`	알파	1.15	1.24
`LocalStorageCapacityIsolationFSQuotaMonitoring`	`true`	베타	1.25
`LogarithmicScaleDown`	`false`	알파	1.21	1.21
`LogarithmicScaleDown`	`true`	베타	1.22
`MatchLabelKeysInPodTopologySpread`	`false`	알파	1.25
`MaxUnavailableStatefulSet`	`false`	알파	1.24
`MemoryManager`	`false`	알파	1.21	1.21
`MemoryManager`	`true`	베타	1.22
`MemoryQoS`	`false`	알파	1.22
`MinDomainsInPodTopologySpread`	`false`	알파	1.24	1.24
`MinDomainsInPodTopologySpread`	`false`	베타	1.25
`MixedProtocolLBService`	`false`	알파	1.20	1.23
`MixedProtocolLBService`	`true`	베타	1.24
`MultiCIDRRangeAllocator`	`false`	알파	1.25
`NetworkPolicyStatus`	`false`	알파	1.24
`NodeInclusionPolicyInPodTopologySpread`	`false`	알파	1.25
`NodeOutOfServiceVolumeDetach`	`false`	알파	1.24	1.25
`NodeOutOfServiceVolumeDetach`	`true`	베타	1.26
`NodeSwap`	`false`	알파	1.22
`OpenAPIEnums`	`false`	알파	1.23	1.23
`OpenAPIEnums`	`true`	베타	1.24
`OpenAPIV3`	`false`	알파	1.23	1.23
`OpenAPIV3`	`true`	베타	1.24
`PDBUnhealthyPodEvictionPolicy`	`false`	알파	1.26
`PodAndContainerStatsFromCRI`	`false`	알파	1.23
`PodDeletionCost`	`false`	알파	1.21	1.21
`PodDeletionCost`	`true`	베타	1.22
`PodDisruptionConditions`	`false`	알파	1.25	1.25
`PodDisruptionConditions`	`true`	베타	1.26
`PodHasNetworkCondition`	`false`	알파	1.25
`PodSchedulingReadiness`	`false`	알파	1.26
`ProbeTerminationGracePeriod`	`false`	알파	1.21	1.21
`ProbeTerminationGracePeriod`	`false`	베타	1.22	1.24
`ProbeTerminationGracePeriod`	`true`	베타	1.25
`ProcMountType`	`false`	알파	1.12
`ProxyTerminatingEndpoints`	`false`	알파	1.22	1.25
`ProxyTerminatingEndpoints`	`true`	베타	1.26
`QOSReserved`	`false`	알파	1.11
`ReadWriteOncePod`	`false`	알파	1.22
`RecoverVolumeExpansionFailure`	`false`	알파	1.23
`RemainingItemCount`	`false`	알파	1.15	1.15
`RemainingItemCount`	`true`	베타	1.16
`RetroactiveDefaultStorageClass`	`false`	알파	1.25	1.25
`RetroactiveDefaultStorageClass`	`true`	베타	1.26
`RotateKubeletServerCertificate`	`false`	알파	1.7	1.11
`RotateKubeletServerCertificate`	`true`	베타	1.12
`SELinuxMountReadWriteOncePod`	`false`	알파	1.25
`SeccompDefault`	`false`	알파	1.22	1.24
`SeccompDefault`	`true`	베타	1.25
`ServerSideFieldValidation`	`false`	알파	1.23	1.24
`ServerSideFieldValidation`	`true`	베타	1.25
`SizeMemoryBackedVolumes`	`false`	알파	1.20	1.21
`SizeMemoryBackedVolumes`	`true`	베타	1.22
`StatefulSetAutoDeletePVC`	`false`	알파	1.22
`StatefulSetStartOrdinal`	`false`	알파	1.26
`StorageVersionAPI`	`false`	알파	1.20
`StorageVersionHash`	`false`	알파	1.14	1.14
`StorageVersionHash`	`true`	베타	1.15
`TopologyAwareHints`	`false`	알파	1.21	1.22
`TopologyAwareHints`	`false`	베타	1.23	1.23
`TopologyAwareHints`	`true`	베타	1.24
`TopologyManager`	`false`	알파	1.16	1.17
`TopologyManager`	`true`	베타	1.18
`TopologyManagerPolicyAlphaOptions`	`false`	알파	1.26
`TopologyManagerPolicyBetaOptions`	`false`	베타	1.26
`TopologyManagerPolicyOptions`	`false`	알파	1.26
`UserNamespacesStatelessPodsSupport`	`false`	알파	1.25
`ValidatingAdmissionPolicy`	`false`	알파	1.26
`VolumeCapacityPriority`	`false`	알파	1.21	-
`WinDSR`	`false`	알파	1.14
`WinOverlay`	`false`	알파	1.14	1.19
`WinOverlay`	`true`	베타	1.20
`WindowsHostNetwork`	`false`	알파	1.26

승급 또는 사용 중단된 기능을 위한 기능 게이트

승급 또는 사용 중단 기능을 위한 기능 게이트
기능	디폴트	단계	도입	종료
`AdvancedAuditing`	`false`	알파	1.7	1.7
`AdvancedAuditing`	`true`	베타	1.8	1.11
`AdvancedAuditing`	`true`	GA	1.12	-
`CPUManager`	`false`	알파	1.8	1.9
`CPUManager`	`true`	베타	1.10	1.25
`CPUManager`	`true`	GA	1.26	-
`CSIInlineVolume`	`false`	알파	1.15	1.15
`CSIInlineVolume`	`true`	베타	1.16	1.24
`CSIInlineVolume`	`true`	GA	1.25	-
`CSIMigration`	`false`	알파	1.14	1.16
`CSIMigration`	`true`	베타	1.17	1.24
`CSIMigration`	`true`	GA	1.25	-
`CSIMigrationAWS`	`false`	알파	1.14	1.16
`CSIMigrationAWS`	`false`	베타	1.17	1.22
`CSIMigrationAWS`	`true`	베타	1.23	1.24
`CSIMigrationAWS`	`true`	GA	1.25	-
`CSIMigrationAzureDisk`	`false`	알파	1.15	1.18
`CSIMigrationAzureDisk`	`false`	베타	1.19	1.22
`CSIMigrationAzureDisk`	`true`	베타	1.23	1.23
`CSIMigrationAzureDisk`	`true`	GA	1.24
`CSIMigrationAzureFile`	`false`	알파	1.15	1.20
`CSIMigrationAzureFile`	`false`	베타	1.21	1.23
`CSIMigrationAzureFile`	`true`	베타	1.24	1.25
`CSIMigrationAzureFile`	`true`	GA	1.26
`CSIMigrationGCE`	`false`	알파	1.14	1.16
`CSIMigrationGCE`	`false`	베타	1.17	1.22
`CSIMigrationGCE`	`true`	베타	1.23	1.24
`CSIMigrationGCE`	`true`	GA	1.25	-
`CSIMigrationvSphere`	`false`	알파	1.18	1.18
`CSIMigrationvSphere`	`false`	베타	1.19	1.24
`CSIMigrationvSphere`	`true`	베타	1.25	1.25
`CSIMigrationvSphere`	`true`	GA	1.26	-
`CSIMigrationOpenStack`	`false`	알파	1.14	1.17
`CSIMigrationOpenStack`	`true`	베타	1.18	1.23
`CSIMigrationOpenStack`	`true`	GA	1.24
`CSIStorageCapacity`	`false`	알파	1.19	1.20
`CSIStorageCapacity`	`true`	베타	1.21	1.23
`CSIStorageCapacity`	`true`	GA	1.24	-
`ControllerManagerLeaderMigration`	`false`	알파	1.21	1.21
`ControllerManagerLeaderMigration`	`true`	베타	1.22	1.23
`ControllerManagerLeaderMigration`	`true`	GA	1.24	-
`CronJobTimeZone`	`false`	알파	1.24	1.24
`CronJobTimeZone`	`true`	베타	1.25
`DaemonSetUpdateSurge`	`false`	알파	1.21	1.21
`DaemonSetUpdateSurge`	`true`	베타	1.22	1.24
`DaemonSetUpdateSurge`	`true`	GA	1.25	-
`DefaultPodTopologySpread`	`false`	알파	1.19	1.19
`DefaultPodTopologySpread`	`true`	베타	1.20	1.23
`DefaultPodTopologySpread`	`true`	GA	1.24	-
`DelegateFSGroupToCSIDriver`	`false`	알파	1.22	1.22
`DelegateFSGroupToCSIDriver`	`true`	베타	1.23	1.25
`DelegateFSGroupToCSIDriver`	`true`	GA	1.26	-
`DisableAcceleratorUsageMetrics`	`false`	알파	1.19	1.19
`DisableAcceleratorUsageMetrics`	`true`	베타	1.20	1.24
`DisableAcceleratorUsageMetrics`	`true`	GA	1.25	-
`DevicePlugins`	`false`	알파	1.8	1.9
`DevicePlugins`	`true`	베타	1.10	1.25
`DevicePlugins`	`true`	GA	1.26	-
`DryRun`	`false`	알파	1.12	1.12
`DryRun`	`true`	베타	1.13	1.18
`DryRun`	`true`	GA	1.19	-
`DynamicKubeletConfig`	`false`	알파	1.4	1.10
`DynamicKubeletConfig`	`true`	베타	1.11	1.21
`DynamicKubeletConfig`	`false`	Deprecated	1.22	-
`EfficientWatchResumption`	`false`	알파	1.20	1.20
`EfficientWatchResumption`	`true`	베타	1.21	1.23
`EfficientWatchResumption`	`true`	GA	1.24	-
`EphemeralContainers`	`false`	알파	1.16	1.22
`EphemeralContainers`	`true`	베타	1.23	1.24
`EphemeralContainers`	`true`	GA	1.25	-
`EventedPLEG`	`false`	알파	1.26	-
`ExecProbeTimeout`	`true`	GA	1.20	-
`ExpandCSIVolumes`	`false`	알파	1.14	1.15
`ExpandCSIVolumes`	`true`	베타	1.16	1.23
`ExpandCSIVolumes`	`true`	GA	1.24	-
`ExpandInUsePersistentVolumes`	`false`	알파	1.11	1.14
`ExpandInUsePersistentVolumes`	`true`	베타	1.15	1.23
`ExpandInUsePersistentVolumes`	`true`	GA	1.24	-
`ExpandPersistentVolumes`	`false`	알파	1.8	1.10
`ExpandPersistentVolumes`	`true`	베타	1.11	1.23
`ExpandPersistentVolumes`	`true`	GA	1.24	-
`IdentifyPodOS`	`false`	알파	1.23	1.23
`IdentifyPodOS`	`true`	베타	1.24	1.24
`IdentifyPodOS`	`true`	GA	1.25	-
`IndexedJob`	`false`	알파	1.21	1.21
`IndexedJob`	`true`	베타	1.22	1.23
`IndexedJob`	`true`	GA	1.24	-
`JobTrackingWithFinalizers`	`false`	알파	1.22	1.22
`JobTrackingWithFinalizers`	`false`	베타	1.23	1.24
`JobTrackingWithFinalizers`	`true`	베타	1.25	1.25
`JobTrackingWithFinalizers`	`true`	GA	1.26	-
`KubeletCredentialProviders`	`false`	알파	1.20	1.23
`KubeletCredentialProviders`	`true`	베타	1.24	1.25
`KubeletCredentialProviders`	`true`	GA	1.26	-
`LegacyServiceAccountTokenNoAutoGeneration`	`true`	베타	1.24	1.25
`LegacyServiceAccountTokenNoAutoGeneration`	`true`	GA	1.26	-
`LocalStorageCapacityIsolation`	`false`	알파	1.7	1.9
`LocalStorageCapacityIsolation`	`true`	베타	1.10	1.24
`LocalStorageCapacityIsolation`	`true`	GA	1.25	-
`NetworkPolicyEndPort`	`false`	알파	1.21	1.21
`NetworkPolicyEndPort`	`true`	베타	1.22	1.24
`NetworkPolicyEndPort`	`true`	GA	1.25	-
`NonPreemptingPriority`	`false`	알파	1.15	1.18
`NonPreemptingPriority`	`true`	베타	1.19	1.23
`NonPreemptingPriority`	`true`	GA	1.24	-
`PodAffinityNamespaceSelector`	`false`	알파	1.21	1.21
`PodAffinityNamespaceSelector`	`true`	베타	1.22	1.23
`PodAffinityNamespaceSelector`	`true`	GA	1.24	-
`PodSecurity`	`false`	알파	1.22	1.22
`PodSecurity`	`true`	베타	1.23	1.24
`PodSecurity`	`true`	GA	1.25
`PreferNominatedNode`	`false`	알파	1.21	1.21
`PreferNominatedNode`	`true`	베타	1.22	1.23
`PreferNominatedNode`	`true`	GA	1.24	-
`RemoveSelfLink`	`false`	알파	1.16	1.19
`RemoveSelfLink`	`true`	베타	1.20	1.23
`RemoveSelfLink`	`true`	GA	1.24	-
`ServerSideApply`	`false`	알파	1.14	1.15
`ServerSideApply`	`true`	베타	1.16	1.21
`ServerSideApply`	`true`	GA	1.22	-
`ServiceInternalTrafficPolicy`	`false`	알파	1.21	1.21
`ServiceInternalTrafficPolicy`	`true`	베타	1.22	1.25
`ServiceInternalTrafficPolicy`	`true`	GA	1.26	-
`ServiceIPStaticSubrange`	`false`	알파	1.24	1.24
`ServiceIPStaticSubrange`	`true`	베타	1.25	1.25
`ServiceIPStaticSubrange`	`true`	GA	1.26	-
`ServiceLBNodePortControl`	`false`	알파	1.20	1.21
`ServiceLBNodePortControl`	`true`	베타	1.22	1.23
`ServiceLBNodePortControl`	`true`	GA	1.24	-
`ServiceLoadBalancerClass`	`false`	알파	1.21	1.21
`ServiceLoadBalancerClass`	`true`	베타	1.22	1.23
`ServiceLoadBalancerClass`	`true`	GA	1.24	-
`StatefulSetMinReadySeconds`	`false`	알파	1.22	1.22
`StatefulSetMinReadySeconds`	`true`	베타	1.23	1.24
`StatefulSetMinReadySeconds`	`true`	GA	1.25	-
`SuspendJob`	`false`	알파	1.21	1.21
`SuspendJob`	`true`	베타	1.22	1.23
`SuspendJob`	`true`	GA	1.24	-
`WatchBookmark`	`false`	알파	1.15	1.15
`WatchBookmark`	`true`	베타	1.16	1.16
`WatchBookmark`	`true`	GA	1.17	-
`WindowsHostProcessContainers`	`false`	알파	1.22	1.22
`WindowsHostProcessContainers`	`true`	베타	1.23	1.25
`WindowsHostProcessContainers`	`true`	GA	1.26	-

기능 사용

기능 단계

기능은 알파, 베타 또는 GA 단계일 수 있다. 알파 기능은 다음을 의미한다.

기본적으로 비활성화되어 있다.
버그가 있을 수 있다. 이 기능을 사용하면 버그에 노출될 수 있다.
기능에 대한 지원은 사전 통지없이 언제든지 중단될 수 있다.
API는 이후 소프트웨어 릴리스에서 예고없이 호환되지 않는 방식으로 변경될 수 있다.
버그의 위험이 증가하고 장기 지원이 부족하여, 단기 테스트 클러스터에서만 사용하는 것이 좋다.

베타 기능은 다음을 의미한다.

기본적으로 활성화되어 있다.
이 기능은 잘 테스트되었다. 이 기능을 활성화하면 안전한 것으로 간주된다.
세부 내용은 변경될 수 있지만, 전체 기능에 대한 지원은 중단되지 않는다.
오브젝트의 스키마 및/또는 시맨틱은 후속 베타 또는 안정 릴리스에서 호환되지 않는 방식으로 변경될 수 있다. 이러한 상황이 발생하면, 다음 버전으로 마이그레이션하기 위한 지침을 제공한다. API 오브젝트를 삭제, 편집 및 재작성해야 할 수도 있다. 편집 과정에서 약간의 생각이 필요할 수 있다. 해당 기능에 의존하는 애플리케이션의 경우 다운타임이 필요할 수 있다.
후속 릴리스에서 호환되지 않는 변경이 발생할 수 있으므로 업무상 중요하지 않은(non-business-critical) 용도로만 권장한다. 독립적으로 업그레이드할 수 있는 여러 클러스터가 있는 경우, 이 제한을 완화할 수 있다.

참고: 베타 기능을 사용해 보고 의견을 보내주길 바란다! 베타 기간이 종료된 후에는, 더 많은 변경을 하는 것이 실용적이지 않을 수 있다.

GA(General Availability) 기능은 안정 기능이라고도 한다. 이 의미는 다음과 같다.

이 기능은 항상 활성화되어 있다. 비활성화할 수 없다.
해당 기능 게이트는 더 이상 필요하지 않다.
여러 후속 버전의 릴리스된 소프트웨어에 안정적인 기능의 버전이 포함된다.