Man page - lxc-copy(1)

Packages contains this manual

Available languages:

en ko ja

Manual

lxc-copy

NAME
SYNOPSIS
説 明
オ プ シ ョ ン
コ ピ ー 時 の フ ッ ク
共 通 オ プ シ ョ ン
SEE ALSO

NAME

lxc-copy - 既 存 の コ ン テ ナ の コ ピ ー

SYNOPSIS

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] [-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] [-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-clone と lxc-start-ephemeral の 置 き 換 え の コ マ ン ド で す 。

lxc-copy は 、 既 存 の コ ン テ ナ の コ ピ ー を 作 成 し ま す 。 コ ピ ー は 元 の コ ン テ ナ の 完 全 な ク ロ ー ン に で き ま す 。 こ の 場 合 、 単 に コ ン テ ナ の ル ー ト フ ァ イ ル シ ス テ ム の す べ て が 、 新 し い コ ン テ ナ に コ ピ ー さ れ ま す 。 ま た 、 ス ナ ッ プ シ ョ ッ ト を 取 得 す る こ と も 可 能 で す 。 す な わ ち 、 元 の コ ン テ ナ の 小 さ な コ ピ ー オ ン ラ イ ト の コ ピ ー に す る と い う こ と で す 。 こ の 場 合 、 コ ピ ー で 指 定 す る バ ッ キ ン グ ス ト レ ー ジ が ス ナ ッ プ シ ョ ッ ト を サ ポ ー ト し て い る 必 要 が あ り ま す 。 ス ナ ッ プ シ ョ ッ ト を サ ポ ー ト し て い る バ ッ キ ン グ ス ト レ ー ジ は 、 現 時 点 で は btrfs、 lvm (lvm デ バ イ ス は ス ナ ッ プ シ ョ ッ ト の ス ナ ッ プ シ ョ ッ ト は サ ポ ー ト し て い ま せ ん )、 overlay、 zfs で す 。

コ ピ ー 先 の バ ッ キ ン グ ス ト レ ー ジ は 、 元 の コ ン テ ナ と 同 じ タ イ プ に な る で し ょ う 。 た だ し 、 デ ィ レ ク ト リ バ ッ ク エ ン ド の コ ン テ ナ の ス ナ ッ プ シ ョ ッ ト は overlay で 取 得 で き ま す の で 例 外 で す 。

-e オ プ シ ョ ン を 指 定 し た 場 合 は 、 元 の コ ン テ ナ の 一 時 的 な ス ナ ッ プ シ ョ ッ ト を 作 成 し 、 起 動 し ま す 。 一 時 的 な コ ン テ ナ の 場 合 、 設 定 フ ァ イ ル に lxc.ephemeral = 1 が セ ッ ト さ れ 、 シ ャ ッ ト ダ ウ ン 後 に 削 除 さ れ ま す 。 -e と -D を 同 時 に 指 定 す る と 、 元 の コ ン テ ナ の 一 時 的 で は な い ス ナ ッ プ シ ョ ッ ト を 作 成 し 、 起 動 し ま す 。 -t オ プ シ ョ ン を 指 定 し て 、 一 時 的 な コ ン テ ナ を tmpfs 上 に 置 く こ と が で き ま す 。 注 意 : tmpfs 上 に 置 い た 一 時 的 な コ �\x83\xB3テ ナ を リ ブ ー ト す る と 、 コ ン テ ナ に 対 し て 行 っ た す べ て の 変 更 は 失 わ れ ま す !

-e を 指 定 し た 場 合 で 、 -N で コ ン テ ナ の 名 前 を 指 定 し な い 場 合 は 、 ス ナ ッ プ シ ョ ッ ト の 名 前 は ラ ン ダ ム で 命 名 さ れ ま す 。

-e で 作 成 し 、 起 動 し た コ ン テ ナ は 、 コ ン テ ナ 独 自 の マ ウ ン ト を 行 え ま す 。 現 時 点 で は bind 、 overlay と い う 2 つ の タ イ プ の マ ウ ン ト が サ ポ ー ト さ れ て い ま す 。 マ ウ ン ト タ イ プ は -m オ プ シ ョ ン の サ ブ オ プ シ ョ ン と し て 指 定 し ま す 。 こ の 指 定 は カ ン マ 区 切 り で 複 数 回 指 定 で き ま す 。 overlay マ ウ ン ト の 場 合 は 、 現 時 点 で は -m overlay=/src:/dest の よ う に 指 定 し ま す 。 マ ウ ン ト 先 の dest を 指 定 し な い 場 合 は 、 dest は src と 同 じ に な り ま す 。 読 み 込 み 専 用 の bind マ ウ ン ト は -m bind=/src:/dest:ro の よ う に 指 定 し ま す 。 読 み 書 き 可 能 な bind マ ウ ン ト は -m bind=/src:/dest:rw の よ う に 指 定 し ま す 。 bind マ ウ ン ト の デ フ ォ ル ト は 読 み 書 き 可 能 で す の で 、 読 み 書 き 可 能 な マ ウ ン ト を 行 う 場 合 は 省 略 で き ま す 。 マ ウ ン ト 先 の 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

ス ナ ッ プ シ ョ ッ ト す る コ ン テ ナ で 行 う マ ウ ン ト を 指 定 し ま す 。 マ ウ ン ト タ イ プ は {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 ア ド レ ス を コ ピ ー 先 で も そ の ま ま 使 い ま す 。

コ ピ ー 時 の フ ッ ク

コ ピ ー さ れ る コ ン テ ナ に 1 つ 以 上 の lxc.hook.clone の 指 定 が 存 在 す る 場 合 、 指 定 さ れ た フ ッ ク は 新 し い コ ン テ ナ に 対 し て 呼 ば れ ま す 。 ク ロ ー ン フ ッ ク に 渡 さ れ る 最 初 の 3 つ の 引 数 は 、 コ ン テ ナ 名 、 セ ク シ ョ ン (’lxc’)、 フ ッ ク タ イ プ (’clone’) と な り ま す 。 lxc-copy に 渡 さ れ る 追 加 の 引 数 は 、 フ ッ ク プ ロ グ ラ ム に 渡 さ れ る 引 数 の 4 番 目 以 降 と な り ま す 。 LXC_ROOTFS_MOUNT 環 境 変 数 に は 、 コ ン テ ナ の root フ ァ イ ル シ ス テ ム が マ ウ ン ト さ れ る パ ス が 与 え ら れ ま す 。 設 定 フ ァ イ ル の パ ス 名 は LXC_CONFIG_FILE に 、 新 し い コ ン テ ナ 名 は LXC_NAME 、 古 い コ ン テ ナ 名 は LXC_SRC_NAME に 、 rootfs の あ る パ ス ま た は デ バ イ ス は 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, ALERT, CRIT, WARN, ERROR, NOTICE, INFO, DEBUG, TRACE。

こ の オ プ シ ョ ン は 追 加 の ロ グ フ ァ イ ル へ の イ ベ ン ト ロ グ の 優 先 度 の 設 定 で あ る 事 に 注 意 し て く だ さ い 。 stderr へ の ERROR イ ベ ン ト の ロ グ に は 影 響 し ま せ ん 。

-n, --name= NAME

NAME と い う 名 前 で コ ン テ ナ を 識 別 し ま す 。 コ ン テ ナ 識 別 子 の フ ォ ー マ ッ ト は 英 数 字 の 文 字 列 で す 。

--rcfile= FILE

コ ン テ ナ の 仮 想 化 、 隔 離 機 能 の 設 定 の た め の 設 定 フ ァ イ ル を 指 定 し ま す 。

(lxc-create 経 由 で ) 前 も っ て コ ン テ ナ が 作 ら れ た 際 の 設 定 フ ァ イ ル が 既 に あ っ た 場 合 で も 、 こ の オ プ シ ョ ン が 指 定 さ れ た 場 合 は 、 指 定 し た 設 定 フ ァ イ ル が 使 用 さ れ ま す 。

--version

バ ー ジ ョ ン 番 号 を 表 示 し ま す 。

SEE ALSO

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)