Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
podman-import(1)	    General Commands Manual	      podman-import(1)

NAME
       podman-import - Import a	tarball	and save it as a filesystem image

SYNOPSIS
       podman import [options] path [reference]

       podman image import [options] path [reference]

DESCRIPTION
       podman  import  imports a tarball (.tar,	.tar.gz, .tgz, .bzip, .tar.xz,
       .txz) and saves it as a filesystem image. Remote	tarballs can be	speci-
       fied using a URL.  Various image	instructions can  be  configured  with
       the  --change  flag and a commit	message	can be set using the --message
       flag.  reference, if present, is	a tag to assign	to the image.	podman
       import  is  used	for importing from the archive generated by podman ex-
       port, that includes the container's filesystem. To import  the  archive
       of  image layers	created	by podman save,	use podman load.  Note:	: is a
       restricted character and	cannot be part of the file name.

OPTIONS
   --arch
       Set architecture	of the imported	image.

   --change, -c=instruction
       Apply the following possible instructions to the	created	image:	CMD  |
       ENTRYPOINT  |  ENV  |  EXPOSE  |	 LABEL	| STOPSIGNAL | USER | VOLUME |
       WORKDIR

       Can be set multiple times

   --help, -h
       Print usage statement

   --message, -m=message
       Set commit message for imported image

   --os
       Set OS of the imported image.

   --quiet, -q
       Shows progress on the import

   --variant
       Set variant of the imported image.

EXAMPLES
       Import the selected tarball into	new image, specifying the CMD,	ENTRY-
       POINT and LABEL:

       $ 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

       Import  the selected tarball into new image, specifying the CMD,	ENTRY-
       POINT and LABEL:

       $ 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

       Import new tagged image from stdin in quiet mode:

       $ cat ctr.tar | podman -q import	--message "importing the ctr.tar file" - image-imported
       db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3

       Import an image from stdin:

       $ 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

       Import named image from tarball via a URL:

       $ 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

SEE ALSO
       podman(1), podman-export(1)

HISTORY
       November	2017, Originally compiled  by  Urvashi	Mohnani	 umohnani@red-
       hat.com <mailto:umohnani@redhat.com>

							      podman-import(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-import&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help