1podman-import(1)() podman-import(1)()
2
3
4
6 podman-import - Import a tarball and save it as a filesystem image
7
8
10 podman import [options] path [reference]
11
12
13 podman image import [options] path [reference]
14
15
17 podman import imports a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz,
18 .txz) and saves it as a filesystem image. Remote tarballs can be speci‐
19 fied using a URL. Various image instructions can be configured with
20 the --change flag and a commit message can be set using the --message
21 flag. reference, if present, is a tag to assign to the image. podman
22 import is used for importing from the archive generated by podman ex‐
23 port, that includes the container's filesystem. To import the archive
24 of image layers created by podman save, use podman load. Note: : is a
25 restricted character and cannot be part of the file name.
26
27
29 --arch
30 Set architecture of the imported image.
31
32
33 --change=instruction, -c
34 Apply the following possible instructions to the created image: CMD |
35 ENTRYPOINT | ENV | EXPOSE | LABEL | STOPSIGNAL | USER | VOLUME |
36 WORKDIR
37
38
39 Can be set multiple times
40
41
42 --help, -h
43 Print usage statement
44
45
46 --message, -m=message
47 Set commit message for imported image
48
49
50 --os
51 Set OS of the imported image.
52
53
54 --quiet, -q
55 Shows progress on the import
56
57
58 --variant
59 Set variant of the imported image.
60
61
62 --verbose
63
64
65 Print additional debugging information
66
67
69 $ podman import --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change LABEL=blue=image ctr.tar image-imported
70 Getting image source signatures
71 Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
72 25.80 MB / 25.80 MB [======================================================] 0s
73 Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd
74 448 B / 448 B [============================================================] 0s
75 Writing manifest to image destination
76 Storing signatures
77 db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
78
79
80
81 $ podman import --change 'ENTRYPOINT ["/bin/sh","-c","test-image"]' --change LABEL=blue=image test-image.tar image-imported
82 Getting image source signatures
83 Copying blob e3b0c44298fc skipped: already exists
84 Copying config 1105523502 done
85 Writing manifest to image destination
86 Storing signatures
87 110552350206337183ceadc0bdd646dc356e06514c548b69a8917b4182414b
88
89
90
91 $ podman import --change "CMD /bin/sh" --change LABEL=blue=image test-image.tar image-imported
92 Getting image source signatures
93 Copying blob e3b0c44298fc skipped: already exists
94 Copying config ae9a27e249 done
95 Writing manifest to image destination
96 Storing signatures
97 ae9a27e249f801aff11a4ba54a81751ea9fbc9db45a6df3f1bfd63fc2437bb9c
98
99
100
101 $ cat ctr.tar | podman -q import --message "importing the ctr.tar tarball" - image-imported
102 db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
103
104
105
106 $ cat ctr.tar | podman import -
107 Getting image source signatures
108 Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
109 25.80 MB / 25.80 MB [======================================================] 0s
110 Copying config sha256:d61387b4d5edf65edee5353e2340783703074ffeaaac529cde97a8357eea7645
111 378 B / 378 B [============================================================] 0s
112 Writing manifest to image destination
113 Storing signatures
114 db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
115
116
117
118 $ podman import http://example.com/ctr.tar url-image
119 Downloading from "http://example.com/ctr.tar"
120 Getting image source signatures
121 Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
122 25.80 MB / 25.80 MB [======================================================] 0s
123 Copying config sha256:5813fe8a3b18696089fd09957a12e88bda43dc1745b5240879ffffe93240d29a
124 419 B / 419 B [============================================================] 0s
125 Writing manifest to image destination
126 Storing signatures
127 db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
128
129
130
132 podman(1), podman-export(1)
133
134
136 November 2017, Originally compiled by Urvashi Mohnani umohnani@red‐
137 hat.com ⟨mailto:umohnani@redhat.com⟩
138
139
140
141 podman-import(1)()