Man page - lxc-create(1)

Packages contains this manual

Available languages:

en ko ja

Manual

lxc-create

NAME
SYNOPSIS
説 明
オ プ シ ョ ン
共 通 オ プ シ ョ ン
診 断
SEE ALSO

NAME

lxc-create - コ ン テ ナ の 作 成

SYNOPSIS

lxc-create {-n name } [-f config_file ] {-t template } [-B backingstore ] [-- template-options ]

説 明

lxc-create は 、 設 定 情 報 と ユ ー ザ 情 報 が 保 存 さ れ て い る シ ス テ ム オ ブ ジ ェ ク ト を 作 成 し ま す 。 name で 指 定 さ れ た 名 前 が 、 他 の lxc コ マ ン ド で 、 コ ン テ ナ を 特 定 す る 名 前 と し て 使 わ れ ま す 。

オ ブ ジ ェ ク ト は /var/lib/lxc 内 に 作 ら れ る 、 自 身 の 名 前 が つ い た デ ィ レ ク ト リ で す 。

オ ブ ジ ェ ク ト は 、 ア プ リ ケ ー シ ョ ン が 使 用 し た り 、 参 照 し た り す る 様 々 な リ ソ ー ス の 定 義 で す 。 設 定 フ ァ イ ル が よ り 多 く の 情 報 を 持 つ ほ ど 、 コ ン テ ナ や ア プ リ ケ ー シ ョ ン は よ り 隔 離 さ れ た も の に な り ま す 。

設 定 フ ァ イ ル が config_file で 指 定 さ れ な い 場 合 、 コ ン テ ナ は デ フ ォ ル ト の 隔 離 状 態 で 作 ら れ ま す : プ ロ セ ス 、 sysv ipc、 マ ウ ン ト ポ イ ン ト で す 。

オ プ シ ョ ン

-f, --config config_file

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

-t, --template template

template は lxc-create コ マ ン ド が 呼 び 出 す 、 存 在 す る ’lxc-template’ ス ク リ プ ト の 短 い 名 前 で す 。 例 え ば 、 busybox, debian, fedora, ubuntu, sshd が あ り ま す 。 期 待 さ れ る ス ク リ プ ト の 構 造 の 詳 細 は 、 /usr/share/lxc/templates 内 の 例 を 参 照 し て く だ さ い 。 加 え て 、 実 行 可 能 な テ ン プ レ ー ト ス ク リ プ ト へ の フ ル パ ス も 指 定 す る こ と が 可 能 で す 。 rootfs の 作 成 を 行 わ な い よ う に "none" を 指 定 す る こ と も 可 能 で す 。

-B, --bdev backingstore

’backingstore’ に は ’dir’, ’lvm’, ’loop’, ’btrfs’, ’zfs’, ’rbd’, ’best’ の い ず れ か を 指 定 し ま す 。 デ フ ォ ル ト は ’dir’ で 、 コ ン テ ナ の ル ー ト フ ァ イ ル シ ス テ ム が /var/lib/lxc/container/rootfs 以 下 の デ ィ レ ク ト リ で あ る こ と を 意 味 し ま す 。 ’dir’ に は オ プ シ ョ ン と し て --dir ROOTFS を 指 定 す る こ と も 可 能 で す 。 こ の オ プ シ ョ ン は 、 デ フ ォ ル ト の 代 わ り に 特 定 の パ ス 以 下 に コ ン テ ナ の rootfs を 置 く と い う こ と に な り ま す 。 (’none’ は ’dir’ の エ イ リ ア ス で す 。 ) ’btrfs’ が 指 定 さ れ た 場 合 、 タ ー ゲ ッ ト の フ ァ イ ル シ ス テ ム は btrfs で な け れ ば い け ま せ ん 。 そ し て 、 コ ン テ ナ の rootfs は 新 し い subvolume と し て 作 製 さ れ ま す 。 こ の こ と に よ り 、 ス ナ ッ プ シ ョ ッ ト に よ る ク ロ ー ン が 作 製 可 能 に な り ま す が 、 結 果 と し て rsync --one-filesystem が 、 別 々 の フ ァ イ ル シ ス テ ム と し て 取 り 扱 っ て し ま う こ と に も な り ま す 。 backingstore が ’lvm’ で あ る 場 合 、 lvm ブ ロ ッ ク デ バ イ ス を 使 用 し ま す 。 こ の 時 、 以 下 の オ プ シ ョ ン が 有 効 に な り ま す : --lvname lvname1 は デ フ ォ ル ト 値 の コ ン テ ナ 名 の LV の 代 わ り に lvname1 と い う 名 前 の LV を 作 成 し ま す 。 --vgname vgname1 は 、 デ フ ォ ル ト 値 で あ る lxc と い う volume group の 代 わ り に vgname1 と い う 名 前 の volume group 内 に LV を 作 成 し ま す 。 --thinpool thinpool1 は 、 デ フ ォ ル ト で あ る lxc の と い う 名 前 の プ ー ル の 代 わ り に thinpool1 と い う 名 前 の プ ー ル 内 に シ ン プ ロ ビ ジ ョ ニ ン グ さ れ た ボ リ ュ ー ム と し て LV を 作 成 し ま す 。 --fstype FSTYPE は LV 上 の フ ァ イ ル シ ス テ ム を デ フ ォ ル ト 値 で あ る ext4 の 代 わ り に FSTYPE で 指 定 し た も の で 作 成 し ま す 。 --fssize SIZE は デ フ ォ ル ト 値 で あ る 1G の 代 わ り に SIZE で 指 定 し た サ イ ズ で LV を 作 成 し ま す 。

backingstore が ’loop’ の 場 合 、 ’lvm’ と 同 様 に --fstype FSTYPE と --fssize SIZE が 使 え ま す 。 こ れ ら の 値 の デ フ ォ ル ト 値 は ’lvm’ の 場 合 と 同 じ で す 。

backingstore が ’rbd’ の 場 合 、 ceph.conf に 有 効 な 設 定 が さ れ て お り 、 ceph.client.admin.keyring が 定 義 さ れ て い る 必 要 が あ り ま す 。 --rbdname RBDNAME を 指 定 す る と 、 RBDNAME と い う 名 前 の ブ ロ ッ ク デ バ イ ス を 作 成 し ま す 。 こ の オ プ シ ョ ン を 指 定 し な い 場 合 の デ フ ォ ル ト の ブ ロ ッ ク デ バ イ ス 名 は コ ン テ ナ 名 で す 。 --rbdpool POOL を 指 定 す る と 、 POOL と い う 名 前 の プ ー ル 内 に ブ ロ ッ ク デ バ イ ス を 作 成 し ま す 。 こ の オ プ シ ョ ン を 指 定 し な い 場 合 の デ フ ォ ル ト の プ ー ル 名 は ’lxc’ で す 。

backingstore が ’best’ の 時 、 lxc は btrfs, zfs, lvm, dir の 順 に 試 行 し ま す 。

-- template-options

こ れ は template-options で 指 定 し た も の を オ プ シ ョ ン と し て テ ン プ レ ー ト へ 渡 し ま す 。 テ ン プ レ ー ト で サ ポ ー ト さ れ て い る オ プ シ ョ ン を 調 べ る に は 、 lxc-create -t TEMPLATE -h と い う コ マ ン ド が 使 え ま す 。

共 通 オ プ シ ョ ン

こ こ で 紹 介 す る オ プ シ ョ ン は 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

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

診 断

The container already exists

メ ッ セ ー ジ の 通 り 、 コ ン テ ナ を 作 成 し よ う と し た け れ ど も 、 同 じ 名 前 の コ ン テ ナ が 存 在 し て い ま す 。 lxc-ls コ マ ン ド を 使 っ て 、 シ ス テ ム 上 に 存 在 す る 利 用 可 能 な コ ン テ ナ の リ ス ト が 表 示 で き ま す 。

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)