1OC ADM MIGRATE(1) June 2016 OC ADM MIGRATE(1)
2
6 oc adm migrate template-instances - Update TemplateInstances to point
7 to the latest group-version-kinds
8
12 oc adm migrate template-instances [OPTIONS]
13
17 Migrate Template Instances to refer to new API groups
18 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 The following transformations will occur:
26 · .Build --> build.openshift.io/v1.Build
28 · .BuildConfig --> build.openshift.io/v1.BuildConfig
30 · .DeploymentConfig --> apps.openshift.io/v1.DeploymentConfig
32 · .Route --> route.openshift.io/v1.Route
34 · v1.Build --> build.openshift.io/v1.Build
36 · v1.BuildConfig --> build.openshift.io/v1.BuildConfig
38 · v1.DeploymentConfig --> apps.openshift.io/v1.DeploymentConfig
40 · v1.Route --> route.openshift.io/v1.Route
42
45 --all-namespaces=true
46 Migrate objects in all namespaces. Defaults to true.
47 --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 --confirm=false
56 If true, all requested objects will be migrated. Defaults to false.
57 -f, --filename=[]
60 Filename, directory, or URL to docker-compose.yml file to use
61 --from-key=""
64 If specified, only migrate items with a key (namespace/name or
65 name) greater than or equal to this value
66 --include=[templateinstance]
69 Resource types to migrate. Passing --filename will override this
70 flag.
71 --no-headers=false
74 When using the default or custom-column output format, don't print
75 headers (default print headers).
76 -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 --show-labels=false
88 When printing, show all labels as the last column (default hide
89 labels column)
90 --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 --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 [
102 ⟨http://golang.org/pkg/text/template/#pkg-overview⟩].
103 --to-key=""
106 If specified, only migrate items with a key (namespace/name or
107 name) less than this value
108
112 --allow_verification_with_non_compliant_keys=false
113 Allow a SignatureVerifier to use keys which are technically
114 non-compliant with RFC6962.
115 --alsologtostderr=false
118 log to standard error as well as files
119 --application_metrics_count_limit=100
122 Max number of application metrics to store (per container)
123 --as=""
126 Username to impersonate for the operation
127 --as-group=[]
130 Group to impersonate for the operation, this flag can be repeated
131 to specify multiple groups.
132 --azure-container-registry-config=""
135 Path to the file containing Azure container registry configuration
136 information.
137 --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 --cache-dir="/builddir/.kube/http-cache"
145 Default HTTP cache directory
146 --certificate-authority=""
149 Path to a cert file for the certificate authority
150 --client-certificate=""
153 Path to a client certificate file for TLS
154 --client-key=""
157 Path to a client key file for TLS
158 --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 --cluster=""
165 The name of the kubeconfig cluster to use
166 --container_hints="/etc/cadvisor/container_hints.json"
169 location of the container hints file
170 --containerd="unix:///var/run/containerd.sock"
173 containerd endpoint
174 --context=""
177 The name of the kubeconfig context to use
178 --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 --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 --docker="unix:///var/run/docker.sock"
193 docker endpoint
194 --docker-tls=false
197 use TLS to connect to docker
198 --docker-tls-ca="ca.pem"
201 path to trusted CA
202 --docker-tls-cert="cert.pem"
205 path to client certificate
206 --docker-tls-key="key.pem"
209 path to private key
210 --docker_env_metadata_whitelist=""
213 a comma-separated list of environment variable keys that needs to
214 be collected for docker containers
215 --docker_only=false
218 Only report docker containers in addition to root stats
219 --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 --enable_load_reader=false
227 Whether to enable cpu load reader
228 --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 --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 --global_housekeeping_interval=0
245 Interval between global housekeepings
246 --housekeeping_interval=0
249 Interval between container housekeepings
250 --httptest.serve=""
253 if non-empty, httptest.NewServer serves on this address and blocks
254 --insecure-skip-tls-verify=false
257 If true, the server's certificate will not be checked for validity.
258 This will make your HTTPS connections insecure
259 --kubeconfig=""
262 Path to the kubeconfig file to use for CLI requests.
263 --log-flush-frequency=0
266 Maximum number of seconds between log flushes
267 --log_backtrace_at=:0
270 when logging hits line file:N, emit a stack trace
271 --log_cadvisor_usage=false
274 Whether to log the usage of the cAdvisor container
275 --log_dir=""
278 If non-empty, write log files in this directory
279 --logtostderr=true
282 log to standard error instead of files
283 --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
286 Comma-separated list of files to check for machine-id. Use the
287 first one that exists.
288 --match-server-version=false
291 Require server version to match client version
292 -n, --namespace=""
295 If present, the namespace scope for this CLI request
296 --request-timeout="0"
299 The length of time to wait before giving up on a single server
300 request. Non-zero values should contain a corresponding time unit (e.g.
301 1s, 2m, 3h). A value of zero means don't timeout requests.
302 -s, --server=""
305 The address and port of the Kubernetes API server
306 --stderrthreshold=2
309 logs at or above this threshold go to stderr
310 --storage_driver_buffer_duration=0
313 Writes in the storage driver will be buffered for this duration,
314 and committed to the non memory backends as a single transaction
315 --storage_driver_db="cadvisor"
318 database name
319 --storage_driver_host="localhost:8086"
322 database host:port
323 --storage_driver_password="root"
326 database password
327 --storage_driver_secure=false
330 use secure connection with database
331 --storage_driver_table="stats"
334 table name
335 --storage_driver_user="root"
338 database username
339 --token=""
342 Bearer token for authentication to the API server
343 --user=""
346 The name of the kubeconfig user to use
347 -v, --v=0
350 log level for V logs
351 --version=false
354 Print version information and quit
355 --vmodule=
358 comma-separated list of pattern=N settings for file-filtered log‐
359 ging
360
364 # Perform a dry-run of updating all objects
365 oc adm migrate template-instances
366 # To actually perform the update, the confirm flag must be appended
368 oc adm migrate template-instances --confirm
369
374 oc-adm-migrate(1),
375
379 June 2016, Ported from the Kubernetes man-doc generator
380Openshift Openshift CLI User Manuals OC ADM MIGRATE(1)