98 lines
2.7 KiB
YAML
98 lines
2.7 KiB
YAML
|
command: docker import
|
|||
|
|
short: Import the contents from a tarball to create a filesystem image
|
|||
|
|
long: |-
|
|||
|
|
You can specify a `URL` or `-` (dash) to take data directly from `STDIN`. The
|
|||
|
|
`URL` can point to an archive (.tar, .tar.gz, .tgz, .bzip, .tar.xz, or .txz)
|
|||
|
|
containing a filesystem or to an individual file on the Docker host. If you
|
|||
|
|
specify an archive, Docker untars it in the container relative to the `/`
|
|||
|
|
(root). If you specify an individual file, you must specify the full path within
|
|||
|
|
the host. To import from a remote location, specify a `URI` that begins with the
|
|||
|
|
`http://` or `https://` protocol.
|
|||
|
|
|
|||
|
|
The `--change` option will apply `Dockerfile` instructions to the image
|
|||
|
|
that is created.
|
|||
|
|
Supported `Dockerfile` instructions:
|
|||
|
|
`CMD`|`ENTRYPOINT`|`ENV`|`EXPOSE`|`ONBUILD`|`USER`|`VOLUME`|`WORKDIR`
|
|||
|
|
usage: docker import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]
|
|||
|
|
pname: docker
|
|||
|
|
plink: docker.yaml
|
|||
|
|
options:
|
|||
|
|
- option: change
|
|||
|
|
shorthand: c
|
|||
|
|
value_type: list
|
|||
|
|
description: Apply Dockerfile instruction to the created image
|
|||
|
|
deprecated: false
|
|||
|
|
experimental: false
|
|||
|
|
experimentalcli: false
|
|||
|
|
kubernetes: false
|
|||
|
|
swarm: false
|
|||
|
|
- option: message
|
|||
|
|
shorthand: m
|
|||
|
|
value_type: string
|
|||
|
|
description: Set commit message for imported image
|
|||
|
|
deprecated: false
|
|||
|
|
experimental: false
|
|||
|
|
experimentalcli: false
|
|||
|
|
kubernetes: false
|
|||
|
|
swarm: false
|
|||
|
|
- option: platform
|
|||
|
|
value_type: string
|
|||
|
|
description: Set platform if server is multi-platform capable
|
|||
|
|
deprecated: false
|
|||
|
|
min_api_version: "1.32"
|
|||
|
|
experimental: true
|
|||
|
|
experimentalcli: false
|
|||
|
|
kubernetes: false
|
|||
|
|
swarm: false
|
|||
|
|
examples: |-
|
|||
|
|
### Import from a remote location
|
|||
|
|
|
|||
|
|
This will create a new untagged image.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ docker import http://example.com/exampleimage.tgz
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Import from a local file
|
|||
|
|
|
|||
|
|
- Import to docker via pipe and `STDIN`.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ cat exampleimage.tgz | docker import - exampleimagelocal:new
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- Import with a commit message.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ cat exampleimage.tgz | docker import --message "New image imported from tarball" - exampleimagelocal:new
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- Import to docker from a local archive.
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ docker import /path/to/exampleimage.tgz
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Import from a local directory
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ sudo tar -c . | docker import - exampleimagedir
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Import from a local directory with new configurations
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ sudo tar -c . | docker import --change "ENV DEBUG=true" - exampleimagedir
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Note the `sudo` in this example – you must preserve
|
|||
|
|
the ownership of the files (especially root ownership) during the
|
|||
|
|
archiving with tar. If you are not root (or the sudo command) when you
|
|||
|
|
tar, then the ownerships might not get preserved.
|
|||
|
|
deprecated: false
|
|||
|
|
experimental: false
|
|||
|
|
experimentalcli: false
|
|||
|
|
kubernetes: false
|
|||
|
|
swarm: false
|
|||
|
|
|