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命令),则可能无法保留拥有权。