KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
Eric Paris Jan 2015

kube-scheduler - زمان‌بند کوبرنتیز برای تخصیص پادها به گره‌ها

kube-scheduler [OPTIONS]

زمان‌بند کوبرنتیز یک فرآیند در صفحه کنترل (control plane) است که Podها را به Nodeها اختصاص می‌دهد. زمان‌بند بر اساس محدودیت‌ها و منابع موجود، گره‌های معتبر را برای هر پاد در صف زمان‌بندی تعیین می‌کند. سپس زمان‌بند به هر گره معتبر رتبه داده و پاد را به یک گره مناسب مقید (bind) می‌سازد. ممکن است چندین زمان‌بند مختلف در یک کلاستر استفاده شوند؛ kube-scheduler پیاده‌سازی مرجع است. برای اطلاعات بیشتر درباره زمان‌بندی و مؤلفه kube-scheduler، به مبحث زمان‌بندی در ⟨https://kubernetes.io/docs/concepts/scheduling-eviction⟩ مراجعه کنید.

--allow-metric-labels=[] نگاشت از metric-label به فهرست مجاز مقادیر این برچسب. قالب کلید به صورت , است. قالب مقدار به صورت ,... است، مانند: metric1,label1='v1,v2,v3', metric1,label2='v1,v2,v3' metric2,label1='v1,v2,v3'.

--allow-metric-labels-manifest="" مسیر فایل مانیفست حاوی نگاشت فهرست مجاز. قالب این فایل مشابه پرچم --allow-metric-labels است، مانند: allowListMapping:
"metric1,label1": "value11,value12"
"metric2,label2": "" توجه داشته باشید که پرچم --allow-metric-labels بر این فایل مانیفست اولویت دارد و مقدار آن را بازنویسی می‌کند.

--authentication-kubeconfig="" فایل kubeconfig اشاره‌کننده به سرور اصلی (core) کوبرنتیز با دسترسی‌های کافی جهت ایجاد tokenreviews.authentication.k8s.io. این گزینه اختیاری است. اگر خالی باشد، تمام درخواست‌های توکن ناشناس تلقی شده و هیچ CA کلاینتی در کلاستر جستجو نمی‌شود.

--authentication-skip-lookup=false اگر false باشد، از authentication-kubeconfig برای جستجوی پیکربندی احراز هویت ناموجود در کلاستر استفاده خواهد شد.

--authentication-token-webhook-cache-ttl=10s مدت‌زمان کش کردن پاسخ‌های دریافتی از احراز هویت‌کننده توکن وب‌هوک.

--authentication-tolerate-lookup-failure=true اگر true باشد، عدم موفقیت در جستجوی پیکربندی احراز هویت از کلاستر خطای مهلک محسوب نمی‌شود. توجه داشته باشید که این موضوع می‌تواند باعث شود احراز هویت با تمام درخواست‌ها به صورت ناشناس رفتار کند.

--authorization-always-allow-paths=[/healthz,/readyz,/livez] فهرستی از مسیرهای HTTP برای نادیده گرفتن در زمان بررسی مجوزها؛ یعنی این مسیرها بدون تماس با سرور اصلی (core) کوبرنتیز مجاز دانسته می‌شوند.

--authorization-kubeconfig="" فایل kubeconfig اشاره‌کننده به سرور اصلی (core) کوبرنتیز با اختیارات کافی برای ایجاد subjectaccessreviews.authorization.k8s.io. این گزینه اختیاری است. در صورت خالی بودن، تمام درخواست‌هایی که از بررسی مجوز مستثنی نشده باشند رد می‌شوند (forbidden).

--authorization-webhook-cache-authorized-ttl=10s مدت‌زمان کش کردن پاسخ‌های «مجاز» (authorized) از ناظر مجوز وب‌هوک.

--authorization-webhook-cache-unauthorized-ttl=10s مدت‌زمان کش کردن پاسخ‌های «غیرمجاز» (unauthorized) از ناظر مجوز وب‌هوک.

--bind-address=0.0.0.0 آدرس IP برای گوش دادن به درگاه پرچم --secure-port. رابط(های) شبکه مرتبط باید از سایر نقاط کلاستر و کلاینت‌های CLI/وب در دسترس باشند. اگر خالی یا یک آدرس نامشخص (0.0.0.0 یا ::) باشد، تمام رابط‌ها و خانواده‌های آدرس IP استفاده خواهند شد.

--cert-dir="" دایرکتوری محل قرارگیری گواهی‌های TLS. اگر --tls-cert-file و --tls-private-key-file ارائه شوند، این پرچم نادیده گرفته خواهد شد.

--client-ca-file="" در صورت تنظیم، هر درخواستی که گواهی کلاینت امضاشده توسط یکی از مراجع صادرکننده در client-ca-file ارائه دهد، با هویتی متناظر با CommonName موجود در گواهی کلاینت احراز هویت می‌شود.

--config="" مسیر فایل پیکربندی.

--contention-profiling=true منسوخ‌شده: فعال‌سازی پروفایل‌گیری مسدودسازی (block profiling) در صورتی که پروفایل‌گیری فعال باشد. در صورت تعیین یک فایل پیکربندی در --config، این پارامتر نادیده گرفته می‌شود.

--disable-http2-serving=false اگر true باشد، سرویس‌دهی HTTP2 غیرفعال خواهد شد [پیش‌فرض=false].

--disabled-metrics=[] این پرچم راهکاری اضطراری برای معیارهای دارای رفتار ناصحیح فراهم می‌کند. برای غیرفعال کردن یک معیار، باید نام کامل (fully qualified) آن را مشخص کنید. سلب مسئولیت: غیرفعال‌سازی معیارها اولویت بالاتری نسبت به نمایش معیارهای پنهان دارد.

--emulated-version=[] نسخه‌هایی که مؤلفه‌های مختلف، قابلیت‌های خود (APIها، ویژگی‌ها، ...) را از روی آن‌ها شبیه‌سازی می‌کنند. در صورت تنظیم، مؤلفه رفتار این نسخه را به جای نسخه باینری زیربنایی شبیه‌سازی خواهد کرد. قالب نسخه تنها می‌تواند major.minor باشد، به عنوان مثال: '--emulated-version=wardle=1.2,kube=1.31'. گزینه‌ها عبارتند از: kube=1.33..1.36(پیش‌فرض:1.36) اگر مؤلفه مشخص نشود، پیش‌فرض "kube" خواهد بود.

--feature-gates= فهرستی جداشده با کاما از جفت‌های component:key=value که دریچه‌های ویژگی (feature gates) را برای قابلیت‌های آلفا/آزمایشی مؤلفه‌های مختلف توصیف می‌کند. اگر مؤلفه مشخص نشود، پیش‌فرض "kube" است. این پرچم می‌تواند به صورت مکرر فراخوانی شود. برای مثال: --feature-gates 'wardle:featureA=true,wardle:featureB=false' --feature-gates 'kube:featureC=true' گزینه‌ها عبارتند از: kube:APIResponseCompression=true|false (BETA - default=true) kube:APIServerIdentity=true|false (BETA - default=true) kube:APIServingWithRoutine=true|false (ALPHA - default=false) kube:AllAlpha=true|false (ALPHA - default=false) kube:AllBeta=true|false (BETA - default=false) kube:AllowParsingUserUIDFromCertAuth=true|false (BETA - default=true) kube:AllowUnsafeMalformedObjectDeletion=true|false (ALPHA - default=false) kube:AtomicFIFO=true|false (BETA - default=true) kube:AuthorizePodWebsocketUpgradeCreatePermission=true|false (BETA - default=true) kube:CBORServingAndStorage=true|false (ALPHA - default=false) kube:CPUManagerPolicyAlphaOptions=true|false (ALPHA - default=false) kube:CPUManagerPolicyBetaOptions=true|false (BETA - default=true) kube:CRDObservedGenerationTracking=true|false (BETA - default=true) kube:CRIListStreaming=true|false (ALPHA - default=false) kube:CSIVolumeHealth=true|false (ALPHA - default=false) kube:ClearingNominatedNodeNameAfterBinding=true|false (BETA - default=true) kube:ClientsAllowCARotation=true|false (BETA - default=true) kube:ClientsAllowCBOR=true|false (ALPHA - default=false) kube:ClientsAllowTLSCacheGC=true|false (BETA - default=true) kube:ClientsPreferCBOR=true|false (ALPHA - default=false) kube:CloudControllerManagerWatchBasedRoutesReconciliation=true|false (ALPHA - default=false) kube:CloudControllerManagerWebhook=true|false (ALPHA - default=false) kube:ClusterTrustBundle=true|false (BETA - default=false) kube:ClusterTrustBundleProjection=true|false (BETA - default=false) kube:ComponentFlagz=true|false (BETA - default=true) kube:ComponentStatusz=true|false (BETA - default=true) kube:ConcurrentWatchObjectDecode=true|false (BETA - default=false) kube:ConstrainedImpersonation=true|false (BETA - default=true) kube:ContainerCheckpoint=true|false (BETA - default=true) kube:ContainerRestartRules=true|false (BETA - default=true) kube:ContainerStopSignals=true|false (ALPHA - default=false) kube:ContextualLogging=true|false (BETA - default=true) kube:ControllerManagerReleaseLeaderElectionLockOnExit=true|false (ALPHA - default=false) kube:CoordinatedLeaderElection=true|false (BETA - default=false) kube:CrossNamespaceVolumeDataSource=true|false (ALPHA - default=false) kube:DRAConsumableCapacity=true|false (BETA - default=true) kube:DRADeviceBindingConditions=true|false (BETA - default=true) kube:DRADeviceTaintRules=true|false (BETA - default=false) kube:DRADeviceTaints=true|false (BETA - default=true) kube:DRAExtendedResource=true|false (BETA - default=true) kube:DRAListTypeAttributes=true|false (ALPHA - default=false) kube:DRANodeAllocatableResources=true|false (ALPHA - default=false) kube:DRAPartitionableDevices=true|false (BETA - default=true) kube:DRAResourceClaimDeviceStatus=true|false (BETA - default=true) kube:DRAResourceClaimGranularStatusAuthorization=true|false (BETA - default=true) kube:DRAResourcePoolStatus=true|false (ALPHA - default=false) kube:DRASchedulerFilterTimeout=true|false (BETA - default=true) kube:DRAWorkloadResourceClaims=true|false (ALPHA - default=false) kube:DeclarativeValidationBeta=true|false (BETA - default=true) kube:DeploymentReplicaSetTerminatingReplicas=true|false (BETA - default=true) kube:DetectCacheInconsistency=true|false (BETA - default=true) kube:EnvFiles=true|false (BETA - default=true) kube:EventedPLEG=true|false (ALPHA - default=false) kube:ExtendWebSocketsToKubelet=true|false (BETA - default=true) kube:GangScheduling=true|false (ALPHA - default=false) kube:GenericWorkload=true|false (ALPHA - default=false) kube:GracefulNodeShutdown=true|false (BETA - default=true) kube:GracefulNodeShutdownBasedOnPodPriority=true|false (BETA - default=true) kube:HPAConfigurableTolerance=true|false (BETA - default=true) kube:HPAScaleToZero=true|false (ALPHA - default=false) kube:HostnameOverride=true|false (BETA - default=true) kube:ImageVolumeWithDigest=true|false (ALPHA - default=false) kube:InOrderInformersBatchProcess=true|false (BETA - default=true) kube:InPlacePodLevelResourcesVerticalScaling=true|false (BETA - default=true) kube:InPlacePodVerticalScalingExclusiveCPUs=true|false (ALPHA - default=false) kube:InPlacePodVerticalScalingExclusiveMemory=true|false (ALPHA - default=false) kube:InPlacePodVerticalScalingInitContainers=true|false (BETA - default=true) kube:KubeletCrashLoopBackOffMax=true|false (BETA - default=true) kube:KubeletEnsureSecretPulledImages=true|false (BETA - default=true) kube:KubeletInUserNamespace=true|false (ALPHA - default=false) kube:KubeletSeparateDiskGC=true|false (BETA - default=true) kube:KubeletServiceAccountTokenForCredentialProviders=true|false (BETA - default=true) kube:ListFromCacheSnapshot=true|false (BETA - default=true) kube:LocalStorageCapacityIsolationFSQuotaMonitoring=true|false (BETA - default=false) kube:LoggingAlphaOptions=true|false (ALPHA - default=false) kube:LoggingBetaOptions=true|false (BETA - default=true) kube:ManifestBasedAdmissionControlConfig=true|false (ALPHA - default=false) kube:MatchLabelKeysInPodTopologySpread=true|false (BETA - default=true) kube:MatchLabelKeysInPodTopologySpreadSelectorMerge=true|false (BETA - default=true) kube:MaxUnavailableStatefulSet=true|false (BETA - default=false) kube:MemoryQoS=true|false (ALPHA - default=false) kube:MutablePVNodeAffinity=true|false (ALPHA - default=false) kube:MutablePodResourcesForSuspendedJobs=true|false (BETA - default=true) kube:MutableSchedulingDirectivesForSuspendedJobs=true|false (BETA - default=true) kube:NativeHistograms=true|false (ALPHA - default=false) kube:NodeDeclaredFeatures=true|false (BETA - default=true) kube:NominatedNodeNameForExpectation=true|false (BETA - default=true) kube:OpenAPIEnums=true|false (BETA - default=true) kube:OpportunisticBatching=true|false (BETA - default=true) kube:PLEGOnDemandRelist=true|false (BETA - default=true) kube:PersistentVolumeClaimUnusedSinceTime=true|false (ALPHA - default=false) kube:PodAndContainerStatsFromCRI=true|false (ALPHA - default=false) kube:PodCertificateRequest=true|false (BETA - default=false) kube:PodDeletionCost=true|false (BETA - default=true) kube:PodLevelResourceManagers=true|false (ALPHA - default=false) kube:PodLevelResources=true|false (BETA - default=true) kube:PodLogsQuerySplitStreams=true|false (ALPHA - default=false) kube:PodReadyToStartContainersCondition=true|false (BETA - default=true) kube:PodTopologyLabelsAdmission=true|false (BETA - default=true) kube:PodsAPI=true|false (ALPHA - default=false) kube:PortForwardWebsockets=true|false (BETA - default=true) kube:PreventStaticPodAPIReferences=true|false (BETA - default=true) kube:QOSReserved=true|false (ALPHA - default=false) kube:ReduceDefaultCrashLoopBackOffDecay=true|false (ALPHA - default=false) kube:RelaxedServiceNameValidation=true|false (BETA - default=true) kube:ReloadKubeletClientCAFile=true|false (BETA - default=true) kube:ReloadKubeletServerCertificateFile=true|false (BETA - default=true) kube:RemoteRequestHeaderUID=true|false (BETA - default=true) kube:ResourceHealthStatus=true|false (BETA - default=true) kube:ResourceHealthStatusMessage=true|false (BETA - default=true) kube:RestartAllContainersOnContainerExits=true|false (BETA - default=true) kube:RotateKubeletServerCertificate=true|false (BETA - default=true) kube:RuntimeClassInImageCriApi=true|false (ALPHA - default=false) kube:SELinuxMount=true|false (BETA - default=false) kube:SchedulerAsyncAPICalls=true|false (BETA - default=false) kube:SchedulerAsyncPreemption=true|false (BETA - default=true) kube:SchedulerPopFromBackoffQ=true|false (BETA - default=true) kube:ServiceAccountNodeAudienceRestriction=true|false (BETA - default=true) kube:ShardedListAndWatch=true|false (ALPHA - default=false) kube:SizeBasedListCostEstimate=true|false (BETA - default=true) kube:StaleControllerConsistencyDaemonSet=true|false (BETA - default=true) kube:StaleControllerConsistencyJob=true|false (BETA - default=true) kube:StaleControllerConsistencyReplicaSet=true|false (BETA - default=true) kube:StaleControllerConsistencyStatefulSet=true|false (BETA - default=true) kube:StatefulSetSemanticRevisionComparison=true|false (BETA - default=true) kube:StorageCapacityScoring=true|false (ALPHA - default=false) kube:StorageVersionAPI=true|false (ALPHA - default=false) kube:StorageVersionHash=true|false (BETA - default=true) kube:StorageVersionMigrator=true|false (BETA - default=false) kube:StrictIPCIDRValidation=true|false (BETA - default=true) kube:StructuredAuthenticationConfigurationEgressSelector=true|false (BETA - default=true) kube:StructuredAuthenticationConfigurationJWKSMetrics=true|false (BETA - default=true) kube:TaintTolerationComparisonOperators=true|false (ALPHA - default=false) kube:TokenRequestServiceAccountUIDValidation=true|false (BETA - default=true) kube:TopologyAwareWorkloadScheduling=true|false (ALPHA - default=false) kube:TopologyManagerPolicyAlphaOptions=true|false (ALPHA - default=false) kube:TopologyManagerPolicyBetaOptions=true|false (BETA - default=true) kube:TranslateStreamCloseWebsocketRequests=true|false (BETA - default=true) kube:UnauthenticatedHTTP2DOSMitigation=true|false (BETA - default=true) kube:UnknownVersionInteroperabilityProxy=true|false (BETA - default=true) kube:UnlockWhileProcessingFIFO=true|false (BETA - default=true) kube:UserNamespacesHostNetworkSupport=true|false (ALPHA - default=false) kube:VolumeLimitScaling=true|false (ALPHA - default=false) kube:WatchCacheInitializationPostStartHook=true|false (BETA - default=true) kube:WatchList=true|false (BETA - default=true) kube:WatchListClient=true|false (BETA - default=true) kube:WindowsCPUAndMemoryAffinity=true|false (ALPHA - default=false) kube:WindowsGracefulNodeShutdown=true|false (BETA - default=true) kube:WorkloadAwarePreemption=true|false (ALPHA - default=false) kube:WorkloadWithJob=true|false (ALPHA - default=false).PP -h, --help=false راهنما برای kube-scheduler

--http2-max-streams-per-connection=0 محدودیتی که سرور به کلاینت‌ها برای بیشینه تعداد جریان‌ها در یک اتصال HTTP/2 می‌دهد. مقدار صفر به معنای استفاده از پیش‌فرض golang است.

--kube-api-burst=100 منسوخ‌شده: مقدار burst برای استفاده هنگام برقراری ارتباط با apiserver کوبرنتیز. در صورت مشخص شدن فایل پیکربندی در --config، این پارامتر نادیده گرفته می‌شود.

--kube-api-content-type="application/vnd.kubernetes.protobuf" منسوخ‌شده: نوع محتوای (content type) درخواست‌های ارسال‌شده به apiserver. در صورت مشخص شدن فایل پیکربندی در --config، این پارامتر نادیده گرفته می‌شود.

--kube-api-qps=50 منسوخ‌شده: مقدار QPS برای استفاده هنگام برقراری ارتباط با apiserver کوبرنتیز. در صورت مشخص شدن فایل پیکربندی در --config، این پارامتر نادیده گرفته می‌شود.

--kubeconfig="" منسوخ‌شده: مسیر فایل kubeconfig حاوی اطلاعات مجوزدهی و مکان master. در صورت مشخص شدن فایل پیکربندی در --config، این پارامتر نادیده گرفته می‌شود.

--leader-elect=true راه‌اندازی کلاینت انتخاب لیدر و به‌دست آوردن رهبری پیش از اجرای حلقه اصلی. هنگام اجرای مؤلفه‌های همتاسازی‌شده برای دستیابی به دسترسی‌پذیری بالا (high availability)، این گزینه را فعال کنید.

--leader-elect-lease-duration=15s مدت زمانی که نامزدهای غیرلیدر پس از مشاهده تمدید لیدری صبر می‌کنند تا برای کسب رهبری یک اسلات دارای لیدر اما تمدیدنَشده اقدام کنند. این مقدار عملاً بیشترین زمانی است که یک لیدر می‌تواند متوقف شود، پیش از آنکه با نامزد دیگری جایگزین گردد. این گزینه تنها در صورتی کاربرد دارد که انتخاب لیدر فعال باشد.

--leader-elect-renew-deadline=10s فاصله زمانی میان تلاش‌های لیدر کنونی برای تمدید اسلات رهبری پیش از توقف لیدری. این مقدار باید کمتر از مدت زمان اجاره (lease duration) باشد. این گزینه تنها در صورتی کاربرد دارد که انتخاب لیدر فعال باشد.

--leader-elect-resource-lock="leases" نوع شیء منبع مورد استفاده برای قفل‌گذاری حین فرایند انتخاب لیدر. مقادیر پشتیبانی‌شده عبارتند از “leases”.

--leader-elect-resource-name="kube-scheduler" نام شیء منبع مورد استفاده برای قفل‌گذاری حین فرایند انتخاب لیدر.

--leader-elect-resource-namespace="kube-system" فضای نام شیء منبع مورد استفاده برای قفل‌گذاری حین فرایند انتخاب لیدر.

--leader-elect-retry-period=2s مدت زمانی که کلاینت‌ها باید بین تلاش برای کسب و تمدید رهبری صبر کنند. این گزینه تنها در صورتی کاربرد دارد که انتخاب لیدر فعال باشد.

--log-flush-frequency=5s حداکثر تعداد ثانیه‌ها بین هر بار تخلیه بافر لاگ‌ها

--log-text-info-buffer-size=0 [آلفا] در قالب متنی با جریان‌های خروجی تفکیک‌شده، پیام‌های info می‌توانند برای افزایش کارایی مدتی بافر شوند. مقدار پیش‌فرض صفر بایت، بافر کردن را غیرفعال می‌کند. اندازه را می‌توان به صورت تعداد بایت (512)، مضارب 1000 (1K)، مضارب 1024 (2Ki)، یا توان‌هایی از آن‌ها (3M, 4G, 5Mi, 6Gi) تعیین کرد. برای استفاده از این امکان، feature gate با نام LoggingAlphaOptions را فعال کنید.

--log-text-split-stream=false [آلفا] در قالب متنی، پیام‌های خطا در stderr و پیام‌های info در stdout نوشته می‌شوند. پیش‌فرض، نوشتن در قالب یک جریان واحد در stdout است. برای استفاده از این امکان، feature gate با نام LoggingAlphaOptions را فعال کنید.

--logging-format="text" قالب لاگ را تعیین می‌کند. قالب‌های مجاز: "text".

--master="" آدرس Kubernetes API server (بر هر مقداری در kubeconfig اولویت دارد)

--min-compatibility-version=[] حداقل نسخه مؤلفه‌های control plane که سرور باید با آن‌ها سازگار باشد. باید کمتر یا مساوی با emulated-version باشد. قالب نسخه تنها می‌تواند به صورت major.minor باشد، برای مثال: '--min-compatibility-version=wardle=1.2,kube=1.31'. گزینه‌ها عبارتند از: kube=1.33..1.36(پیش‌فرض:1.35) اگر مؤلفه مشخص نشده باشد، مقدار پیش‌فرض "kube" خواهد بود

--permit-address-sharing=false در صورت فعال بودن (true)، هنگام بایند کردن پورت از SO_REUSEADDR استفاده می‌شود. این امر اجازه بایند شدن هم‌زمان به IPهای wildcard مانند 0.0.0.0 و IPهای خاص را می‌دهد و از معطل ماندن برای آزادسازی سوکت‌ها در وضعیت TIME_WAIT توسط هسته جلوگیری می‌کند. [پیش‌فرض=false]

--permit-port-sharing=false در صورت فعال بودن (true)، هنگام بایند کردن پورت از SO_REUSEPORT استفاده می‌شود که به بیش از یک نمونه اجازه می‌دهد به همان آدرس و پورت متصل شوند. [پیش‌فرض=false]

--pod-max-in-unschedulable-pods-duration=5m0s منسوخ‌شده: حداکثر زمانی که یک pod می‌تواند در unschedulablePods باقی بماند. اگر یک pod بیش از این مدت در unschedulablePods بماند، از unschedulablePods به backoffQ یا activeQ منتقل خواهد شد. این پرچم منسوخ شده است و در نسخه‌های آینده حذف خواهد شد.

--profiling=true منسوخ‌شده: فعال‌سازی پروفایلینگ از طریق رابط وب host:port/debug/pprof/. در صورت مشخص شدن فایل پیکربندی در --config، این پارامتر نادیده گرفته می‌شود.

--requestheader-allowed-names=[] فهرستی از نام‌های متداول (Common Names) گواهی کلاینت که مجازند در هدرهای مشخص‌شده توسط --requestheader-username-headers نام کاربری ارائه دهند. در صورت خالی بودن، هر گواهی کلاینت که توسط مراجع موجود در --requestheader-client-ca-file تایید شود مجاز خواهد بود.

--requestheader-client-ca-file="" بسته گواهی ریشه مورد استفاده برای اعتبارسنجی گواهی‌های کلاینت در درخواست‌های ورودی پیش از اعتماد به نام‌های کاربری در هدرهای مشخص‌شده توسط --requestheader-username-headers. هشدار: به‌طور کلی به اینکه مجوزدهی قبلاً برای درخواست‌های ورودی انجام شده اتکا نکنید.

--requestheader-extra-headers-prefix=[x-remote-extra-] فهرستی از پیشوندهای هدرهای درخواست برای بررسی. X-Remote-Extra- پیشنهاد می‌شود.

--requestheader-group-headers=[x-remote-group] فهرستی از هدرهای درخواست برای بررسی گروه‌ها. X-Remote-Group پیشنهاد می‌شود.

--requestheader-uid-headers=[] فهرستی از هدرهای درخواست برای بررسی UIDها. X-Remote-Uid پیشنهاد می‌شود. نیازمند فعال بودن ویژگی RemoteRequestHeaderUID است.

--requestheader-username-headers=[x-remote-user] فهرستی از هدرهای درخواست برای بررسی نام‌های کاربری. X-Remote-User رایج است.

--secure-port=10259 پورتی که پروتکل HTTPS با احراز هویت و مجوزدهی روی آن سرویس‌دهی می‌شود. در صورت تنظیم روی 0، HTTPS به‌هیچ‌وجه ارائه نخواهد شد.

--show-hidden-metrics-for-version="" نسخه پیشینی که می‌خواهید معیارهای پنهان‌شده مربوط به آن نمایش داده شوند. تنها نسخه فرعی (minor) پیشین معنادار است، مقادیر دیگر مجاز نخواهند بود. قالب به صورت . است، مانند: '1.16'. هدف از این قالب این است که مطمئن شوید فرصت مشاهده معیارهای مخفی‌شده بیشتر در انتشار بعدی را داشته باشید، به‌جای اینکه از حذف دائمی آن‌ها در انتشار بعدتر غافلگیر شوید.

--tls-cert-file="" فایل حاوی گواهی x509 پیش‌فرض برای HTTPS. (گواهی CA، در صورت وجود، پس از گواهی سرور الحاق می‌شود). در صورتی که ارائه HTTPS فعال باشد و --tls-cert-file و --tls-private-key-file ارائه نشده باشند، یک گواهی خودامضا و کلید برای آدرس عمومی تولید شده و در دایرکتوری مشخص‌شده توسط --cert-dir ذخیره می‌شود.

--tls-cipher-suites=[] فهرست جداشده با کاما از مجموعه‌های رمزنگاری (cipher suites) برای سرور. در صورت حذف، مجموعه‌های رمزنگاری پیش‌فرض Go استفاده خواهند شد. مقادیر پیشنهادی: TLS_AES_128_GCM_SHA256, TLS_AES_256_GCM_SHA384, TLS_CHACHA20_POLY1305_SHA256, TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305, TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305, TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256. مقادیر ناامن: TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256, TLS_ECDHE_ECDSA_WITH_RC4_128_SHA, TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256, TLS_ECDHE_RSA_WITH_RC4_128_SHA, TLS_RSA_WITH_3DES_EDE_CBC_SHA, TLS_RSA_WITH_AES_128_CBC_SHA, TLS_RSA_WITH_AES_128_CBC_SHA256, TLS_RSA_WITH_AES_128_GCM_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA, TLS_RSA_WITH_AES_256_GCM_SHA384, TLS_RSA_WITH_RC4_128_SHA.

--tls-curve-preferences=[] فهرست جداشده با کاما از مقادیر عددی CurveID در crypto/tls زبان Go، به عنوان سازوکارهای مجاز تبادل کلید برای سرور. مقادیر پشتیبانی‌شده به نسخه Go مورد استفاده بستگی دارد. مقادیر پشتیبانی‌شده برای هر نسخه Go را در https://pkg.go.dev/crypto/tls#CurveID ببینید. ترتیب فهرست نادیده گرفته می‌شود و سازوکارهای تبادل کلید بر اساس اولویت داخلی Go از این فهرست انتخاب می‌شوند. در صورت عدم تعیین، منحنی‌های پیش‌فرض Go استفاده خواهند شد.

--tls-min-version="" حداقل نسخه TLS پشتیبانی‌شده. مقادیر ممکن: VersionTLS10, VersionTLS11, VersionTLS12, VersionTLS13

--tls-private-key-file="" فایل حاوی کلید خصوصی x509 پیش‌فرض منطبق با --tls-cert-file.

--tls-sni-cert-key=[] یک جفت از مسیرهای فایل گواهی x509 و کلید خصوصی، که به صورت اختیاری با فهرستی از الگوهای دامنه که نام‌های دامنه کاملاً منطبق (FQDN) هستند (احتمالاً همراه با پیشوندهای wildcard) پسوندگذاری شده‌اند. الگوهای دامنه همچنین اجازه آدرس‌های IP را می‌دهند، اما آدرس‌های IP تنها در صورتی باید استفاده شوند که apiserver قابلیت دید به آدرس IP درخواست‌شده توسط یک کلاینت را داشته باشد. اگر هیچ الگوی دامنه‌ای ارائه نشود، نام‌ها از گواهی استخراج می‌شوند. تطابق‌های بدون wildcard بر تطابق‌های دارای wildcard ارجحیت دارند، و الگوهای دامنه صریح بر نام‌های استخراج‌شده مقدم هستند. برای استفاده از چندین جفت کلید/گواهی، گزینه --tls-sni-cert-key را چند بار به کار ببرید. مثال‌ها: "example.crt,example.key" یا "foo.crt,foo.key:*.foo.com,foo.com".

-v, --v=0 عددی برای تعیین سطح جزئیات لاگ (verbosity)

--version=false گزینه‌های --version و --version=raw اطلاعات نسخه را چاپ کرده و خارج می‌شوند؛ گزینه --version=vX.Y.Z... نسخه گزارش‌شده را تعیین می‌کند

--vmodule= فهرست جداشده با کاما از تنظیمات pattern=N برای ثبت لاگ فیلترشده براساس فایل (تنها برای قالب متنی لاگ کار می‌کند)

--write-config-to="" در صورت تنظیم، مقادیر پیکربندی را در این فایل می‌نویسد و خارج می‌شود..SH "تاریخچه (HISTORY)" ژانویه ۲۰۱۵، در ابتدا توسط Eric Paris (eparis at redhat dot com) بر اساس منابع kubernetes گردآوری شد، اما امید است که از آن زمان تاکنون به‌صورت خودکار تولید شده باشند!

User Manuals