mirror of https://github.com/docker/cli.git
73 lines
2.0 KiB
Markdown
73 lines
2.0 KiB
Markdown
% DOCKER(1) Docker User Manuals
|
|
% Docker Community
|
|
% JUNE 2014
|
|
# NAME
|
|
docker-import - Create an empty filesystem image and import the contents of the tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) into it, then optionally tag it.
|
|
|
|
# SYNOPSIS
|
|
**docker import**
|
|
[**-c**|**--change**[=*[]*]]
|
|
[**-m**|**--message**[=*MESSAGE*]]
|
|
[**--help**]
|
|
file|URL|**-**[REPOSITORY[:TAG]]
|
|
|
|
# OPTIONS
|
|
**-c**, **--change**=[]
|
|
Apply specified Dockerfile instructions while importing the image
|
|
Supported Dockerfile instructions: `CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`ONBUILD`|`USER`|`VOLUME`|`WORKDIR`
|
|
|
|
**--help**
|
|
Print usage statement
|
|
|
|
**-m**, **--message**=""
|
|
Set commit message for imported image
|
|
|
|
# DESCRIPTION
|
|
Create a new filesystem image from the contents of a tarball (`.tar`,
|
|
`.tar.gz`, `.tgz`, `.bzip`, `.tar.xz`, `.txz`) into it, then optionally tag it.
|
|
|
|
|
|
# EXAMPLES
|
|
|
|
## Import from a remote location
|
|
|
|
# docker import http://example.com/exampleimage.tgz example/imagerepo
|
|
|
|
## Import from a local file
|
|
|
|
Import to docker via pipe and stdin:
|
|
|
|
# cat exampleimage.tgz | docker import - example/imagelocal
|
|
|
|
Import with a commit message
|
|
|
|
# cat exampleimage.tgz | docker import --message "New image imported from tarball" - exampleimagelocal:new
|
|
|
|
Import to a Docker image from a local file.
|
|
|
|
# docker import /path/to/exampleimage.tgz
|
|
|
|
|
|
## Import from a local file and tag
|
|
|
|
Import to docker via pipe and stdin:
|
|
|
|
# cat exampleimageV2.tgz | docker import - example/imagelocal:V-2.0
|
|
|
|
## Import from a local directory
|
|
|
|
# tar -c . | docker import - exampleimagedir
|
|
|
|
## Apply specified Dockerfile instructions while importing the image
|
|
This example sets the docker image ENV variable DEBUG to true by default.
|
|
|
|
# tar -c . | docker import -c="ENV DEBUG true" - exampleimagedir
|
|
|
|
# See also
|
|
**docker-export(1)** to export the contents of a filesystem as a tar archive to STDOUT.
|
|
|
|
# HISTORY
|
|
April 2014, Originally compiled by William Henry (whenry at redhat dot com)
|
|
based on docker.com source material and internal work.
|
|
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|