1OC ADM MIGRATE(1) June 2016 OC ADM MIGRATE(1)
2
6 oc adm migrate storage - Update the stored version of API objects
7
11 oc adm migrate storage [OPTIONS]
12
16 Migrate internal object storage via update
17 This command invokes an update operation on every API object reachable
20 by the caller. This forces the server to write to the underlying stor‐
21 age if the object representation has changed. Use this command to
22 ensure that the most recent storage changes have been applied to all
23 objects (storage version, storage encoding, any newer object defaults).
24 To operate on a subset of resources, use the --include flag. If you
27 encounter errors during a run the command will output a list of
28 resources that received errors, which you can then re-run the command
29 on. You may also specify --from-key and --to-key to restrict the set of
30 resource names to operate on (key is NAMESPACE/NAME for resources in
31 namespaces or NAME for cluster scoped resources). --from-key is inclu‐
32 sive if specified, while --to-key is exclusive.
33 By default, events are not migrated since they expire within a very
36 short period of time. If you have significantly increased the expira‐
37 tion time of events, run a migration with --include=events
38 WARNING: This is a slow command and will put significant load on an API
41 server. It may also result in significant intra-cluster traffic.
42
46 --all-namespaces=true
47 Migrate objects in all namespaces. Defaults to true.
48 --allow-missing-template-keys=true
51 If true, ignore any errors in templates when a field or map key is
52 missing in the template. Only applies to golang and jsonpath output
53 formats.
54 --bandwidth=10
57 Average network bandwidth measured in megabits per second (Mbps) to
58 use during storage migration. Zero means no limit. This flag is alpha
59 and may change in the future.
60 -f, --filename=[]
63 Filename, directory, or URL to docker-compose.yml file to use
64 --from-key=""
67 If specified, only migrate items with a key (namespace/name or
68 name) greater than or equal to this value
69 --include=[*]
72 Resource types to migrate. Passing --filename will override this
73 flag.
74 --no-headers=false
77 When using the default or custom-column output format, don't print
78 headers (default print headers).
79 --show-labels=false
82 When printing, show all labels as the last column (default hide
83 labels column)
84 --sort-by=""
87 If non-empty, sort list types using this field specification. The
88 field specification is expressed as a JSONPath expression (e.g.
89 '{.metadata.name}'). The field in the API resource specified by this
90 JSONPath expression must be an integer or a string.
91 --template=""
94 Template string or path to template file to use when -o=go-tem‐
95 plate, -o=go-template-file. The template format is golang templates [
96 ⟨http://golang.org/pkg/text/template/#pkg-overview⟩].
97 --to-key=""
100 If specified, only migrate items with a key (namespace/name or
101 name) less than this value
102
106 --allow_verification_with_non_compliant_keys=false
107 Allow a SignatureVerifier to use keys which are technically
108 non-compliant with RFC6962.
109 --alsologtostderr=false
112 log to standard error as well as files
113 --application_metrics_count_limit=100
116 Max number of application metrics to store (per container)
117 --as=""
120 Username to impersonate for the operation
121 --as-group=[]
124 Group to impersonate for the operation, this flag can be repeated
125 to specify multiple groups.
126 --azure-container-registry-config=""
129 Path to the file containing Azure container registry configuration
130 information.
131 --boot_id_file="/proc/sys/kernel/random/boot_id"
134 Comma-separated list of files to check for boot-id. Use the first
135 one that exists.
136 --cache-dir="/builddir/.kube/http-cache"
139 Default HTTP cache directory
140 --certificate-authority=""
143 Path to a cert file for the certificate authority
144 --client-certificate=""
147 Path to a client certificate file for TLS
148 --client-key=""
151 Path to a client key file for TLS
152 --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
155 CIDRs opened in GCE firewall for LB traffic proxy health checks
156 --cluster=""
159 The name of the kubeconfig cluster to use
160 --container_hints="/etc/cadvisor/container_hints.json"
163 location of the container hints file
164 --containerd="unix:///var/run/containerd.sock"
167 containerd endpoint
168 --context=""
171 The name of the kubeconfig context to use
172 --default-not-ready-toleration-seconds=300
175 Indicates the tolerationSeconds of the toleration for
176 notReady:NoExecute that is added by default to every pod that does not
177 already have such a toleration.
178 --default-unreachable-toleration-seconds=300
181 Indicates the tolerationSeconds of the toleration for unreach‐
182 able:NoExecute that is added by default to every pod that does not
183 already have such a toleration.
184 --docker="unix:///var/run/docker.sock"
187 docker endpoint
188 --docker-tls=false
191 use TLS to connect to docker
192 --docker-tls-ca="ca.pem"
195 path to trusted CA
196 --docker-tls-cert="cert.pem"
199 path to client certificate
200 --docker-tls-key="key.pem"
203 path to private key
204 --docker_env_metadata_whitelist=""
207 a comma-separated list of environment variable keys that needs to
208 be collected for docker containers
209 --docker_only=false
212 Only report docker containers in addition to root stats
213 --docker_root="/var/lib/docker"
216 DEPRECATED: docker root is read from docker info (this is a fall‐
217 back, default: /var/lib/docker)
218 --enable_load_reader=false
221 Whether to enable cpu load reader
222 --event_storage_age_limit="default=24h"
225 Max length of time for which to store events (per type). Value is a
226 comma separated list of key values, where the keys are event types
227 (e.g.: creation, oom) or "default" and the value is a duration. Default
228 is applied to all non-specified event types
229 --event_storage_event_limit="default=100000"
232 Max number of events to store (per type). Value is a comma sepa‐
233 rated list of key values, where the keys are event types (e.g.: cre‐
234 ation, oom) or "default" and the value is an integer. Default is
235 applied to all non-specified event types
236 --global_housekeeping_interval=0
239 Interval between global housekeepings
240 --housekeeping_interval=0
243 Interval between container housekeepings
244 --insecure-skip-tls-verify=false
247 If true, the server's certificate will not be checked for validity.
248 This will make your HTTPS connections insecure
249 --kubeconfig=""
252 Path to the kubeconfig file to use for CLI requests.
253 --log-flush-frequency=0
256 Maximum number of seconds between log flushes
257 --log_backtrace_at=:0
260 when logging hits line file:N, emit a stack trace
261 --log_cadvisor_usage=false
264 Whether to log the usage of the cAdvisor container
265 --log_dir=""
268 If non-empty, write log files in this directory
269 --logtostderr=true
272 log to standard error instead of files
273 --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
276 Comma-separated list of files to check for machine-id. Use the
277 first one that exists.
278 --match-server-version=false
281 Require server version to match client version
282 -n, --namespace=""
285 If present, the namespace scope for this CLI request
286 --request-timeout="0"
289 The length of time to wait before giving up on a single server
290 request. Non-zero values should contain a corresponding time unit (e.g.
291 1s, 2m, 3h). A value of zero means don't timeout requests.
292 -s, --server=""
295 The address and port of the Kubernetes API server
296 --stderrthreshold=2
299 logs at or above this threshold go to stderr
300 --storage_driver_buffer_duration=0
303 Writes in the storage driver will be buffered for this duration,
304 and committed to the non memory backends as a single transaction
305 --storage_driver_db="cadvisor"
308 database name
309 --storage_driver_host="localhost:8086"
312 database host:port
313 --storage_driver_password="root"
316 database password
317 --storage_driver_secure=false
320 use secure connection with database
321 --storage_driver_table="stats"
324 table name
325 --storage_driver_user="root"
328 database username
329 --token=""
332 Bearer token for authentication to the API server
333 --user=""
336 The name of the kubeconfig user to use
337 -v, --v=0
340 log level for V logs
341 --version=false
344 Print version information and quit
345 --vmodule=
348 comma-separated list of pattern=N settings for file-filtered log‐
349 ging
350
354 # Perform an update of all objects
355 oc adm migrate storage
356 # Only migrate pods
358 oc adm migrate storage --include=pods
359 # Only pods that are in namespaces starting with "bar"
361 oc adm migrate storage --include=pods --from-key=bar/ --to-key=bar/\xFF
362
367 oc-adm-migrate(1),
368
372 June 2016, Ported from the Kubernetes man-doc generator
373Openshift Openshift CLI User Manuals OC ADM MIGRATE(1)