120 lines
4.3 KiB
Groff
120 lines
4.3 KiB
Groff
.nh
|
|
.TH podman-import 1
|
|
.SH NAME
|
|
podman-import \- Import a tarball and save it as a filesystem image
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman import\fP [\fIoptions\fP] \fIpath\fP [\fIreference\fP]
|
|
|
|
.PP
|
|
\fBpodman image import\fP [\fIoptions\fP] \fIpath\fP [\fIreference\fP]
|
|
|
|
.SH DESCRIPTION
|
|
\fBpodman import\fP imports a tarball (possibly compressed using Gzip, Bzip2, XZ or Zstd)
|
|
and saves it as a filesystem image. Remote tarballs can be specified using a URL.
|
|
Various image instructions can be configured with the \fB--change\fP flag and
|
|
a commit message can be set using the \fB--message\fP flag.
|
|
\fBreference\fP, if present, is a tag to assign to the image.
|
|
\fBpodman import\fP is used for importing from the archive generated by \fBpodman export\fP, that includes the container's filesystem. To import the archive of image layers created by \fBpodman save\fP, use \fBpodman load\fP\&.
|
|
Note: \fB:\fR is a restricted character and cannot be part of the file name.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--arch\fP
|
|
Set architecture of the imported image.
|
|
|
|
.SS \fB--change\fP, \fB-c\fP=\fIinstruction\fP
|
|
Apply the following possible instructions to the created image:
|
|
\fBCMD\fP | \fBENTRYPOINT\fP | \fBENV\fP | \fBEXPOSE\fP | \fBLABEL\fP | \fBSTOPSIGNAL\fP | \fBUSER\fP | \fBVOLUME\fP | \fBWORKDIR\fP
|
|
|
|
.PP
|
|
Can be set multiple times
|
|
|
|
.SS \fB--help\fP, \fB-h\fP
|
|
Print usage statement
|
|
|
|
.SS \fB--message\fP, \fB-m\fP=\fImessage\fP
|
|
Set commit message for imported image
|
|
|
|
.SS \fB--os\fP
|
|
Set OS of the imported image.
|
|
|
|
.SS \fB--quiet\fP, \fB-q\fP
|
|
Shows progress on the import
|
|
|
|
.SS \fB--variant\fP
|
|
Set variant of the imported image.
|
|
|
|
.SH EXAMPLES
|
|
Import the selected tarball into new image, specifying the CMD, ENTRYPOINT and LABEL:
|
|
|
|
.EX
|
|
$ podman import --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change LABEL=blue=image ctr.tar image-imported
|
|
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
|
|
db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
|
|
.EE
|
|
|
|
.PP
|
|
Import the selected tarball into new image, specifying the CMD, ENTRYPOINT and LABEL:
|
|
|
|
.EX
|
|
$ podman import --change 'ENTRYPOINT ["/bin/sh","-c","test-image"]' --change LABEL=blue=image test-image.tar image-imported
|
|
Getting image source signatures
|
|
Copying blob e3b0c44298fc skipped: already exists
|
|
Copying config 1105523502 done
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
110552350206337183ceadc0bdd646dc356e06514c548b69a8917b4182414b
|
|
.EE
|
|
|
|
.PP
|
|
Import new tagged image from stdin in quiet mode:
|
|
|
|
.EX
|
|
$ cat ctr.tar | podman -q import --message "importing the ctr.tar file" - image-imported
|
|
db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
|
|
.EE
|
|
|
|
.PP
|
|
Import an image from stdin:
|
|
|
|
.EX
|
|
$ cat ctr.tar | podman import -
|
|
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
|
|
db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
|
|
.EE
|
|
|
|
.PP
|
|
Import named image from tarball via a URL:
|
|
|
|
.EX
|
|
$ podman import http://example.com/ctr.tar url-image
|
|
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
|
|
db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBpodman-export(1)\fP
|
|
|
|
.SH HISTORY
|
|
November 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com
|
|
\[la]mailto:umohnani@redhat.com\[ra]
|