From 800661ccd669f49c24cca94800ffc45403412d0e Mon Sep 17 00:00:00 2001 From: michelle951 <1436918299@qq.com> Date: Wed, 31 Aug 2022 15:00:53 +0800 Subject: [PATCH] [zh] sync kube-apiserver.md --- .../kube-apiserver.md | 217 +++++++++--------- 1 file changed, 112 insertions(+), 105 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 26bef87ba7..f0c950a557 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 @@ -10,7 +10,7 @@ The file is auto-generated from the Go source code of the component using a gene [generator](https://github.com/kubernetes-sigs/reference-docs/). To learn how to generate the reference documentation, please read [Contributing to the reference documentation](/docs/contribute/generate-ref-docs/). -To update the reference conent, please follow the +To update the reference content, please follow the [Contributing upstream](/docs/contribute/generate-ref-docs/contribute-upstream/) guide. You can file document formatting bugs against the [reference-docs](https://github.com/kubernetes-sigs/reference-docs/) project. @@ -233,8 +233,7 @@ If set, the rotated log files will be compressed using gzip. 所保存的审计格式。 "legacy" 表示每行一个事件的文本格式。"json" 表示结构化的 JSON 格式。 @@ -818,20 +817,6 @@ that is added by default to every pod that does not already have such a tolerati - ---default-watch-cache-size int     默认值:100 - - - - -默认监听(watch)缓存大小。 -如果为零,则将为没有设置默认监视大小的资源禁用监视缓存。 - - - --delete-collection-workers int     默认值:1 @@ -852,11 +837,11 @@ Number of workers spawned for DeleteCollection call. These are used to speed up -尽管位于默认启用的插件列表中(NamespaceLifecycle、LimitRanger、ServiceAccount、TaintNodesByCondition、PodSecurity、Priority、DefaultTolerationSeconds、DefaultStorageClass、StorageObjectInUseProtection、PersistentVolumeClaimResize、RuntimeClass、CertificateApproval、CertificateSigning、CertificateSubjectRestriction、DefaultIngressClass、MutatingAdmissionWebhook、ValidatingAdmissionWebhook、ResourceQuota)仍须被禁用的插件。 -
取值为逗号分隔的准入插件列表:AlwaysAdmit、AlwaysDeny、AlwaysPullImages、CertificateApproval、CertificateSigning、CertificateSubjectRestriction、DefaultIngressClass、DefaultStorageClass、DefaultTolerationSeconds、DenyServiceExternalIPs、EventRateLimit、ExtendedResourceToleration、ImagePolicyWebhook、LimitPodHardAntiAffinityTopology、LimitRanger、MutatingAdmissionWebhook、NamespaceAutoProvision、NamespaceExists、NamespaceLifecycle、NodeRestriction、OwnerReferencesPermissionEnforcement、PersistentVolumeClaimResize、PersistentVolumeLabel、PodNodeSelector、PodSecurity、PodSecurityPolicy、PodTolerationRestriction、Priority、ResourceQuota、RuntimeClass、SecurityContextDeny、ServiceAccount、StorageObjectInUseProtection、TaintNodesByCondition、ValidatingAdmissionWebhook。 -
该标志中插件的顺序无关紧要。 +

尽管位于默认启用的插件列表中(NamespaceLifecycle、LimitRanger、ServiceAccount、TaintNodesByCondition、PodSecurity、Priority、DefaultTolerationSeconds、DefaultStorageClass、StorageObjectInUseProtection、PersistentVolumeClaimResize、RuntimeClass、CertificateApproval、CertificateSigning、CertificateSubjectRestriction、DefaultIngressClass、MutatingAdmissionWebhook、ValidatingAdmissionWebhook、ResourceQuota)仍须被禁用的插件。 +
取值为逗号分隔的准入插件列表:AlwaysAdmit、AlwaysDeny、AlwaysPullImages、CertificateApproval、CertificateSigning、CertificateSubjectRestriction、DefaultIngressClass、DefaultStorageClass、DefaultTolerationSeconds、DenyServiceExternalIPs、EventRateLimit、ExtendedResourceToleration、ImagePolicyWebhook、LimitPodHardAntiAffinityTopology、LimitRanger、MutatingAdmissionWebhook、NamespaceAutoProvision、NamespaceExists、NamespaceLifecycle、NodeRestriction、OwnerReferencesPermissionEnforcement、PersistentVolumeClaimResize、PersistentVolumeLabel、PodNodeSelector、PodSecurity、PodTolerationRestriction、Priority、ResourceQuota、RuntimeClass、SecurityContextDeny、ServiceAccount、StorageObjectInUseProtection、TaintNodesByCondition、ValidatingAdmissionWebhook。 +
该标志中插件的顺序无关紧要。

@@ -892,14 +877,10 @@ File with apiserver egress selector configuration. -除了默认启用的插件(NamespaceLifecycle、LimitRanger、ServiceAccount、TaintNodesByCondition、PodSecurity、Priority、DefaultTolerationSeconds、DefaultStorageClass、StorageObjectInUseProtection、PersistentVolumeClaimResize、RuntimeClass、CertificateApproval、CertificateSigning、CertificateSubjectRestriction、DefaultIngressClass、MutatingAdmissionWebhook、ValidatingAdmissionWebhook、ResourceQuota)之外要启用的插件 -
取值为逗号分隔的准入插件列表:AlwaysAdmit、AlwaysDeny、AlwaysPullImages、CertificateApproval、CertificateSigning、CertificateSubjectRestriction、DefaultIngressClass、DefaultStorageClass、DefaultTolerationSeconds、DenyServiceExternalIPs、EventRateLimit、ExtendedResourceToleration、ImagePolicyWebhook、LimitPodHardAntiAffinityTopology、LimitRanger、MutatingAdmissionWebhook、NamespaceAutoProvision、NamespaceExists、NamespaceLifecycle、NodeRestriction、OwnerReferencesPermissionEnforcement、PersistentVolumeClaimResize、PersistentVolumeLabel、PodNodeSelector、PodSecurity、PodSecurityPolicy、PodTolerationRestriction、Priority、ResourceQuota、RuntimeClass、SecurityContextDeny、ServiceAccount、StorageObjectInUseProtection、TaintNodesByCondition、ValidatingAdmissionWebhook +

除了默认启用的插件(NamespaceLifecycle、LimitRanger、ServiceAccount、TaintNodesByCondition、PodSecurity、Priority、DefaultTolerationSeconds、DefaultStorageClass、StorageObjectInUseProtection、PersistentVolumeClaimResize、RuntimeClass、CertificateApproval、CertificateSigning、CertificateSubjectRestriction、DefaultIngressClass、MutatingAdmissionWebhook、ValidatingAdmissionWebhook、ResourceQuota)之外要启用的插件 +
取值为逗号分隔的准入插件列表:AlwaysAdmit、AlwaysDeny、AlwaysPullImages、CertificateApproval、CertificateSigning、CertificateSubjectRestriction、DefaultIngressClass、DefaultStorageClass、DefaultTolerationSeconds、DenyServiceExternalIPs、EventRateLimit、ExtendedResourceToleration、ImagePolicyWebhook、LimitPodHardAntiAffinityTopology、LimitRanger、MutatingAdmissionWebhook、NamespaceAutoProvision、NamespaceExists、NamespaceLifecycle、NodeRestriction、OwnerReferencesPermissionEnforcement、PersistentVolumeClaimResize、PersistentVolumeLabel、PodNodeSelector、PodSecurity、PodTolerationRestriction、Priority、ResourceQuota、RuntimeClass、SecurityContextDeny、ServiceAccount、StorageObjectInUseProtection、TaintNodesByCondition、ValidatingAdmissionWebhook


该标志中插件的顺序无关紧要。 @@ -1081,6 +1062,22 @@ The prefix to prepend to all resource paths in etcd. + + + +--etcd-readycheck-timeout 时长     默认值: 2s + + + +

+ +检查 etcd 是否就绪时使用的超时

+ + --etcd-servers strings @@ -1102,10 +1099,12 @@ List of etcd servers to connect with (scheme://ip:port), comma separated. Per-resource etcd servers overrides, comma separated. The individual override format: group/resource#servers, where servers are URLs, semicolon separated. +Note that this applies only to resources compiled into this server binary. --> etcd 服务器针对每个资源的重载设置,以逗号分隔。 单个替代格式:组/资源#服务器(group/resource#servers), 其中服务器是 URL,以分号分隔。 +注意,此选项仅适用于编译进此服务器二进制文件的资源。 @@ -1135,12 +1134,16 @@ The hostname to use when generating externalized URLs for this master ---feature-gates <逗号分隔的 'key=True|False' 键值对> +--feature-gates < + +逗号分隔的 'key=True|False' 键值对> -

一组 key=value 对,用来描述测试性/试验性功能的特性门控。可选项有: +

一组 key=value 对,用来描述测试性/试验性功能的特性门控。可选项有:
APIListChunking=true|false (BETA - 默认值=true)
APIPriorityAndFairness=true|false (BETA - 默认值=true)
APIResponseCompression=true|false (BETA - 默认值=true)
@@ -1253,92 +1260,96 @@ AllBeta=true|false (BETA - 默认值=false)
AnyVolumeDataSource=true|false (BETA - 默认值=true)
AppArmor=true|false (BETA - 默认值=true)
CPUManager=true|false (BETA - 默认值=true)
-CPUManagerPolicyAlphaOptions=true|false (ALPHA - 默认值=false)
+CPUManagerPolicyAlphaOptions=true|false (ALPHA - 默认值=false)
CPUManagerPolicyBetaOptions=true|false (BETA - 默认值=true)
CPUManagerPolicyOptions=true|false (BETA - 默认值=true)
-CSIInlineVolume=true|false (BETA - 默认值=true)
-CSIMigration=true|false (BETA - 默认值=true)
-CSIMigrationAWS=true|false (BETA - 默认值=true)
CSIMigrationAzureFile=true|false (BETA - 默认值=true)
-CSIMigrationGCE=true|false (BETA - 默认值=true)
-CSIMigrationPortworx=true|false (ALPHA - 默认值=false)
+CSIMigrationPortworx=true|false (BETA - 默认值=false)
CSIMigrationRBD=true|false (ALPHA - 默认值=false)
-CSIMigrationvSphere=true|false (BETA - 默认值=false)
+CSIMigrationvSphere=true|false (BETA - 默认值=true)
+CSINodeExpandSecret=true|false (ALPHA - 默认值=false)
CSIVolumeHealth=true|false (ALPHA - 默认值=false)
+ContainerCheckpoint=true|false (ALPHA - 默认值=false)
ContextualLogging=true|false (ALPHA - 默认值=false)
-CronJobTimeZone=true|false (ALPHA - 默认值=false)
+CronJobTimeZone=true|false (BETA - 默认值=true)
CustomCPUCFSQuotaPeriod=true|false (ALPHA - 默认值=false)
-CustomResourceValidationExpressions=true|false (ALPHA - 默认值=false)
-DaemonSetUpdateSurge=true|false (BETA - 默认值=true)
+CustomResourceValidationExpressions=true|false (BETA - 默认值=true)
DelegateFSGroupToCSIDriver=true|false (BETA - 默认值=true)
DevicePlugins=true|false (BETA - 默认值=true)
-DisableAcceleratorUsageMetrics=true|false (BETA - 默认值=true)
DisableCloudProviders=true|false (ALPHA - 默认值=false)
DisableKubeletCloudCredentialProviders=true|false (ALPHA - 默认值=false)
DownwardAPIHugePages=true|false (BETA - 默认值=true)
EndpointSliceTerminatingCondition=true|false (BETA - 默认值=true)
-EphemeralContainers=true|false (BETA - 默认值=true)
ExpandedDNSConfig=true|false (ALPHA - 默认值=false)
-ExperimentalHostUserNamespaceDefaulting=true|false (BETA - 默认值=false)
+ExperimentalHostUserNamespace默认值ing=true|false (BETA - 默认值=false)
GRPCContainerProbe=true|false (BETA - 默认值=true)
GracefulNodeShutdown=true|false (BETA - 默认值=true)
GracefulNodeShutdownBasedOnPodPriority=true|false (BETA - 默认值=true)
HPAContainerMetrics=true|false (ALPHA - 默认值=false)
HPAScaleToZero=true|false (ALPHA - 默认值=false)
HonorPVReclaimPolicy=true|false (ALPHA - 默认值=false)
-IdentifyPodOS=true|false (BETA - 默认值=true)
+IPTablesOwnershipCleanup=true|false (ALPHA - 默认值=false)
InTreePluginAWSUnregister=true|false (ALPHA - 默认值=false)
InTreePluginAzureDiskUnregister=true|false (ALPHA - 默认值=false)
-InTreePluginAzureFileUnregister=true|false (ALPHA - 默认值=false)
I -nTreePluginGCEUnregister=true|false (ALPHA - 默认值=false)
+InTreePluginAzureFileUnregister=true|false (ALPHA - 默认值=false)
+InTreePluginGCEUnregister=true|false (ALPHA - 默认值=false)
InTreePluginOpenStackUnregister=true|false (ALPHA - 默认值=false)
InTreePluginPortworxUnregister=true|false (ALPHA - 默认值=false)
InTreePluginRBDUnregister=true|false (ALPHA - 默认值=false)
InTreePluginvSphereUnregister=true|false (ALPHA - 默认值=false)
JobMutableNodeSchedulingDirectives=true|false (BETA - 默认值=true)
+JobPodFailurePolicy=true|false (ALPHA - 默认值=false)
JobReadyPods=true|false (BETA - 默认值=true)
-JobTrackingWithFinalizers=true|false (BETA - 默认值=false)
+JobTrackingWithFinalizers=true|false (BETA - 默认值=true)
+KMSv2=true|false (ALPHA - 默认值=false)
KubeletCredentialProviders=true|false (BETA - 默认值=true)
KubeletInUserNamespace=true|false (ALPHA - 默认值=false)
KubeletPodResources=true|false (BETA - 默认值=true)
KubeletPodResourcesGetAllocatable=true|false (BETA - 默认值=true)
+KubeletTracing=true|false (ALPHA - 默认值=false)
LegacyServiceAccountTokenNoAutoGeneration=true|false (BETA - 默认值=true)
-LocalStorageCapacityIsolation=true|false (BETA - 默认值=true)
-LocalStorageCapacityIsolationFSQuotaMonitoring=true|false (ALPHA - 默认值=false)
+LocalStorageCapacityIsolationFSQuotaMonitoring=true|false (BETA - 默认值=true)
LogarithmicScaleDown=true|false (BETA - 默认值=true)
+LoggingAlphaOptions=true|false (ALPHA - 默认值=false)
+LoggingBetaOptions=true|false (BETA - 默认值=true)
+MatchLabelKeysInPodTopologySpread=true|false (ALPHA - 默认值=false)
MaxUnavailableStatefulSet=true|false (ALPHA - 默认值=false)
MemoryManager=true|false (BETA - 默认值=true)
MemoryQoS=true|false (ALPHA - 默认值=false)
-MinDomainsInPodTopologySpread=true|false (ALPHA - 默认值=false)
+MinDomainsInPodTopologySpread=true|false (BETA - 默认值=false)
MixedProtocolLBService=true|false (BETA - 默认值=true)
-NetworkPolicyEndPort=true|false (BETA - 默认值=true)
+MultiCIDRRangeAllocator=true|false (ALPHA - 默认值=false)
NetworkPolicyStatus=true|false (ALPHA - 默认值=false)
+NodeInclusionPolicyInPodTopologySpread=true|false (ALPHA - 默认值=false)
NodeOutOfServiceVolumeDetach=true|false (ALPHA - 默认值=false)
NodeSwap=true|false (ALPHA - 默认值=false)
OpenAPIEnums=true|false (BETA - 默认值=true)
OpenAPIV3=true|false (BETA - 默认值=true)
PodAndContainerStatsFromCRI=true|false (ALPHA - 默认值=false)
PodDeletionCost=true|false (BETA - 默认值=true)
-PodSecurity=true|false (BETA - 默认值=true)
-ProbeTerminationGracePeriod=true|false (BETA - 默认值=false)
+PodDisruptionConditions=true|false (ALPHA - 默认值=false)
+PodHasNetworkCondition=true|false (ALPHA - 默认值=false)
+ProbeTerminationGracePeriod=true|false (BETA - 默认值=true)
ProcMountType=true|false (ALPHA - 默认值=false)
ProxyTerminatingEndpoints=true|false (ALPHA - 默认值=false)
QOSReserved=true|false (ALPHA - 默认值=false)
ReadWriteOncePod=true|false (ALPHA - 默认值=false)
RecoverVolumeExpansionFailure=true|false (ALPHA - 默认值=false)
RemainingItemCount=true|false (BETA - 默认值=true)
+Retroactive默认值StorageClass=true|false (ALPHA - 默认值=false)
RotateKubeletServerCertificate=true|false (BETA - 默认值=true)
-Seccomp默认值=true|false (ALPHA - 默认值=false)
-ServerSideFieldValidation=true|false (ALPHA - 默认值=false)
-ServiceIPStaticSubrange=true|false (ALPHA - 默认值=false)
+SELinuxMountReadWriteOncePod=true|false (ALPHA - 默认值=false)
+Seccomp默认值=true|false (BETA - 默认值=true)
+ServerSideFieldValidation=true|false (BETA - 默认值=true)
+ServiceIPStaticSubrange=true|false (BETA - 默认值=true)
ServiceInternalTrafficPolicy=true|false (BETA - 默认值=true)
SizeMemoryBackedVolumes=true|false (BETA - 默认值=true)
StatefulSetAutoDeletePVC=true|false (ALPHA - 默认值=false)
-StatefulSetMinReadySeconds=true|false (BETA - 默认值=true)
StorageVersionAPI=true|false (ALPHA - 默认值=false)
StorageVersionHash=true|false (BETA - 默认值=true)
TopologyAwareHints=true|false (BETA - 默认值=true)
TopologyManager=true|false (BETA - 默认值=true)
+UserNamespacesStatelessPodsSupport=true|false (ALPHA - 默认值=false)
VolumeCapacityPriority=true|false (ALPHA - 默认值=false)
WinDSR=true|false (ALPHA - 默认值=false)
WinOverlay=true|false (BETA - 默认值=true)
@@ -1763,11 +1774,11 @@ If not provided, username claims other than 'email' are prefixed

- 若此标志为 true,则使用 SO_REUSEADDR 来绑定端口。 这样设置可以同时绑定到用通配符表示的类似 0.0.0.0 这种 IP 地址, -以及特定的 IP 地址。也可以避免等待内核释放 TIME_WAIT 状态的套接字。 +以及特定的 IP 地址。也可以避免等待内核释放 TIME_WAIT 状态的套接字。[默认值=false]

@@ -1781,7 +1792,7 @@ If true, SO_REUSEPORT will be used when binding the port, which allows more than one instance to bind on the same address and port. [default=false] --> 如果为 true,则在绑定端口时将使用 SO_REUSEPORT, -这样多个实例可以绑定到同一地址和端口上。 +这样多个实例可以绑定到同一地址和端口上。[默认值=false] @@ -2099,9 +2110,11 @@ The issuer will sign issued ID tokens with this private key. CIDR 表示的 IP 范围用来为服务分配集群 IP。 此地址不得与指定给节点或 Pod 的任何 IP 范围重叠。 +最多允许两个双栈 CIDR。 @@ -2111,11 +2124,11 @@ CIDR 表示的 IP 范围用来为服务分配集群 IP。 -保留给具有 NodePort 可见性的服务的端口范围。 -例如:"30000-32767"。范围的两端都包括在内。 +

保留给具有 NodePort 可见性的服务的端口范围。 +不得与节点上的临时端口范围重叠。 +例如:"30000-32767"。范围的两端都包括在内。

@@ -2384,25 +2397,19 @@ Enable watch caching in the apiserver -某些资源(Pods、Nodes 等)的监视缓存大小设置,以逗号分隔。 +

某些资源(Pod、Node 等)的监视缓存大小设置,以逗号分隔。 每个资源对应的设置格式:resource[.group]#size,其中 resource 为小写复数(无版本), 对于 apiVersion v1(旧版核心 API)的资源要省略 group, 对其它资源要给出 groupsize 为一个数字。 -启用 watch-cache 时,此功能生效。 -某些资源(replicationcontrollersendpoints、 -nodespodsservices、 -apiservices.apiregistration.k8s.io) -具有通过启发式设置的系统默认值,其他资源默认为 -default-watch-cache-size。 +此选项仅对 API 服务器中的内置资源生效,对 CRD 定义的资源或从外部服务器接入的资源无效。 +启用 watch-cache 时仅查询此选项。 +这里能生效的 size 设置只有 0,意味着禁用关联资源的 watch-cache。 +所有的非零值都等效,意味着不禁用该资源的watch-cache

+ +