1OC ADM MIGRATE(1)                  June 2016                 OC ADM MIGRATE(1)
2
3
4

NAME

6       oc  adm  migrate template-instances - Update TemplateInstances to point
7       to the latest group-version-kinds
8
9
10

SYNOPSIS

12       oc adm migrate template-instances [OPTIONS]
13
14
15

DESCRIPTION

17       Migrate Template Instances to refer to new API groups
18
19
20       This command locates and updates every Template Instance  which  refers
21       to  a  particular group-version-kind to refer to some other, equivalent
22       group-version-kind.
23
24
25       The following transformations will occur:
26
27              · .Build --> build.openshift.io/v1.Build
28
29              · .BuildConfig --> build.openshift.io/v1.BuildConfig
30
31              · .DeploymentConfig --> apps.openshift.io/v1.DeploymentConfig
32
33              · .Route --> route.openshift.io/v1.Route
34
35              · v1.Build --> build.openshift.io/v1.Build
36
37              · v1.BuildConfig --> build.openshift.io/v1.BuildConfig
38
39              · v1.DeploymentConfig --> apps.openshift.io/v1.DeploymentConfig
40
41              · v1.Route --> route.openshift.io/v1.Route
42
43

OPTIONS

45       --all-namespaces=true
46           Migrate objects in all namespaces. Defaults to true.
47
48
49       --allow-missing-template-keys=true
50           If true, ignore any errors in templates when a field or map key  is
51       missing  in  the  template.  Only applies to golang and jsonpath output
52       formats.
53
54
55       --confirm=false
56           If true, all requested objects will be migrated. Defaults to false.
57
58
59       -f, --filename=[]
60           Filename, directory, or URL to docker-compose.yml file to use
61
62
63       --from-key=""
64           If specified, only migrate items  with  a  key  (namespace/name  or
65       name) greater than or equal to this value
66
67
68       --include=[templateinstance]
69           Resource  types  to  migrate. Passing --filename will override this
70       flag.
71
72
73       --no-headers=false
74           When using the default or custom-column output format, don't  print
75       headers (default print headers).
76
77
78       -o, --output=""
79           Output  format. One of: json|yaml|wide|name|custom-columns=...|cus‐
80       tom-columns-file=...|go-template=...|go-template-file=...|json‐
81       path=...|jsonpath-file=...   See   custom   columns   [  ⟨http://kuber
82       netes.io/docs/user-guide/kubectl-overview/#custom-columns⟩],     golang
83       template   [  ⟨http://golang.org/pkg/text/template/#pkg-overview⟩]  and
84       jsonpath template [ ⟨http://kubernetes.io/docs/user-guide/jsonpath⟩].
85
86
87       --show-labels=false
88           When printing, show all labels as the  last  column  (default  hide
89       labels column)
90
91
92       --sort-by=""
93           If  non-empty, sort list types using this field specification.  The
94       field  specification  is  expressed  as  a  JSONPath  expression  (e.g.
95       '{.metadata.name}').  The  field  in the API resource specified by this
96       JSONPath expression must be an integer or a string.
97
98
99       --template=""
100           Template string or path to template file  to  use  when  -o=go-tem‐
101       plate,  -o=go-template-file.  The template format is golang templates [
102http://golang.org/pkg/text/template/#pkg-overview⟩].
103
104
105       --to-key=""
106           If specified, only migrate items  with  a  key  (namespace/name  or
107       name) less than this value
108
109
110

OPTIONS INHERITED FROM PARENT COMMANDS

112       --allow_verification_with_non_compliant_keys=false
113           Allow  a  SignatureVerifier  to  use  keys  which  are  technically
114       non-compliant with RFC6962.
115
116
117       --alsologtostderr=false
118           log to standard error as well as files
119
120
121       --application_metrics_count_limit=100
122           Max number of application metrics to store (per container)
123
124
125       --as=""
126           Username to impersonate for the operation
127
128
129       --as-group=[]
130           Group to impersonate for the operation, this flag can  be  repeated
131       to specify multiple groups.
132
133
134       --azure-container-registry-config=""
135           Path  to the file containing Azure container registry configuration
136       information.
137
138
139       --boot_id_file="/proc/sys/kernel/random/boot_id"
140           Comma-separated list of files to check for boot-id. Use  the  first
141       one that exists.
142
143
144       --cache-dir="/builddir/.kube/http-cache"
145           Default HTTP cache directory
146
147
148       --certificate-authority=""
149           Path to a cert file for the certificate authority
150
151
152       --client-certificate=""
153           Path to a client certificate file for TLS
154
155
156       --client-key=""
157           Path to a client key file for TLS
158
159
160       --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
161           CIDRs opened in GCE firewall for LB traffic proxy  health checks
162
163
164       --cluster=""
165           The name of the kubeconfig cluster to use
166
167
168       --container_hints="/etc/cadvisor/container_hints.json"
169           location of the container hints file
170
171
172       --containerd="unix:///var/run/containerd.sock"
173           containerd endpoint
174
175
176       --context=""
177           The name of the kubeconfig context to use
178
179
180       --default-not-ready-toleration-seconds=300
181           Indicates   the   tolerationSeconds   of   the    toleration    for
182       notReady:NoExecute  that is added by default to every pod that does not
183       already have such a toleration.
184
185
186       --default-unreachable-toleration-seconds=300
187           Indicates the tolerationSeconds  of  the  toleration  for  unreach‐
188       able:NoExecute  that  is  added  by  default to every pod that does not
189       already have such a toleration.
190
191
192       --docker="unix:///var/run/docker.sock"
193           docker endpoint
194
195
196       --docker-tls=false
197           use TLS to connect to docker
198
199
200       --docker-tls-ca="ca.pem"
201           path to trusted CA
202
203
204       --docker-tls-cert="cert.pem"
205           path to client certificate
206
207
208       --docker-tls-key="key.pem"
209           path to private key
210
211
212       --docker_env_metadata_whitelist=""
213           a comma-separated list of environment variable keys that  needs  to
214       be collected for docker containers
215
216
217       --docker_only=false
218           Only report docker containers in addition to root stats
219
220
221       --docker_root="/var/lib/docker"
222           DEPRECATED:  docker  root is read from docker info (this is a fall‐
223       back, default: /var/lib/docker)
224
225
226       --enable_load_reader=false
227           Whether to enable cpu load reader
228
229
230       --event_storage_age_limit="default=24h"
231           Max length of time for which to store events (per type). Value is a
232       comma  separated  list  of  key  values, where the keys are event types
233       (e.g.: creation, oom) or "default" and the value is a duration. Default
234       is applied to all non-specified event types
235
236
237       --event_storage_event_limit="default=100000"
238           Max  number  of  events to store (per type). Value is a comma sepa‐
239       rated list of key values, where the keys are event  types  (e.g.:  cre‐
240       ation,  oom)  or  "default"  and  the  value  is an integer. Default is
241       applied to all non-specified event types
242
243
244       --global_housekeeping_interval=0
245           Interval between global housekeepings
246
247
248       --housekeeping_interval=0
249           Interval between container housekeepings
250
251
252       --insecure-skip-tls-verify=false
253           If true, the server's certificate will not be checked for validity.
254       This will make your HTTPS connections insecure
255
256
257       --kubeconfig=""
258           Path to the kubeconfig file to use for CLI requests.
259
260
261       --log-flush-frequency=0
262           Maximum number of seconds between log flushes
263
264
265       --log_backtrace_at=:0
266           when logging hits line file:N, emit a stack trace
267
268
269       --log_cadvisor_usage=false
270           Whether to log the usage of the cAdvisor container
271
272
273       --log_dir=""
274           If non-empty, write log files in this directory
275
276
277       --logtostderr=true
278           log to standard error instead of files
279
280
281       --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
282           Comma-separated  list  of  files  to  check for machine-id. Use the
283       first one that exists.
284
285
286       --match-server-version=false
287           Require server version to match client version
288
289
290       -n, --namespace=""
291           If present, the namespace scope for this CLI request
292
293
294       --request-timeout="0"
295           The length of time to wait before giving  up  on  a  single  server
296       request. Non-zero values should contain a corresponding time unit (e.g.
297       1s, 2m, 3h). A value of zero means don't timeout requests.
298
299
300       -s, --server=""
301           The address and port of the Kubernetes API server
302
303
304       --stderrthreshold=2
305           logs at or above this threshold go to stderr
306
307
308       --storage_driver_buffer_duration=0
309           Writes in the storage driver will be buffered  for  this  duration,
310       and committed to the non memory backends as a single transaction
311
312
313       --storage_driver_db="cadvisor"
314           database name
315
316
317       --storage_driver_host="localhost:8086"
318           database host:port
319
320
321       --storage_driver_password="root"
322           database password
323
324
325       --storage_driver_secure=false
326           use secure connection with database
327
328
329       --storage_driver_table="stats"
330           table name
331
332
333       --storage_driver_user="root"
334           database username
335
336
337       --token=""
338           Bearer token for authentication to the API server
339
340
341       --user=""
342           The name of the kubeconfig user to use
343
344
345       -v, --v=0
346           log level for V logs
347
348
349       --version=false
350           Print version information and quit
351
352
353       --vmodule=
354           comma-separated  list  of pattern=N settings for file-filtered log‐
355       ging
356
357
358

EXAMPLE

360                # Perform a dry-run of updating all objects
361                oc adm migrate template-instances
362
363                # To actually perform the update, the confirm flag must be appended
364                oc adm migrate template-instances --confirm
365
366
367
368

SEE ALSO

370       oc-adm-migrate(1),
371
372
373

HISTORY

375       June 2016, Ported from the Kubernetes man-doc generator
376
377
378
379Openshift                  Openshift CLI User Manuals        OC ADM MIGRATE(1)
Impressum