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 --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 --kubeconfig=""
258 Path to the kubeconfig file to use for CLI requests.
259 --log-flush-frequency=0
262 Maximum number of seconds between log flushes
263 --log_backtrace_at=:0
266 when logging hits line file:N, emit a stack trace
267 --log_cadvisor_usage=false
270 Whether to log the usage of the cAdvisor container
271 --log_dir=""
274 If non-empty, write log files in this directory
275 --logtostderr=true
278 log to standard error instead of files
279 --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 --match-server-version=false
287 Require server version to match client version
288 -n, --namespace=""
291 If present, the namespace scope for this CLI request
292 --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 -s, --server=""
301 The address and port of the Kubernetes API server
302 --stderrthreshold=2
305 logs at or above this threshold go to stderr
306 --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 --storage_driver_db="cadvisor"
314 database name
315 --storage_driver_host="localhost:8086"
318 database host:port
319 --storage_driver_password="root"
322 database password
323 --storage_driver_secure=false
326 use secure connection with database
327 --storage_driver_table="stats"
330 table name
331 --storage_driver_user="root"
334 database username
335 --token=""
338 Bearer token for authentication to the API server
339 --user=""
342 The name of the kubeconfig user to use
343 -v, --v=0
346 log level for V logs
347 --version=false
350 Print version information and quit
351 --vmodule=
354 comma-separated list of pattern=N settings for file-filtered log‐
355 ging
356
360 # Perform a dry-run of updating all objects
361 oc adm migrate template-instances
362 # To actually perform the update, the confirm flag must be appended
364 oc adm migrate template-instances --confirm
365
370 oc-adm-migrate(1),
371
375 June 2016, Ported from the Kubernetes man-doc generator
376Openshift Openshift CLI User Manuals OC ADM MIGRATE(1)