Save 命令
hangar save
命令与 mirror 命令类似,用于将容器镜像从镜像仓库下载至本地的压缩文件中,之后可使用 load 命令将压缩文件 中的镜像上传到镜像仓库中。
快速上手
使用以下命令将镜像列表中的镜像下载至压缩文件中:
-
创建样例镜像列表文件:
example_image_list.txtcnrancher/hangar:v1.7.0
cnrancher/hangar:latest
# Append some extra images here... -
将镜像从
docker.io
镜像仓库下载至压缩包saved_example.zip
中:#!/bin/bash
hangar save \
--file="example_image_list.txt" \
--source="docker.io" \
--destination="save_example.zip" \
--arch=amd64,arm64 \
--os=linux \
--jobs=4最终镜像文件将被保存在
saved_example.zip
压缩包中。 -
如果某些镜像无法下载,下载失败的镜像列表将保存在
save-failed.txt
。您可使用
--failed
参数指定输出的保存失败的镜像列表文件 名。之后使用 Hangar 的 Sync 命令,将保存失败的镜像重新下载增添在已有的压缩包文件中。
压缩文件格式
从 v1.7.0
起,Hangar 使用 zip
格式。
旧版本的 Hangar 创建的压缩包格式(tar.gz
)将无法与新版本(zip
)格式相兼容。
关于压缩文件的更多信息,请参考 load 命令和 压缩文件格式 页面。
使用方法
hangar save --help
Save images from registry server into local archive file
Usage:
hangar save -f IMAGE_LIST.txt -d SAVED_ARCHIVE.zip [flags]
hangar save [command]
Examples:
hangar save \
--file IMAGE_LIST.txt \
--source SOURCE_REGISTRY \
--destination SAVED_ARCHIVE.zip \
--arch amd64,arm64 \
--os linux
Available Commands:
validate Validate the saved images, ensure images were saved into archive file
Flags:
-a, --arch strings architecture list of images (default [amd64,arm64])
-y, --auto-yes answer yes automatically (used in shell script)
-d, --destination string file name of the output saved images (default "saved-images.zip")
-o, --failed string file name of the save failed image list (default "save-failed.txt")
-f, --file string image list file
-h, --help help for save
-j, --jobs int worker number, copy images parallelly (1-20) (default 1)
--os strings OS list of images (default [linux])
-s, --source string override the source registry in image list
--timeout duration timeout when save each images (default 10m0s)
--tls-verify require HTTPS and verify certificates
Global Flags:
--debug enable debug output
--insecure-policy run Hangar without policy check
Use "hangar save [command] --help" for more information about a command.