lxc-copy 的手册页 - Linux 容器

lxc-copy

节:(1)
更新:2021-06-03
索引 返回主要内容
 

名称

lxc-copy - 复制现有容器。  

概要

lxc-copy {-n, --name name} [-P, --lxcpath path] {-N, --newname newname} [-p, --newpath newpath] [-B, --backingstorage backingstorage] [-s, --snapshot] [-a, --allowrunning] [-K, --keepname] [-D, --keepdata] [-M, --keepmac] [-L, --fssize size [unit]] [-- hook arguments] lxc-copy {-n, --name name} [-P, --lxcpath path] {-N, --newname newname} [-p, --newpath newpath] {-e, --ephemeral} [-B, --backingstorage backingstorage] [-s, --snapshot] [-a, --allowrunning] [-K, --keepname] [-D, --keepdata] [-M, --keepmac] [-L, --fssize size [unit]] [-- hook arguments] lxc-copy {-n, --name name} [-P, --lxcpath path] {-N, --newname newname} [-p, --newpath newpath] {-e, --ephemeral} [-B, --backingstorage backingstorage] [-s, --snapshot] [-t, --tmpfs] [-K, --keepname] [-M, --keepmac] [-- hook arguments] lxc-copy {-n, --name name} [-P, --lxcpath path] {-N, --newname newname} [-p, --newpath newpath] {-R, --rename}  

描述

lxc-copy 创建并可选地启动(短暂或非短暂)现有容器的副本。

lxc-copy 创建现有容器的副本。副本可以是原始容器的完整克隆。在这种情况下,容器的整个根文件系统将简单地复制到新容器中。或者,它们可以是快照,即原始容器的小型写时复制副本。在这种情况下,副本指定的备份存储必须支持快照。目前这包括 btrfs、lvm(lvm 设备不支持快照的快照)、overlay 和 zfs。

副本的备份存储将与原始容器的类型相同。目录备份容器的 overlay 快照不受此规则的约束。

当指定了-e 标志时,将创建并启动原始容器的短暂快照。短暂容器将在其配置文件中设置lxc.ephemeral = 1,并在关闭时被销毁。当-e-D一起使用时,将创建并启动原始容器的非短暂快照。短暂容器也可以放在带有-t 标志的 tmpfs 上。注意:如果位于 tmpfs 上的短暂容器重新启动,对它的所有更改目前都将丢失!

当指定了-e 并且没有通过-N 给出新名称时,将为快照选择一个随机名称。

使用-e 创建并启动的容器可以有自定义挂载。这些通过-m 标志指定。目前支持两种类型的挂载:bindoverlay。挂载类型作为-m 标志的子选项指定,并且可以多次指定,以逗号分隔。overlay 挂载目前以-m overlay=/src:/dest 的格式指定。当没有指定目标dest 时,dest 将与src 相同。只读bind 挂载指定为-m bind=/src:/dest:ro,读写bind 挂载指定为-m bind=/src:/dest:rw。读写bind 挂载是默认设置,当需要读写挂载时,rw 可以缺失。当dest 缺失时,dest 将与src 相同。多个挂载的示例将是-m bind=/src1:/dest1:ro,bind=/src2:ro,overlay=/src3:/dest3

通过-m 标志支持的挂载、其选项和格式可能会发生变化。  

选项

-N,--newname newname
副本的名称。
-p,--newpath newpath
副本的路径。
-R,--rename
重命名原始容器。
-s,--snapshot
创建原始容器的快照。副本的备份存储必须支持快照。目前这包括 btrfs、lvm、overlay 和 zfs。
-a,--allowrunning
允许创建正在运行的容器的快照。这可能会导致数据损坏或数据丢失,具体取决于使用的文件系统和应用程序。谨慎使用。
-F,--foreground
在前景运行快照。快照控制台将附加到当前 tty。(此选项只能与-e 结合使用。)
-d, --daemon
作为守护进程运行快照(这是短暂容器的默认模式)。由于容器不再有 tty,如果发生错误,不会显示任何内容,可以使用日志文件检查错误。(此选项只能与-e 结合使用。)
-m, --mount mounttype
为快照指定挂载。挂载类型的opts 参数可以是 {bind, overlay} 类型。例如 -m bind=/src:/dest:ro,overlay=/src:/dest(此选项目前只能与-e 结合使用)。
-t, --tmpfs
当指定此选项时,短暂容器将被放置在 tmpfs 上。注意:重新启动位于 tmpfs 上的短暂容器目前会导致对它的所有更改丢失。此标志仅适用于使用-e 标志创建的短暂容器。原始容器(从中创建短暂快照)必须存储为简单目录。
-B, --backingstorage backingstorage
指定要用于副本的备份存储类型,其中 'backingstorage' 的类型为 'btrfs'、'dir'、'lvm'、'loop'、'overlay' 或 'zfs'。
-L, --fssize size [unit]
为 'lvm' 文件系统指定大小。
-K, --keepname
当指定此选项时,原始容器的主机名将保留给副本。
-D, --keepdata
当与-e 一起指定此选项时,将创建并启动一个非短暂容器。
-M, --keepmac
当指定此选项时,原始容器的 MAC 地址将保留给副本。
 

复制钩子

如果要复制的容器指定了一个或多个lxc.hook.clone,那么将为新容器调用指定的钩子。传递给克隆钩子的前 3 个参数将是容器名称、一个部分 ('lxc') 以及钩子类型 ('clone')。传递给lxc-copy 的额外参数将从参数 4 开始传递给钩子程序。LXC_ROOTFS_MOUNT 环境变量给出容器根文件系统挂载的路径。配置文件路径存储在LXC_CONFIG_FILE 中,新容器名称存储在LXC_NAME 中,旧容器名称存储在LXC_SRC_NAME 中,根文件系统所在的路径或设备存储在LXC_ROOTFS_PATH 中。  

通用选项

这些选项是大多数 lxc 命令通用的。
-?, -h, --help
打印比正常情况下更长的使用信息。
--usage
给出使用信息
-q, --quiet
静音开启
-P, --lxcpath=PATH
使用备用容器路径。默认值为 /var/lib/lxc。
-o, --logfile=FILE
输出到备用日志FILE。默认值为无日志。
-l, --logpriority=LEVEL
将日志优先级设置为LEVEL。默认日志优先级为 ERROR。可能的值是:FATAL、CRIT、WARN、ERROR、NOTICE、INFO、DEBUG。

请注意,此选项正在设置备用日志文件中事件日志的优先级。它不会影响 stderr 上的 ERROR 事件日志。

-n, --name=NAME
使用容器标识符NAME。容器标识符格式为字母数字字符串。
--rcfile=FILE
指定配置文件来配置容器的虚拟化和隔离功能。

如果存在此配置文件,即使先前创建的容器中(通过 lxc-create)已经存在配置文件,也会使用它。

--version
显示版本号。
 

参见

lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-execute(1), lxc-console(1), lxc-monitor(1), lxc-wait(1), lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1), lxc-attach(1), lxc.conf(5)  

作者

Christian Brauner <christian.brauner@mailbox.org>


 

索引

名称
概要
描述
选项
复制钩子
通用选项
参见
作者

此文档由 man2html 使用手册页创建。
时间:04:45:10 GMT,2024 年 11 月 3 日