From ec004f61072afe21017af69e7553e736096508ae Mon Sep 17 00:00:00 2001 From: windsonsea Date: Fri, 13 Dec 2024 09:58:07 +0800 Subject: [PATCH] [zh] Sync command-line-tools-reference/kube-apiserver.md --- .../kube-apiserver.md | 193 +++++++++++------- 1 file changed, 117 insertions(+), 76 deletions(-) diff --git a/content/zh-cn/docs/reference/command-line-tools-reference/kube-apiserver.md b/content/zh-cn/docs/reference/command-line-tools-reference/kube-apiserver.md index 6dcf105774..8b44eff403 100644 --- a/content/zh-cn/docs/reference/command-line-tools-reference/kube-apiserver.md +++ b/content/zh-cn/docs/reference/command-line-tools-reference/kube-apiserver.md @@ -571,13 +571,13 @@ API group and version used for serializing audit events written to webhook.

-用于配置 JWT 令牌身份认证模块或匿名身份认证模块的身份认证配置文件。注意:此特性自 v1.29 起处于 Alpha 阶段。 -需要设置 --feature-gate=StructuredAuthenticationConfiguration=true 才能启用此特性。 -此特性与 oidc-* 标志互斥。要配置匿名身份认证模块, -你需要启用 --feature-gate=AnonymousAuthConfigurableEndpoints。 -如果在身份认证配置文件中配置了匿名身份认证模块,就不能使用 --anonymous-auth 标志。 +用于配置 JWT 令牌身份认证模块或匿名身份认证模块的身份认证配置文件。 +你需要启用 StructuredAuthenticationConfiguration 特性门控。 +还需要启用 AnonymousAuthConfigurableEndpoints 特性门控以在配置文件中配置匿名身份认证模块。 +如果在配置文件中配置了 JWT 令牌认证模块,此标志与 oidc-* 标志互斥。 +如果在配置文件中配置了匿名身份认证模块,此标志与 --anonymous-auth 标志互斥。

@@ -626,11 +626,11 @@ The API version of the authentication.k8s.io TokenReview to send to and expect f

-用于配置鉴权链的鉴权配置文件。注意:此特性自 v1.29 起处于 Alpha 阶段。 -需要将 --feature-gate=StructuredAuthorizationConfiguration=true 特性标志设置为 true 才能启用此特性。 -此特性与其他 --authorization-mode和--authorization-webhook-* 标志互斥。 +用于配置鉴权链的鉴权配置文件。 +需要启用 StructuredAuthorizationConfiguration 特性门控。 +此标志与其他 --authorization-mode--authorization-webhook-* 标志互斥。

@@ -854,12 +854,12 @@ plugins list (NamespaceLifecycle, LimitRanger, ServiceAccount, TaintNodesByCondi PodSecurity, Priority, DefaultTolerationSeconds, DefaultStorageClass, StorageObjectInUseProtection, PersistentVolumeClaimResize, RuntimeClass, CertificateApproval, CertificateSigning, ClusterTrustBundleAttest, CertificateSubjectRestriction, DefaultIngressClass, -MutatingAdmissionWebhook, ValidatingAdmissionPolicy, ValidatingAdmissionWebhook, ResourceQuota). +MutatingAdmissionPolicy, MutatingAdmissionWebhook, ValidatingAdmissionPolicy, ValidatingAdmissionWebhook, ResourceQuota). Comma-delimited list of admission plugins: AlwaysAdmit, AlwaysDeny, AlwaysPullImages, CertificateApproval, CertificateSigning, CertificateSubjectRestriction, ClusterTrustBundleAttest, DefaultIngressClass, DefaultStorageClass, DefaultTolerationSeconds, DenyServiceExternalIPs, EventRateLimit, ExtendedResourceToleration, ImagePolicyWebhook, LimitPodHardAntiAffinityTopology, LimitRanger, -MutatingAdmissionWebhook, NamespaceAutoProvision, NamespaceExists, NamespaceLifecycle, +MutatingAdmissionPolicy, MutatingAdmissionWebhook, NamespaceAutoProvision, NamespaceExists, NamespaceLifecycle, NodeRestriction, OwnerReferencesPermissionEnforcement, PersistentVolumeClaimResize, PodNodeSelector, PodSecurity, PodTolerationRestriction, Priority, ResourceQuota, RuntimeClass, ServiceAccount, StorageObjectInUseProtection, TaintNodesByCondition, @@ -871,13 +871,13 @@ The order of plugins in this flag does not matter. ServiceAccount、TaintNodesByCondition、PodSecurity、Priority、DefaultTolerationSeconds、 DefaultStorageClass、StorageObjectInUseProtection、PersistentVolumeClaimResize、 RuntimeClass、CertificateApproval、CertificateSigning、ClusterTrustBundleAttest、 -CertificateSubjectRestriction、DefaultIngressClass、MutatingAdmissionWebhook、 +CertificateSubjectRestriction、DefaultIngressClass、MutatingAdmissionPolicy、MutatingAdmissionWebhook、 ValidatingAdmissionPolicy、ValidatingAdmissionWebhook、ResourceQuota)。 取值为逗号分隔的准入插件列表:AlwaysAdmit、AlwaysDeny、AlwaysPullImages、CertificateApproval、 CertificateSigning、CertificateSubjectRestriction、ClusterTrustBundleAttest、 DefaultIngressClass、DefaultStorageClass、DefaultTolerationSeconds、DenyServiceExternalIPs、 EventRateLimit、ExtendedResourceToleration、ImagePolicyWebhook、LimitPodHardAntiAffinityTopology、 -LimitRanger、MutatingAdmissionWebhook、NamespaceAutoProvision、NamespaceExists、NamespaceLifecycle、 +LimitRanger、MutatingAdmissionPolicy、MutatingAdmissionWebhook、NamespaceAutoProvision、NamespaceExists、NamespaceLifecycle、 NodeRestriction、OwnerReferencesPermissionEnforcement、PersistentVolumeClaimResize、 PodNodeSelector、PodSecurity、PodTolerationRestriction、Priority、ResourceQuota、RuntimeClass、ServiceAccount、 StorageObjectInUseProtection、TaintNodesByCondition、ValidatingAdmissionPolicy、ValidatingAdmissionWebhook。 @@ -930,12 +930,12 @@ File with apiserver egress selector configuration.

不同组件所模拟的能力(API、特性等)的版本。
如果设置了该选项,组件将模拟此版本的行为,而不是下层可执行文件版本的行为。
版本格式只能是 major.minor,例如 “--emulated-version=wardle=1.2,kube=1.31”。 -选项包括:
kube=1.31..1.31(默认值=1.31)。如果组件未被指定,默认为 “kube”。 +选项包括:
kube=1.32..1.32(默认值=1.32)。如果组件未被指定,默认为 “kube”。

@@ -947,17 +947,18 @@ The versions different components emulate their capabilities (APIs, features, .. 逗号分隔的组件列表,这些 key=value 对用来描述不同组件测试性/试验性特性的特性门控。
@@ -1398,34 +1406,39 @@ kube:APIServerTracing=true|false (BETA - 默认值=true)
kube:APIServingWithRoutine=true|false (ALPHA - 默认值=false)
kube:AllAlpha=true|false (ALPHA - 默认值=false)
kube:AllBeta=true|false (BETA - 默认值=false)
-kube:AnonymousAuthConfigurableEndpoints=true|false (ALPHA - 默认值=false)
+kube:AllowUnsafeMalformedObjectDeletion=true|false (ALPHA - 默认值=false)
+kube:AnonymousAuthConfigurableEndpoints=true|false (BETA - 默认值=true)
kube:AnyVolumeDataSource=true|false (BETA - 默认值=true)
-kube:AuthorizeNodeWithSelectors=true|false (ALPHA - 默认值=false)
-kube:AuthorizeWithSelectors=true|false (ALPHA - 默认值=false)
+kube:AuthorizeNodeWithSelectors=true|false (BETA - 默认值=true)
+kube:AuthorizeWithSelectors=true|false (BETA - 默认值=true)
+kube:BtreeWatchCache=true|false (BETA - 默认值=true)
+kube:CBORServingAndStorage=true|false (ALPHA - 默认值=false)
kube:CPUManagerPolicyAlphaOptions=true|false (ALPHA - 默认值=false)
kube:CPUManagerPolicyBetaOptions=true|false (BETA - 默认值=true)
kube:CPUManagerPolicyOptions=true|false (BETA - 默认值=true)
kube:CRDValidationRatcheting=true|false (BETA - 默认值=true)
kube:CSIMigrationPortworx=true|false (BETA - 默认值=true)
kube:CSIVolumeHealth=true|false (ALPHA - 默认值=false)
+kube:ClientsAllowCBOR=true|false (ALPHA - 默认值=false)
+kube:ClientsPreferCBOR=true|false (ALPHA - 默认值=false)
kube:CloudControllerManagerWebhook=true|false (ALPHA - 默认值=false)
kube:ClusterTrustBundle=true|false (ALPHA - 默认值=false)
kube:ClusterTrustBundleProjection=true|false (ALPHA - 默认值=false)
-kube:ComponentSLIs=true|false (BETA - 默认值=true)
+kube:ComponentFlagz=true|false (ALPHA - 默认值=false)
+kube:ComponentStatusz=true|false (ALPHA - 默认值=false)
kube:ConcurrentWatchObjectDecode=true|false (BETA - 默认值=false)
kube:ConsistentListFromCache=true|false (BETA - 默认值=true)
kube:ContainerCheckpoint=true|false (BETA - 默认值=true)
kube:ContextualLogging=true|false (BETA - 默认值=true)
kube:CoordinatedLeaderElection=true|false (ALPHA - 默认值=false)
-kube:CronJobsScheduledAnnotation=true|false (BETA - 默认值=true)
kube:CrossNamespaceVolumeDataSource=true|false (ALPHA - 默认值=false)
kube:CustomCPUCFSQuotaPeriod=true|false (ALPHA - 默认值=false)
-kube:CustomResourceFieldSelectors=true|false (BETA - 默认值=true)
-kube:DRAControlPlaneController=true|false (ALPHA - 默认值=false)
+kube:DRAAdminAccess=true|false (ALPHA - 默认值=false)
+kube:DRAResourceClaimDeviceStatus=true|false (ALPHA - 默认值=false)
kube:DisableAllocatorDualWrite=true|false (ALPHA - 默认值=false)
-kube:DisableNodeKubeProxyVersion=true|false (BETA - 默认值=true)
-kube:DynamicResourceAllocation=true|false (ALPHA - 默认值=false)
+kube:DynamicResourceAllocation=true|false (BETA - 默认值=false)
kube:EventedPLEG=true|false (ALPHA - 默认值=false)
+kube:ExternalServiceAccountTokenSigner=true|false (ALPHA - 默认值=false)
kube:GracefulNodeShutdown=true|false (BETA - 默认值=true)
kube:GracefulNodeShutdownBasedOnPodPriority=true|false (BETA - 默认值=true)
kube:HPAScaleToZero=true|false (ALPHA - 默认值=false)
@@ -1433,26 +1446,28 @@ kube:HonorPVReclaimPolicy=true|false (BETA - 默认值=true)
kube:ImageMaximumGCAge=true|false (BETA - 默认值=true)
kube:ImageVolume=true|false (ALPHA - 默认值=false)
kube:InPlacePodVerticalScaling=true|false (ALPHA - 默认值=false)
+kube:InPlacePodVerticalScalingAllocatedStatus=true|false (ALPHA - 默认值=false)
+kube:InPlacePodVerticalScalingExclusiveCPUs=true|false (ALPHA - 默认值=false)
kube:InTreePluginPortworxUnregister=true|false (ALPHA - 默认值=false)
kube:InformerResourceVersion=true|false (ALPHA - 默认值=false)
kube:JobBackoffLimitPerIndex=true|false (BETA - 默认值=true)
-kube:JobManagedBy=true|false (ALPHA - 默认值=false)
+kube:JobManagedBy=true|false (BETA - 默认值=true)
kube:JobPodReplacementPolicy=true|false (BETA - 默认值=true)
kube:JobSuccessPolicy=true|false (BETA - 默认值=true)
kube:KubeletCgroupDriverFromCRI=true|false (BETA - 默认值=true)
+kube:KubeletCrashLoopBackOffMax=true|false (ALPHA - 默认值=false)
+kube:KubeletFineGrainedAuthz=true|false (ALPHA - 默认值=false)
kube:KubeletInUserNamespace=true|false (ALPHA - 默认值=false)
kube:KubeletPodResourcesDynamicResources=true|false (ALPHA - 默认值=false)
kube:KubeletPodResourcesGet=true|false (ALPHA - 默认值=false)
kube:KubeletSeparateDiskGC=true|false (BETA - 默认值=true)
kube:KubeletTracing=true|false (BETA - 默认值=true)
-kube:LoadBalancerIPMode=true|false (BETA - 默认值=true)
kube:LocalStorageCapacityIsolationFSQuotaMonitoring=true|false (BETA - 默认值=false)
kube:LoggingAlphaOptions=true|false (ALPHA - 默认值=false)
kube:LoggingBetaOptions=true|false (BETA - 默认值=true)
kube:MatchLabelKeysInPodAffinity=true|false (BETA - 默认值=true)
kube:MatchLabelKeysInPodTopologySpread=true|false (BETA - 默认值=true)
kube:MaxUnavailableStatefulSet=true|false (ALPHA - 默认值=false)
-kube:MemoryManager=true|false (BETA - 默认值=true)
kube:MemoryQoS=true|false (ALPHA - 默认值=false)
kube:MultiCIDRServiceAllocator=true|false (BETA - 默认值=false)
kube:MutatingAdmissionPolicy=true|false (ALPHA - 默认值=false)
@@ -1463,47 +1478,45 @@ kube:NodeSwap=true|false (BETA - 默认值=true)
kube:OpenAPIEnums=true|false (BETA - 默认值=true)
kube:PodAndContainerStatsFromCRI=true|false (ALPHA - 默认值=false)
kube:PodDeletionCost=true|false (BETA - 默认值=true)
-kube:PodIndexLabel=true|false (BETA - 默认值=true)
+kube:PodLevelResources=true|false (ALPHA - 默认值=false)
kube:PodLifecycleSleepAction=true|false (BETA - 默认值=true)
+kube:PodLifecycleSleepActionAllowZero=true|false (ALPHA - 默认值=false)
+kube:PodLogsQuerySplitStreams=true|false (ALPHA - 默认值=false)
kube:PodReadyToStartContainersCondition=true|false (BETA - 默认值=true)
kube:PortForwardWebsockets=true|false (BETA - 默认值=true)
kube:ProcMountType=true|false (BETA - 默认值=false)
kube:QOSReserved=true|false (ALPHA - 默认值=false)
-kube:RecoverVolumeExpansionFailure=true|false (ALPHA - 默认值=false)
+kube:RecoverVolumeExpansionFailure=true|false (BETA - 默认值=true)
kube:RecursiveReadOnlyMounts=true|false (BETA - 默认值=true)
-kube:RelaxedEnvironmentVariableValidation=true|false (ALPHA - 默认值=false)
+kube:RelaxedDNSSearchValidation=true|false (ALPHA - 默认值=false)
+kube:RelaxedEnvironmentVariableValidation=true|false (BETA - 默认值=true)
kube:ReloadKubeletServerCertificateFile=true|false (BETA - 默认值=true)
+kube:RemoteRequestHeaderUID=true|false (ALPHA - 默认值=false)
kube:ResilientWatchCacheInitialization=true|false (BETA - 默认值=true)
kube:ResourceHealthStatus=true|false (ALPHA - 默认值=false)
-kube:RetryGenerateName=true|false (BETA - 默认值=true)
kube:RotateKubeletServerCertificate=true|false (BETA - 默认值=true)
kube:RuntimeClassInImageCriApi=true|false (ALPHA - 默认值=false)
+kube:SELinuxChangePolicy=true|false (ALPHA - 默认值=false)
kube:SELinuxMount=true|false (ALPHA - 默认值=false)
kube:SELinuxMountReadWriteOncePod=true|false (BETA - 默认值=true)
-kube:SchedulerQueueingHints=true|false (BETA - 默认值=false)
+kube:SchedulerAsyncPreemption=true|false (ALPHA - 默认值=false)
+kube:SchedulerQueueingHints=true|false (BETA - 默认值=true)
kube:SeparateCacheWatchRPC=true|false (BETA - 默认值=true)
kube:SeparateTaintEvictionController=true|false (BETA - 默认值=true)
-kube:ServiceAccountTokenJTI=true|false (BETA - 默认值=true)
+kube:ServiceAccountNodeAudienceRestriction=true|false (BETA - 默认值=true)
kube:ServiceAccountTokenNodeBinding=true|false (BETA - 默认值=true)
-kube:ServiceAccountTokenNodeBindingValidation=true|false (BETA - 默认值=true)
-kube:ServiceAccountTokenPodNodeInfo=true|false (BETA - 默认值=true)
kube:ServiceTrafficDistribution=true|false (BETA - 默认值=true)
kube:SidecarContainers=true|false (BETA - 默认值=true)
-kube:SizeMemoryBackedVolumes=true|false (BETA - 默认值=true)
-kube:StatefulSetAutoDeletePVC=true|false (BETA - 默认值=true)
kube:StorageNamespaceIndex=true|false (BETA - 默认值=true)
kube:StorageVersionAPI=true|false (ALPHA - 默认值=false)
kube:StorageVersionHash=true|false (BETA - 默认值=true)
kube:StorageVersionMigrator=true|false (ALPHA - 默认值=false)
-kube:StrictCostEnforcementForVAP=true|false (BETA - 默认值=false)
-kube:StrictCostEnforcementForWebhooks=true|false (BETA - 默认值=false)
kube:StructuredAuthenticationConfiguration=true|false (BETA - 默认值=true)
-kube:StructuredAuthorizationConfiguration=true|false (BETA - 默认值=true)
kube:SupplementalGroupsPolicy=true|false (ALPHA - 默认值=false)
+kube:SystemdWatchdog=true|false (BETA - 默认值=true)
kube:TopologyAwareHints=true|false (BETA - 默认值=true)
kube:TopologyManagerPolicyAlphaOptions=true|false (ALPHA - 默认值=false)
kube:TopologyManagerPolicyBetaOptions=true|false (BETA - 默认值=true)
-kube:TopologyManagerPolicyOptions=true|false (BETA - 默认值=true)
kube:TranslateStreamCloseWebsocketRequests=true|false (BETA - 默认值=true)
kube:UnauthenticatedHTTP2DOSMitigation=true|false (BETA - 默认值=true)
kube:UnknownVersionInteroperabilityProxy=true|false (ALPHA - 默认值=false)
@@ -1513,10 +1526,12 @@ kube:VolumeAttributesClass=true|false (BETA - 默认值=false)
kube:VolumeCapacityPriority=true|false (ALPHA - 默认值=false)
kube:WatchCacheInitializationPostStartHook=true|false (BETA - 默认值=false)
kube:WatchFromStorageWithoutResourceVersion=true|false (BETA - 默认值=false)
-kube:WatchList=true|false (ALPHA - 默认值=false)
+kube:WatchList=true|false (BETA - 默认值=true)
kube:WatchListClient=true|false (BETA - 默认值=false)
kube:WinDSR=true|false (ALPHA - 默认值=false)
kube:WinOverlay=true|false (BETA - 默认值=true)
+kube:WindowsCPUAndMemoryAffinity=true|false (ALPHA - 默认值=false)
+kube:WindowsGracefulNodeShutdown=true|false (ALPHA - 默认值=false)
kube:WindowsHostNetwork=true|false (ALPHA - 默认值=true)

@@ -2148,6 +2163,19 @@ List of request headers to inspect for groups. X-Remote-Group is suggested. + +--requestheader-uid-headers strings + + +

+ +用于查验 UID 的请求头字段列表。建议使用 X-Remote-Uid。 +要求 RemoteRequestHeaderUID 特性被启用。 +

+ + --requestheader-username-headers strings @@ -2312,11 +2340,24 @@ a token will be issued with a validity duration of this value. + +--service-account-signing-endpoint string + + +

+ +外部 JWT 签名程序正在侦听的套接字的路径。 +此标志与 --service-account-signing-key-file--service-account-key-file 互斥。 +需要启用 ExternalServiceAccountTokenSigner 特性门控。 +

+ + --service-account-signing-key-file string -