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

NAME

6       oc import-image - Imports images from a Docker registry
7
8
9

SYNOPSIS

11       oc import-image [OPTIONS]
12
13
14

DESCRIPTION

16       Import the latest image information from a tag in a Docker registry
17
18
19       Image  streams allow you to control which images are rolled out to your
20       builds and applications. This command fetches the latest version of  an
21       image  from  a remote repository and updates the image stream tag if it
22       does not match the previous value. Running the command  multiple  times
23       will  not  create  duplicate entries. When importing an image, only the
24       image metadata is copied, not the image contents.
25
26
27       If you wish to change the image stream tag or provide more advanced op‐
28       tions, see the 'tag' command.
29
30
31

OPTIONS

33       --all=false
34           If true, import all tags from the provided source on creation or if
35       --from is specified
36
37
38       --allow-missing-template-keys=true
39           If true, ignore any errors in templates when a field or map key  is
40       missing  in  the  template.  Only applies to golang and jsonpath output
41       formats.
42
43
44       --confirm=false
45           If true, allow the image  stream  import  location  to  be  set  or
46       changed
47
48
49       --dry-run=false
50           Fetch  information about images without creating or updating an im‐
51       age stream.
52
53
54       --from=""
55           A Docker image repository to import images from
56
57
58       --insecure=false
59           If true, allow importing from registries that  have  invalid  HTTPS
60       certificates  or  are  hosted  via HTTP. This flag will take precedence
61       over the insecure annotation.
62
63
64       -o, --output=""
65           Output   format.   One    of:    json|yaml|name|go-template|go-tem‐
66       plate-file|templatefile|template|jsonpath|jsonpath-file.
67
68
69       --reference-policy="source"
70           Allow  to  request  pullthrough for external image when set to 'lo‐
71       cal'. Defaults to 'source'.
72
73
74       --scheduled=false
75           Set each imported Docker image to be periodically imported  from  a
76       remote repository. Defaults to false.
77
78
79       --template=""
80           Template  string  or  path  to template file to use when -o=go-tem‐
81       plate, -o=go-template-file. The template format is golang  templates  [
82http://golang.org/pkg/text/template/#pkg-overview⟩].
83
84
85

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

335                oc import-image mystream
336
337
338
339

SEE ALSO

341       oc(1),
342
343
344

HISTORY

346       June 2016, Ported from the Kubernetes man-doc generator
347
348
349
350Openshift                  Openshift CLI User Manuals                    OC(1)
Impressum