KUBERNETES(1)(kubernetes)
π KUBERNETES(1)(kubernetes) β the kubectl manual, but make it cute π
okay bestie, welcome to the kubectl section of the manual (section 1, "kubernetes", yes that's the manual name, we're keeping it, it's iconic) β¨
β¨ NAME β¨
kubectl create service externalname β Create an ExternalName service π
π¦ SYNOPSIS π¦
kubectl create service externalname [OPTIONS]
πΈ DESCRIPTION πΈ
So you wanna Create an ExternalName service with the specified name. Periodt. π
An ExternalName service references to an external DNS address instead of only pods, which will allow application authors to reference services that exist off platform, on other clusters, or locally. Like, it's not bound to your lil pods at all β it just points at a DNS name somewhere else. Off platform? other clusters? locally? she does it all, no cap π
π OPTIONS π
--allow-missing-template-keys=trueβ If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats. (only those two formats bestie, don't @ me)--dry-run="none"β Must be"none","server", or"client". If client strategy, only print the object that would be sent, without sending it. If server strategy, submit server-side request without persisting the resource. It's giving "imagine doing it" energy π--external-name=""β External name of service--field-manager="kubectl-create"β Name of the manager used to track field ownership.-o,--output=""β Output format. One of: (json,yaml,kyaml,name,go-template,go-template-file,template,templatefile,jsonpath,jsonpath-as-json,jsonpath-file).--save-config=falseβ If true, the configuration of current object will be saved in its annotation. Otherwise, the annotation will be unchanged. This flag is useful when you want to performkubectl applyon this object in the future. future-proofing, we love to see it π«Ά--show-managed-fields=falseβ If true, keep themanagedFieldswhen printing objects in JSON or YAML format.--tcp=[]β Port pairs can be specified as':'.--template=""β Template string or path to template file to use when-o=go-template,-o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].--validate="strict"β Must be one of:strict(ortrue),warn,ignore(orfalse)."true"or"strict"will use a schema to validate the input and fail the request if invalid. It will perform server side validation ifServerSideFieldValidationis enabled on the api-server, but will fall back to less reliable client-side validation if not."warn"will warn about unknown or duplicate fields without blocking the request if server-side field validation is enabled on the API server, and behave as"ignore"otherwise."false"or"ignore"will not perform any schema validation, silently dropping any unknown or duplicate fields. she can be strict, she can be chill, she can be fully asleep π΄
π OPTIONS INHERITED FROM PARENT COMMANDS π
these are the family heirlooms, passed down from the parent command, we respect them π
--as=""β Username to impersonate for the operation. 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. This will make your HTTPS connections insecure. π¨ bestie NO, this is literally the "trust nobody, verify nobody" flag, use it only if you know exactly what you're doing, this is a real security yikes π--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 exportingKUBECTL_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. zero = she waits forever, main character patience β³-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 π₯
# Create a new ExternalName service named my-ns
kubectl create service externalname my-ns --external-name bar.com
look at her go ππ
π 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! π§ (the "hopefully automatically generated since" is sending me, honestly same, nobody wants to hand-write these fr fr)
and that's the whole page bestie β Manuals / User, page KUBERNETES(1)(kubernetes), compiled January 2015 by Eric Paris. slay, bye πβ¨π
π¦ 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