docker image import
描述 | 从 tarball 中导入内容以创建文件系统镜像 |
---|---|
用法 | docker image import [OPTIONS] file|URL|- [REPOSITORY[:TAG]] |
别名 | docker import |
描述
您可以指定URL
或-
(短横线)以直接从STDIN
获取数据。URL
可以指向包含文件系统或Docker主机上单个文件的存档(.tar、.tar.gz、.tgz、.bzip、.tar.xz或.txz)。如果您指定存档,Docker 会在容器中相对于/
(根目录)将其解压缩。如果您指定单个文件,则必须指定主机中的完整路径。要从远程位置导入,请指定以http://
或https://
协议开头的URI
。
--change
选项会将Dockerfile
指令应用于创建的镜像。支持的Dockerfile
指令:CMD
|ENTRYPOINT
|ENV
|EXPOSE
|ONBUILD
|USER
|VOLUME
|WORKDIR
选项
选项 | 默认值 | 描述 |
---|---|---|
-c, --change | 将Dockerfile指令应用于创建的镜像 | |
-m, --message | 设置导入镜像的提交信息 | |
--platform | API 1.32+ 如果服务器支持多平台,则设置平台 |
示例
从远程位置导入
这将创建一个新的未标记镜像。
$ docker import https://example.com/exampleimage.tgz
从本地文件导入
通过管道和STDIN
导入到docker。
$ cat exampleimage.tgz | docker import - exampleimagelocal:new
使用提交信息导入。
$ cat exampleimage.tgz | docker import --message "New image imported from tarball" - exampleimagelocal:new
从本地存档导入到docker。
$ docker import /path/to/exampleimage.tgz
从本地目录导入
$ sudo tar -c . | docker import - exampleimagedir
使用新的配置从本地目录导入
$ sudo tar -c . | docker import --change "ENV DEBUG=true" - exampleimagedir
请注意此示例中的sudo
– 您必须在使用tar进行存档时保留文件的拥有权(尤其是root拥有权)。如果您在使用tar时不是root用户(或sudo命令),则可能无法保留拥有权。