KUBERNETES(1)(kubernetes)
β¨ KUBERNETES(1)(kubernetes) β¨
okay bestie, welcome to the kubectl cordon page from the kubernetes manual π this is section 1 of the kubernetes manuals, and yes it's giving "I read manpages for fun" energy. no shame. π
Eric Paris wrote the original back in Jan 2015, and we're gonna get through the whole thing together. grab a boba. π§
πΈ NAME πΈ
kubectl cordon β mark node as unschedulable
literally that's it. that's the whole job. π
π¦ SYNOPSIS π¦
kubectl cordon [OPTIONS]
β¨ DESCRIPTION β¨
Mark node as unschedulable.
fr fr that's the description. short, sweet, no notes. π
π OPTIONS π
--dry-run="none"β Must be"none","server", or"client". If it's the client strategy, it only prints the object that would have been sent, without actually sending it. If it's the server strategy, it submits a server-side request without persisting the resource. (yes, the default is"none", so nothing dry happens unless you ask)-l,--selector=""β Selector (label query) to filter on, and it supports'=','==','!=','in','notin'. (e.g.-l key1=value1,key2=value2,key3 in (value3)). Every matching object has to satisfy all of the specified label constraints β no picking and choosing, bestie. π
π OPTIONS INHERITED FROM PARENT COMMANDS π
these come from the parent command, so they're not cordon's own, but they ride along and they all matter. do not skip. π
--as=""β Username to impersonate for the operation. The user could be a regular user or a service account in a namespace.--as-group=[]β Group to impersonate for the operation. This flag can be repeated to specify multiple groups.--as-uid=""β UID to impersonate for the operation.--as-user-extra=[]β User extras to impersonate for the operation. This flag can be repeated to specify multiple values for the same key.--cache-dir="/home/username/.kube/cache"β Default cache directory--certificate-authority=""β Path to a cert file for the certificate authority--client-certificate=""β Path to a client certificate file for TLS--client-key=""β Path to a client key file for TLS--cluster=""β The name of the kubeconfig cluster to use--context=""β The name of the kubeconfig context to use--disable-compression=falseβ If true, opt-out of response compression for all requests to the server--insecure-skip-tls-verify=falseβ If true, the server's certificate will not be checked for validity.
π¨ bestie listen. This will make your HTTPS connections insecure. That's not a vibe, that's a warning. insecure. π
--kubeconfig=""β Path to the kubeconfig file to use for CLI requests.--kuberc=""β Path to the kuberc file to use for preferences. This can be disabled by exporting theKUBECTL_KUBERC=falsefeature gate or turning off the featureKUBERC=off.--match-server-version=falseβ Require server version to match client version-n,--namespace=""β If present, the namespace scope for this CLI request--password=""β Password for basic authentication to the API server--profile="none"β Name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex|trace)--profile-output="profile.pprof"β Name of the file to write the profile to--proxy-url=""β Proxy URL to use for requests to the API server--request-timeout="0"β The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g.1s,2m,3h). A value of zero means don't timeout requests.-s,--server=""β The address and port of the Kubernetes API server--tls-server-name=""β Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used--token=""β Bearer token for authentication to the API server--user=""β The name of the kubeconfig user to use--username=""β Username for basic authentication to the API server--version=falseβ--version,--version=rawprints version information and quits;--version=vX.Y.Z...sets the reported version--warnings-as-errors=falseβ Treat warnings received from the server as errors and exit with a non-zero exit code
π EXAMPLE π
okay this one is so satisfying, watch:
# Mark node "foo" as unschedulable
kubectl cordon foo
the way that just works. main character energy. β
π SEE ALSO π
π HISTORY π
January 2015, originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! π¦
and that's the whole page, bestie!! π«Ά this was Manuals / User / KUBERNETES(1)(kubernetes) β sourced from the kubernetes manual set, dated January 2015. go forth and cordon responsibly. no cap. πβ¨
π¦ where this page comes from
- arch rolling: kubectl 1.37.2-1 Β· Apache-2.0
- fedora 43: kubernetes1.37-client 1.37.0-3.fc43
- fedora 43: kubernetes1.37-client 1.37.1-1.fc43 Β· Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND BSD-3-Clause-HP AND CC-BY-4.0 AND ISC AND MIT AND MPL-2.0
- fedora 44: kubernetes1.37-client 1.37.0-3.fc44
- fedora 44: kubernetes1.37-client 1.37.1-1.fc44 Β· Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND BSD-3-Clause-HP AND CC-BY-4.0 AND ISC AND MIT AND MPL-2.0
- nixpkgs unstable: kubectl 1.37.2
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms