2018-05-29 17:18:34 +00:00
|
|
|
% podman-import "1"
|
2017-11-02 19:31:49 +00:00
|
|
|
|
|
|
|
## NAME
|
2018-04-26 13:21:11 +00:00
|
|
|
podman\-import - Import a tarball and save it as a filesystem image
|
2017-11-02 19:31:49 +00:00
|
|
|
|
|
|
|
## SYNOPSIS
|
2018-06-29 17:53:33 +00:00
|
|
|
**podman import** [*options*] *path*
|
2017-11-02 19:31:49 +00:00
|
|
|
|
|
|
|
## DESCRIPTION
|
2017-12-15 21:58:36 +00:00
|
|
|
**podman import** imports a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz)
|
2017-11-02 19:31:49 +00:00
|
|
|
and saves it as a filesystem image. Remote tarballs can be specified using a URL.
|
|
|
|
Various image instructions can be configured with the **--change** flag and
|
|
|
|
a commit message can be set using the **--message** flag.
|
2018-04-29 21:37:51 +00:00
|
|
|
Note: `:` is a restricted character and cannot be part of the file name.
|
2017-11-02 19:31:49 +00:00
|
|
|
|
|
|
|
## OPTIONS
|
|
|
|
|
|
|
|
**--change, -c**
|
2018-06-14 15:44:39 +00:00
|
|
|
|
2017-11-02 19:31:49 +00:00
|
|
|
Apply the following possible instructions to the created image:
|
|
|
|
**CMD** | **ENTRYPOINT** | **ENV** | **EXPOSE** | **LABEL** | **STOPSIGNAL** | **USER** | **VOLUME** | **WORKDIR**
|
|
|
|
Can be set multiple times
|
|
|
|
|
|
|
|
**--message, -m**
|
2018-06-14 15:44:39 +00:00
|
|
|
|
2017-11-02 19:31:49 +00:00
|
|
|
Set commit message for imported image
|
|
|
|
|
2018-03-06 16:42:13 +00:00
|
|
|
**--quiet, -q**
|
2018-06-14 15:44:39 +00:00
|
|
|
|
2018-03-06 16:42:13 +00:00
|
|
|
Shows progress on the import
|
|
|
|
|
2018-06-29 17:53:33 +00:00
|
|
|
**-verbose**
|
|
|
|
|
|
|
|
Print additional debugging information
|
|
|
|
|
|
|
|
**--help**, **-h**
|
|
|
|
|
|
|
|
Print usage statement
|
|
|
|
|
2017-11-02 19:31:49 +00:00
|
|
|
## EXAMPLES
|
|
|
|
|
|
|
|
```
|
2017-12-15 21:58:36 +00:00
|
|
|
# podman import --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change LABEL=blue=image ctr.tar image-imported
|
2017-11-02 19:31:49 +00:00
|
|
|
Getting image source signatures
|
|
|
|
Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
|
|
|
|
25.80 MB / 25.80 MB [======================================================] 0s
|
|
|
|
Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd
|
|
|
|
448 B / 448 B [============================================================] 0s
|
|
|
|
Writing manifest to image destination
|
|
|
|
Storing signatures
|
2018-03-06 16:42:13 +00:00
|
|
|
db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
|
2017-11-02 19:31:49 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
```
|
2018-03-06 16:42:13 +00:00
|
|
|
# cat ctr.tar | podman -q import --message "importing the ctr.tar tarball" - image-imported
|
|
|
|
db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
|
2017-11-02 19:31:49 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
```
|
2017-12-15 21:58:36 +00:00
|
|
|
# cat ctr.tar | podman import -
|
2017-11-02 19:31:49 +00:00
|
|
|
Getting image source signatures
|
|
|
|
Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
|
|
|
|
25.80 MB / 25.80 MB [======================================================] 0s
|
|
|
|
Copying config sha256:d61387b4d5edf65edee5353e2340783703074ffeaaac529cde97a8357eea7645
|
|
|
|
378 B / 378 B [============================================================] 0s
|
|
|
|
Writing manifest to image destination
|
|
|
|
Storing signatures
|
2018-03-06 16:42:13 +00:00
|
|
|
db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
|
2017-11-02 19:31:49 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
```
|
2017-12-15 21:58:36 +00:00
|
|
|
podman import http://example.com/ctr.tar url-image
|
2017-11-02 19:31:49 +00:00
|
|
|
Downloading from "http://example.com/ctr.tar"
|
|
|
|
Getting image source signatures
|
|
|
|
Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
|
|
|
|
25.80 MB / 25.80 MB [======================================================] 0s
|
|
|
|
Copying config sha256:5813fe8a3b18696089fd09957a12e88bda43dc1745b5240879ffffe93240d29a
|
|
|
|
419 B / 419 B [============================================================] 0s
|
|
|
|
Writing manifest to image destination
|
|
|
|
Storing signatures
|
2018-03-06 16:42:13 +00:00
|
|
|
db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
|
2017-11-02 19:31:49 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## SEE ALSO
|
2018-03-12 14:00:14 +00:00
|
|
|
podman(1), podman-export(1), crio(8)
|
2017-11-02 19:31:49 +00:00
|
|
|
|
|
|
|
## HISTORY
|
|
|
|
November 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|