1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl diff - Diff the live version against a would-be applied version
10
14 kubectl diff [OPTIONS]
15
19 Diff configurations specified by file name or stdin between the current
20 online configuration, and the configuration as it would be if applied.
21 The output is always YAML.
24 KUBECTL_EXTERNAL_DIFF environment variable can be used to select your
27 own diff command. Users can use external commands with params too, ex‐
28 ample: KUBECTL_EXTERNAL_DIFF="colordiff -N -u"
29 By default, the "diff" command available in your path will be run with
32 the "-u" (unified diff) and "-N" (treat absent files as empty) options.
33 Exit status: 0 No differences were found. 1 Differences were found. >1
36 Kubectl or diff failed with an error.
37 Note: KUBECTL_EXTERNAL_DIFF, if used, is expected to follow that con‐
40 vention.
41
45 --field-manager="kubectl-client-side-apply" Name of the manager
46 used to track field ownership.
47 -f, --filename=[] Filename, directory, or URL to files contains
50 the configuration to diff
51 --force-conflicts=false If true, server-side apply will force the
54 changes against conflicts.
55 -k, --kustomize="" Process the kustomization directory. This flag
58 can't be used together with -f or -R.
59 --prune=false Include resources that would be deleted by pruning.
62 Can be used with -l and default shows all resources would be pruned
63 --prune-allowlist=[] Overwrite the default whitelist with for
66 --prune
67 -R, --recursive=false Process the directory used in -f, --filename
70 recursively. Useful when you want to manage related manifests organized
71 within the same directory.
72 -l, --selector="" Selector (label query) to filter on, supports
75 '=', '==', and '!='.(e.g. -l key1=value1,key2=value2). Matching objects
76 must satisfy all of the specified label constraints.
77 --server-side=false If true, apply runs in the server instead of
80 the client.
81 --show-managed-fields=false If true, include managed fields in the
84 diff.
85
89 --as="" Username to impersonate for the operation. User could be a
90 regular user or a service account in a namespace.
91 --as-group=[] Group to impersonate for the operation, this flag
94 can be repeated to specify multiple groups.
95 --as-uid="" UID to impersonate for the operation.
98 --azure-container-registry-config="" Path to the file containing
101 Azure container registry configuration information.
102 --cache-dir="/builddir/.kube/cache" Default cache directory
105 --certificate-authority="" Path to a cert file for the certificate
108 authority
109 --client-certificate="" Path to a client certificate file for TLS
112 --client-key="" Path to a client key file for TLS
115 --cluster="" The name of the kubeconfig cluster to use
118 --context="" The name of the kubeconfig context to use
121 --disable-compression=false If true, opt-out of response compres‐
124 sion for all requests to the server
125 --insecure-skip-tls-verify=false If true, the server's certificate
128 will not be checked for validity. This will make your HTTPS connections
129 insecure
130 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
133 quests.
134 --match-server-version=false Require server version to match
137 client version
138 -n, --namespace="" If present, the namespace scope for this CLI
141 request
142 --password="" Password for basic authentication to the API server
145 --profile="none" Name of profile to capture. One of
148 (none|cpu|heap|goroutine|threadcreate|block|mutex)
149 --profile-output="profile.pprof" Name of the file to write the
152 profile to
153 --request-timeout="0" The length of time to wait before giving up
156 on a single server request. Non-zero values should contain a corre‐
157 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
158 out requests.
159 -s, --server="" The address and port of the Kubernetes API server
162 --tls-server-name="" Server name to use for server certificate
165 validation. If it is not provided, the hostname used to contact the
166 server is used
167 --token="" Bearer token for authentication to the API server
170 --user="" The name of the kubeconfig user to use
173 --username="" Username for basic authentication to the API server
176 --version=false Print version information and quit
179 --warnings-as-errors=false Treat warnings received from the server
182 as errors and exit with a non-zero exit code
183
187 # Diff resources included in pod.json
188 kubectl diff -f pod.json
189 # Diff file read from stdin
191 cat service.yaml | kubectl diff -f -
192
197 kubectl(1),
198
202 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
203 com) based on the kubernetes source material, but hopefully they have
204 been automatically generated since!
205Manuals User KUBERNETES(1)(kubernetes)