1KUBERNETES(1)                      Jan 2015                      KUBERNETES(1)
2
3
4

NAME

6       kubectl alpha diff - Diff different versions of configurations
7
8
9

SYNOPSIS

11       kubectl alpha diff [OPTIONS]
12
13
14

DESCRIPTION

16       Diff configurations specified by filename or stdin between their local,
17       last-applied, live and/or "merged" versions.
18
19
20       LOCAL and LIVE versions are diffed by default. Other available keywords
21       are MERGED and LAST.
22
23
24       Output is always YAML.
25
26
27       KUBERNETES  EXTERNAL  DIFF  environment  variable can be used to select
28       your own diff command. By default, the "diff" command available in your
29       path  will  be  run  with  "-u"  (unicode) and "-N" (treat new files as
30       empty) options.
31
32
33

OPTIONS

35       -f, --filename=[]
36           Filename, directory, or URL to files contains the configuration  to
37       diff
38
39
40       -R, --recursive=false
41           Process  the  directory  used in -f, --filename recursively. Useful
42       when you want to manage related manifests  organized  within  the  same
43       directory.
44
45
46

OPTIONS INHERITED FROM PARENT COMMANDS

48       --allow-verification-with-non-compliant-keys=false
49           Allow  a  SignatureVerifier  to  use  keys  which  are  technically
50       non-compliant with RFC6962.
51
52
53       --alsologtostderr=false
54           log to standard error as well as files
55
56
57       --application-metrics-count-limit=100
58           Max number of application metrics to store (per container)
59
60
61       --as=""
62           Username to impersonate for the operation
63
64
65       --as-group=[]
66           Group to impersonate for the operation, this flag can  be  repeated
67       to specify multiple groups.
68
69
70       --azure-container-registry-config=""
71           Path  to the file containing Azure container registry configuration
72       information.
73
74
75       --boot-id-file="/proc/sys/kernel/random/boot_id"
76           Comma-separated list of files to check for boot-id. Use  the  first
77       one that exists.
78
79
80       --cache-dir="/builddir/.kube/http-cache"
81           Default HTTP cache directory
82
83
84       --certificate-authority=""
85           Path to a cert file for the certificate authority
86
87
88       --client-certificate=""
89           Path to a client certificate file for TLS
90
91
92       --client-key=""
93           Path to a client key file for TLS
94
95
96       --cloud-provider-gce-lb-src-cidrs=130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16
97           CIDRs opened in GCE firewall for LB traffic proxy  health checks
98
99
100       --cluster=""
101           The name of the kubeconfig cluster to use
102
103
104       --container-hints="/etc/cadvisor/container_hints.json"
105           location of the container hints file
106
107
108       --containerd="unix:///var/run/containerd.sock"
109           containerd endpoint
110
111
112       --context=""
113           The name of the kubeconfig context to use
114
115
116       --default-not-ready-toleration-seconds=300
117           Indicates   the   tolerationSeconds   of   the    toleration    for
118       notReady:NoExecute  that is added by default to every pod that does not
119       already have such a toleration.
120
121
122       --default-unreachable-toleration-seconds=300
123           Indicates the tolerationSeconds  of  the  toleration  for  unreach‐
124       able:NoExecute  that  is  added  by  default to every pod that does not
125       already have such a toleration.
126
127
128       --docker="unix:///var/run/docker.sock"
129           docker endpoint
130
131
132       --docker-env-metadata-whitelist=""
133           a comma-separated list of environment variable keys that  needs  to
134       be collected for docker containers
135
136
137       --docker-only=false
138           Only report docker containers in addition to root stats
139
140
141       --docker-root="/var/lib/docker"
142           DEPRECATED:  docker  root is read from docker info (this is a fall‐
143       back, default: /var/lib/docker)
144
145
146       --docker-tls=false
147           use TLS to connect to docker
148
149
150       --docker-tls-ca="ca.pem"
151           path to trusted CA
152
153
154       --docker-tls-cert="cert.pem"
155           path to client certificate
156
157
158       --docker-tls-key="key.pem"
159           path to private key
160
161
162       --enable-load-reader=false
163           Whether to enable cpu load reader
164
165
166       --event-storage-age-limit="default=0"
167           Max length of time for which to store events (per type). Value is a
168       comma  separated  list  of  key  values, where the keys are event types
169       (e.g.: creation, oom) or "default" and the value is a duration. Default
170       is applied to all non-specified event types
171
172
173       --event-storage-event-limit="default=0"
174           Max  number  of  events to store (per type). Value is a comma sepa‐
175       rated list of key values, where the keys are event  types  (e.g.:  cre‐
176       ation,  oom)  or  "default"  and  the  value  is an integer. Default is
177       applied to all non-specified event types
178
179
180       --global-housekeeping-interval=1m0s
181           Interval between global housekeepings
182
183
184       --google-json-key=""
185           The Google Cloud Platform Service  Account  JSON  Key  to  use  for
186       authentication.
187
188
189       --housekeeping-interval=10s
190           Interval between container housekeepings
191
192
193       --insecure-skip-tls-verify=false
194           If true, the server's certificate will not be checked for validity.
195       This will make your HTTPS connections insecure
196
197
198       --kubeconfig=""
199           Path to the kubeconfig file to use for CLI requests.
200
201
202       --log-backtrace-at=:0
203           when logging hits line file:N, emit a stack trace
204
205
206       --log-cadvisor-usage=false
207           Whether to log the usage of the cAdvisor container
208
209
210       --log-dir=""
211           If non-empty, write log files in this directory
212
213
214       --log-flush-frequency=5s
215           Maximum number of seconds between log flushes
216
217
218       --logtostderr=true
219           log to standard error instead of files
220
221
222       --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
223           Comma-separated list of files to  check  for  machine-id.  Use  the
224       first one that exists.
225
226
227       --match-server-version=false
228           Require server version to match client version
229
230
231       --mesos-agent="127.0.0.1:5051"
232           Mesos agent address
233
234
235       --mesos-agent-timeout=10s
236           Mesos agent timeout
237
238
239       -n, --namespace=""
240           If present, the namespace scope for this CLI request
241
242
243       --request-timeout="0"
244           The  length  of  time  to  wait before giving up on a single server
245       request. Non-zero values should contain a corresponding time unit (e.g.
246       1s, 2m, 3h). A value of zero means don't timeout requests.
247
248
249       -s, --server=""
250           The address and port of the Kubernetes API server
251
252
253       --stderrthreshold=2
254           logs at or above this threshold go to stderr
255
256
257       --storage-driver-buffer-duration=1m0s
258           Writes  in  the  storage driver will be buffered for this duration,
259       and committed to the non memory backends as a single transaction
260
261
262       --storage-driver-db="cadvisor"
263           database name
264
265
266       --storage-driver-host="localhost:8086"
267           database host:port
268
269
270       --storage-driver-password="root"
271           database password
272
273
274       --storage-driver-secure=false
275           use secure connection with database
276
277
278       --storage-driver-table="stats"
279           table name
280
281
282       --storage-driver-user="root"
283           database username
284
285
286       --token=""
287           Bearer token for authentication to the API server
288
289
290       --user=""
291           The name of the kubeconfig user to use
292
293
294       -v, --v=0
295           log level for V logs
296
297
298       --version=false
299           Print version information and quit
300
301
302       --vmodule=
303           comma-separated list of pattern=N settings for  file-filtered  log‐
304       ging
305
306
307

EXAMPLE

309                # Diff resources included in pod.json. By default, it will diff LOCAL and LIVE versions
310                kubectl alpha diff -f pod.json
311
312                # When one version is specified, diff that version against LIVE
313                cat service.yaml | kubectl alpha diff -f - MERGED
314
315                # Or specify both versions
316                kubectl alpha diff -f pod.json -f service.yaml LAST LOCAL
317
318
319
320

SEE ALSO

322       kubectl-alpha(1),
323
324
325

HISTORY

327       January  2015,  Originally compiled by Eric Paris (eparis at redhat dot
328       com) based on the kubernetes source material, but hopefully  they  have
329       been automatically generated since!
330
331
332
333Eric Paris                  kubernetes User Manuals              KUBERNETES(1)
Impressum