해당 문서의 쿠버네티스 버전: v1.19

Kubernetes v1.19 문서는 더 이상 적극적으로 관리되지 않음. 현재 보고있는 문서는 정적 스냅샷임. 최신 문서를 위해서는, 다음을 참고. 최신 버전.

기능 게이트

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

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

개요

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

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

--feature-gates="...,DynamicKubeletConfig=true"

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

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

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

알파 또는 베타 단계에 있는 기능을 위한 기능 게이트
기능	디폴트	단계	도입	종료
`AnyVolumeDataSource`	`false`	알파	1.18
`APIListChunking`	`false`	알파	1.8	1.8
`APIListChunking`	`true`	베타	1.9
`APIPriorityAndFairness`	`false`	알파	1.17
`APIResponseCompression`	`false`	알파	1.7
`AppArmor`	`true`	베타	1.4
`BalanceAttachedNodeVolumes`	`false`	알파	1.11
`BoundServiceAccountTokenVolume`	`false`	알파	1.13
`CPUManager`	`false`	알파	1.8	1.9
`CPUManager`	`true`	베타	1.10
`CRIContainerLogRotation`	`false`	알파	1.10	1.10
`CRIContainerLogRotation`	`true`	베타	1.11
`CSIInlineVolume`	`false`	알파	1.15	1.15
`CSIInlineVolume`	`true`	베타	1.16	-
`CSIMigration`	`false`	알파	1.14	1.16
`CSIMigration`	`true`	베타	1.17
`CSIMigrationAWS`	`false`	알파	1.14
`CSIMigrationAWS`	`false`	베타	1.17
`CSIMigrationAWSComplete`	`false`	알파	1.17
`CSIMigrationAzureDisk`	`false`	알파	1.15	1.18
`CSIMigrationAzureDisk`	`false`	베타	1.19
`CSIMigrationAzureDiskComplete`	`false`	알파	1.17
`CSIMigrationAzureFile`	`false`	알파	1.15
`CSIMigrationAzureFileComplete`	`false`	알파	1.17
`CSIMigrationGCE`	`false`	알파	1.14	1.16
`CSIMigrationGCE`	`false`	베타	1.17
`CSIMigrationGCEComplete`	`false`	알파	1.17
`CSIMigrationOpenStack`	`false`	알파	1.14
`CSIMigrationOpenStackComplete`	`false`	알파	1.17
`CSIMigrationvSphere`	`false`	베타	1.19
`CSIMigrationvSphereComplete`	`false`	베타	1.19
`CSIStorageCapacity`	`false`	알파	1.19
`CSIVolumeFSGroupPolicy`	`false`	알파	1.19
`ConfigurableFSGroupPolicy`	`false`	알파	1.18
`CustomCPUCFSQuotaPeriod`	`false`	알파	1.12
`DefaultPodTopologySpread`	`false`	알파	1.19
`DevicePlugins`	`false`	알파	1.8	1.9
`DevicePlugins`	`true`	베타	1.10
`DisableAcceleratorUsageMetrics`	`false`	알파	1.19	1.20
`DryRun`	`false`	알파	1.12	1.12
`DryRun`	`true`	베타	1.13
`DynamicKubeletConfig`	`false`	알파	1.4	1.10
`DynamicKubeletConfig`	`true`	베타	1.11
`EndpointSlice`	`false`	알파	1.16	1.16
`EndpointSlice`	`false`	베타	1.17
`EndpointSlice`	`true`	베타	1.18
`EndpointSliceProxying`	`false`	알파	1.18
`EphemeralContainers`	`false`	알파	1.16
`ExpandCSIVolumes`	`false`	알파	1.14	1.15
`ExpandCSIVolumes`	`true`	베타	1.16
`ExpandInUsePersistentVolumes`	`false`	알파	1.11	1.14
`ExpandInUsePersistentVolumes`	`true`	베타	1.15
`ExpandPersistentVolumes`	`false`	알파	1.8	1.10
`ExpandPersistentVolumes`	`true`	베타	1.11
`ExperimentalHostUserNamespaceDefaulting`	`false`	베타	1.5
`GenericEphemeralVolume`	`false`	알파	1.19
`HPAScaleToZero`	`false`	알파	1.16
`HugePageStorageMediumSize`	`false`	알파	1.18	1.18
`HugePageStorageMediumSize`	`true`	베타	1.19
`HyperVContainer`	`false`	알파	1.10
`ImmutableEphemeralVolumes`	`false`	알파	1.18	1.18
`ImmutableEphemeralVolumes`	`true`	베타	1.19
`IPv6DualStack`	`false`	알파	1.16
`KubeletPodResources`	`false`	알파	1.13	1.14
`KubeletPodResources`	`true`	베타	1.15
`LegacyNodeRoleBehavior`	`true`	알파	1.16
`LocalStorageCapacityIsolation`	`false`	알파	1.7	1.9
`LocalStorageCapacityIsolation`	`true`	베타	1.10
`LocalStorageCapacityIsolationFSQuotaMonitoring`	`false`	알파	1.15
`MountContainers`	`false`	알파	1.9
`NodeDisruptionExclusion`	`false`	알파	1.16	1.18
`NodeDisruptionExclusion`	`true`	베타	1.19
`NonPreemptingPriority`	`false`	알파	1.15	1.18
`NonPreemptingPriority`	`true`	베타	1.19
`PodDisruptionBudget`	`false`	알파	1.3	1.4
`PodDisruptionBudget`	`true`	베타	1.5
`PodOverhead`	`false`	알파	1.16	-
`ProcMountType`	`false`	알파	1.12
`QOSReserved`	`false`	알파	1.11
`RemainingItemCount`	`false`	알파	1.15
`RotateKubeletServerCertificate`	`false`	알파	1.7	1.11
`RotateKubeletServerCertificate`	`true`	베타	1.12
`RunAsGroup`	`true`	베타	1.14
`RuntimeClass`	`false`	알파	1.12	1.13
`RuntimeClass`	`true`	베타	1.14
`SCTPSupport`	`false`	알파	1.12	1.18
`SCTPSupport`	`true`	베타	1.19
`ServerSideApply`	`false`	알파	1.14	1.15
`ServerSideApply`	`true`	베타	1.16
`ServiceAccountIssuerDiscovery`	`false`	Alpha	1.18
`ServiceAppProtocol`	`false`	알파	1.18	1.18
`ServiceAppProtocol`	`true`	베타	1.19
`ServiceNodeExclusion`	`false`	알파	1.8	1.18
`ServiceNodeExclusion`	`true`	베타	1.19
`ServiceTopology`	`false`	알파	1.17
`SetHostnameAsFQDN`	`false`	알파	1.19
`StartupProbe`	`false`	알파	1.16	1.17
`StartupProbe`	`true`	베타	1.18
`StorageVersionHash`	`false`	알파	1.14	1.14
`StorageVersionHash`	`true`	베타	1.15
`SupportNodePidsLimit`	`false`	알파	1.14	1.14
`SupportNodePidsLimit`	`true`	베타	1.15
`SupportPodPidsLimit`	`false`	알파	1.10	1.13
`SupportPodPidsLimit`	`true`	베타	1.14
`Sysctls`	`true`	베타	1.11
`TokenRequest`	`false`	알파	1.10	1.11
`TokenRequest`	`true`	베타	1.12
`TokenRequestProjection`	`false`	알파	1.11	1.11
`TokenRequestProjection`	`true`	베타	1.12
`TTLAfterFinished`	`false`	알파	1.12
`TopologyManager`	`false`	알파	1.16
`ValidateProxyRedirects`	`false`	알파	1.12	1.13
`ValidateProxyRedirects`	`true`	베타	1.14
`VolumeSnapshotDataSource`	`false`	알파	1.12	1.16
`VolumeSnapshotDataSource`	`true`	베타	1.17	-
`WindowsEndpointSliceProxying`	`false`	알파	1.19
`WindowsGMSA`	`false`	알파	1.14
`WindowsGMSA`	`true`	베타	1.16
`WinDSR`	`false`	알파	1.14
`WinOverlay`	`false`	알파	1.14

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

GA 또는 사용 중단 기능을 위한 기능 게이트
기능	디폴트	단계	도입	종료
`Accelerators`	`false`	알파	1.6	1.10
`Accelerators`	-	사용 중단	1.11	-
`AdvancedAuditing`	`false`	알파	1.7	1.7
`AdvancedAuditing`	`true`	베타	1.8	1.11
`AdvancedAuditing`	`true`	GA	1.12	-
`AffinityInAnnotations`	`false`	알파	1.6	1.7
`AffinityInAnnotations`	-	사용 중단	1.8	-
`AllowExtTrafficLocalEndpoints`	`false`	베타	1.4	1.6
`AllowExtTrafficLocalEndpoints`	`true`	GA	1.7	-
`BlockVolume`	`false`	알파	1.9	1.12
`BlockVolume`	`true`	베타	1.13	1.17
`BlockVolume`	`true`	GA	1.18	-
`CSIBlockVolume`	`false`	알파	1.11	1.13
`CSIBlockVolume`	`true`	베타	1.14	1.17
`CSIBlockVolume`	`true`	GA	1.18	-
`CSIDriverRegistry`	`false`	알파	1.12	1.13
`CSIDriverRegistry`	`true`	베타	1.14	1.17
`CSIDriverRegistry`	`true`	GA	1.18
`CSINodeInfo`	`false`	알파	1.12	1.13
`CSINodeInfo`	`true`	베타	1.14	1.16
`CSINodeInfo`	`true`	GA	1.17
`AttachVolumeLimit`	`false`	알파	1.11	1.11
`AttachVolumeLimit`	`true`	베타	1.12	1.16
`AttachVolumeLimit`	`true`	GA	1.17	-
`CSIPersistentVolume`	`false`	알파	1.9	1.9
`CSIPersistentVolume`	`true`	베타	1.10	1.12
`CSIPersistentVolume`	`true`	GA	1.13	-
`CustomPodDNS`	`false`	알파	1.9	1.9
`CustomPodDNS`	`true`	베타	1.10	1.13
`CustomPodDNS`	`true`	GA	1.14	-
`CustomResourceDefaulting`	`false`	알파	1.15	1.15
`CustomResourceDefaulting`	`true`	베타	1.16	1.16
`CustomResourceDefaulting`	`true`	GA	1.17	-
`CustomResourcePublishOpenAPI`	`false`	알파	1.14	1.14
`CustomResourcePublishOpenAPI`	`true`	베타	1.15	1.15
`CustomResourcePublishOpenAPI`	`true`	GA	1.16	-
`CustomResourceSubresources`	`false`	알파	1.10	1.10
`CustomResourceSubresources`	`true`	베타	1.11	1.15
`CustomResourceSubresources`	`true`	GA	1.16	-
`CustomResourceValidation`	`false`	알파	1.8	1.8
`CustomResourceValidation`	`true`	베타	1.9	1.15
`CustomResourceValidation`	`true`	GA	1.16	-
`CustomResourceWebhookConversion`	`false`	알파	1.13	1.14
`CustomResourceWebhookConversion`	`true`	베타	1.15	1.15
`CustomResourceWebhookConversion`	`true`	GA	1.16	-
`DynamicAuditing`	`false`	알파	1.13	1.18
`DynamicAuditing`	-	사용 중단	1.19	-
`DynamicProvisioningScheduling`	`false`	알파	1.11	1.11
`DynamicProvisioningScheduling`	-	사용 중단	1.12	-
`DynamicVolumeProvisioning`	`true`	알파	1.3	1.7
`DynamicVolumeProvisioning`	`true`	GA	1.8	-
`EnableEquivalenceClassCache`	`false`	알파	1.8	1.14
`EnableEquivalenceClassCache`	-	사용 중단	1.15	-
`ExperimentalCriticalPodAnnotation`	`false`	알파	1.5	1.12
`ExperimentalCriticalPodAnnotation`	`false`	사용 중단	1.13	-
`EvenPodsSpread`	`false`	알파	1.16	1.17
`EvenPodsSpread`	`true`	베타	1.18	1.18
`EvenPodsSpread`	`true`	GA	1.19	-
`GCERegionalPersistentDisk`	`true`	베타	1.10	1.12
`GCERegionalPersistentDisk`	`true`	GA	1.13	-
`HugePages`	`false`	알파	1.8	1.9
`HugePages`	`true`	베타	1.10	1.13
`HugePages`	`true`	GA	1.14	-
`Initializers`	`false`	알파	1.7	1.13
`Initializers`	-	사용 중단	1.14	-
`KubeletConfigFile`	`false`	알파	1.8	1.9
`KubeletConfigFile`	-	사용 중단	1.10	-
`KubeletPluginsWatcher`	`false`	알파	1.11	1.11
`KubeletPluginsWatcher`	`true`	베타	1.12	1.12
`KubeletPluginsWatcher`	`true`	GA	1.13	-
`MountPropagation`	`false`	알파	1.8	1.9
`MountPropagation`	`true`	베타	1.10	1.11
`MountPropagation`	`true`	GA	1.12	-
`NodeLease`	`false`	알파	1.12	1.13
`NodeLease`	`true`	베타	1.14	1.16
`NodeLease`	`true`	GA	1.17	-
`PersistentLocalVolumes`	`false`	알파	1.7	1.9
`PersistentLocalVolumes`	`true`	베타	1.10	1.13
`PersistentLocalVolumes`	`true`	GA	1.14	-
`PodPriority`	`false`	알파	1.8	1.10
`PodPriority`	`true`	베타	1.11	1.13
`PodPriority`	`true`	GA	1.14	-
`PodReadinessGates`	`false`	알파	1.11	1.11
`PodReadinessGates`	`true`	베타	1.12	1.13
`PodReadinessGates`	`true`	GA	1.14	-
`PodShareProcessNamespace`	`false`	알파	1.10	1.11
`PodShareProcessNamespace`	`true`	베타	1.12	1.16
`PodShareProcessNamespace`	`true`	GA	1.17	-
`PVCProtection`	`false`	알파	1.9	1.9
`PVCProtection`	-	사용 중단	1.10	-
`RequestManagement`	`false`	알파	1.15	1.16
`ResourceLimitsPriorityFunction`	`false`	알파	1.9	1.18
`ResourceLimitsPriorityFunction`	-	사용 중단	1.19	-
`ResourceQuotaScopeSelectors`	`false`	알파	1.11	1.11
`ResourceQuotaScopeSelectors`	`true`	베타	1.12	1.16
`ResourceQuotaScopeSelectors`	`true`	GA	1.17	-
`RotateKubeletClientCertificate`	`true`	베타	1.8	1.18
`RotateKubeletClientCertificate`	`true`	GA	1.19	-
`ScheduleDaemonSetPods`	`false`	알파	1.11	1.11
`ScheduleDaemonSetPods`	`true`	베타	1.12	1.16
`ScheduleDaemonSetPods`	`true`	GA	1.17	-
`ServiceLoadBalancerFinalizer`	`false`	알파	1.15	1.15
`ServiceLoadBalancerFinalizer`	`true`	베타	1.16	1.16
`ServiceLoadBalancerFinalizer`	`true`	GA	1.17	-
`StorageObjectInUseProtection`	`true`	베타	1.10	1.10
`StorageObjectInUseProtection`	`true`	GA	1.11	-
`StreamingProxyRedirects`	`false`	베타	1.5	1.5
`StreamingProxyRedirects`	`true`	베타	1.6	1.18
`StreamingProxyRedirects`	-	사용 중단	1.19	-
`SupportIPVSProxyMode`	`false`	알파	1.8	1.8
`SupportIPVSProxyMode`	`false`	베타	1.9	1.9
`SupportIPVSProxyMode`	`true`	베타	1.10	1.10
`SupportIPVSProxyMode`	`true`	GA	1.11	-
`TaintBasedEvictions`	`false`	알파	1.6	1.12
`TaintBasedEvictions`	`true`	베타	1.13	1.17
`TaintBasedEvictions`	`true`	GA	1.18	-
`TaintNodesByCondition`	`false`	알파	1.8	1.11
`TaintNodesByCondition`	`true`	베타	1.12	1.16
`TaintNodesByCondition`	`true`	GA	1.17	-
`VolumePVCDataSource`	`false`	알파	1.15	1.15
`VolumePVCDataSource`	`true`	베타	1.16	1.17
`VolumePVCDataSource`	`true`	GA	1.18	-
`VolumeScheduling`	`false`	알파	1.9	1.9
`VolumeScheduling`	`true`	베타	1.10	1.12
`VolumeScheduling`	`true`	GA	1.13	-
`VolumeSubpath`	`true`	GA	1.13	-
`VolumeSubpathEnvExpansion`	`false`	알파	1.14	1.14
`VolumeSubpathEnvExpansion`	`true`	베타	1.15	1.16
`VolumeSubpathEnvExpansion`	`true`	GA	1.17	-
`WatchBookmark`	`false`	알파	1.15	1.15
`WatchBookmark`	`true`	베타	1.16	1.16
`WatchBookmark`	`true`	GA	1.17	-
`WindowsGMSA`	`false`	알파	1.14	1.15
`WindowsGMSA`	`true`	베타	1.16	1.17
`WindowsGMSA`	`true`	GA	1.18	-
`WindowsRunAsUserName`	`false`	알파	1.16	1.16
`WindowsRunAsUserName`	`true`	베타	1.17	1.17
`WindowsRunAsUserName`	`true`	GA	1.18	-

기능 사용

기능 단계

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

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

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

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

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

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

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