18.3.2. engine-image-uploader 命令的语法
image uploader 命令的基本语法为:
engine-image-uploader[options]
list
engine-image-uploader[options]
upload
[file].[file]...[file]
镜像上传程序命令支持两个操作 -
列表
,以及 上传
。
list
操作列出了可上传到镜像的导出存储域。upload
操作将镜像上传到指定的导出存储域。
在使用 image uploader 命令时,您必须指定上述操作之一。此外,您必须至少指定一个本地文件才能使用
upload
操作。
有几个参数可以进一步优化 engine-image-uploader 命令。您可以在
/etc/ovirt-engine/imageuploader.conf
文件中为这些参数设置默认值。
常规选项
-h
,--help
- 显示如何使用镜像上传程序命令的信息。
--conf-file=[PATH]
- 设置 [PATH],作为命令将使用的配置文件。默认值为
etc/ovirt-engine/imageuploader.conf
。 --log-file=[PATH]
- 设置 [PATH] 作为命令用于写入日志输出的特定文件名。默认为
/var/log/ovirt-engine/ovirt-image-uploader/ovirt-image-uploader-[date].log
。 --cert-file=[PATH]
- 将 [PATH] 设置为用于验证引擎的证书。默认为
/etc/pki/ovirt-engine/ca.pem
。 --insecure
- 指定不会尝试验证引擎。
--quiet
- 设置静默模式,将控制台输出减少到最小值。
-v
,--verbose
- 设置详细模式,提供更多控制台输出。
-f
,--force
- 上传的源文件与目标导出域中现有文件具有相同的文件名时,需要强制模式。此选项强制覆盖现有文件。
Red Hat Virtualization Manager 选项
-u [USER]
,--user=[USER]
- 指定凭证将用于执行命令的用户。[USER] 以 [username]@[domain] 的形式指定。用户必须在指定的域中存在,且对 Red Hat Virtualization Manager 已知。
-r [FQDN]
,--engine=[FQDN]
- 指定从中上传镜像的 Red Hat Virtualization Manager 的 IP 地址或完全限定域名。假设镜像上传程序是从安装 Red Hat Virtualization Manager 的同一机器中运行。默认值为
localhost:443
。
导出存储域选项
以下选项指定要上传到镜像的导出域。这些选项不能一起使用;您必须使用
-e
选项或 -n
选项。
-e
[EXPORT_DOMAIN],--export-domain=[EXPORT_DOMAIN]
- 将存储域 EXPORT_DOMAIN 设置为上传的目的地。
-n
[NFSSERVER],--nfs-server=[NFSSERVER]
- 将 NFS 路径 [NFSSERVER] 设置为上传的目的地。
导入选项
通过以下选项,您可以自定义正在上传的镜像的属性,在镜像上传到导出域时。
-i
,--ovf-id
- 指定不更新镜像的 UUID。默认情况下,命令为上传的镜像生成一个新的 UUID。这样可确保正在上传的镜像 ID 和环境中已存在的镜像之间没有冲突。
-d
,--disk-instance-id
- 指定镜像中每个磁盘的实例 ID 不会重命名。默认情况下,命令为上传的镜像中的磁盘生成新 UUID。这样可确保镜像上的磁盘和环境中已存在的磁盘之间没有冲突。
-m
,--mac-address
- 指定镜像中的网络组件不会从镜像中删除。默认情况下,命令会从上传的镜像中删除网络接口卡,以防止环境中其他虚拟机上与网卡冲突。如果不使用这个选项,您可以使用管理门户将网络接口卡添加到新导入的镜像中,管理器将确保没有 MAC 地址冲突。
-N [NEW_IMAGE_NAME]
,--name=[NEW_IMAGE_NAME]
- 指定正在上传的镜像的新名称。