プロファイルを使用するには#

プロファイルは一組の設定オプションを保持します。 プロファイルにはインスタンスオプション、デバイスとデバイスオプションを含められます。

1つのインスタンスには任意の数のプロファイルを適用できます。 プロファイルは指定された順番に適用され、その結果最後に指定したプロファイルが特定のキーを上書きします。 どのような場合でも、インスタンス固有の設定はプロファイル由来のものを上書きします。

注釈

プロファイルはコンテナと仮想マシンに適用できます。 ですので、どちらのタイプに有効なオプションとデバイスを含めることができます。

インスタンスタイプに適用できない設定を含むプロファイルを適用すると、この設定は無視されエラーにはなりません。

新しいインスタンスを起動する際にプロファイルを指定しない場合は、自動的にはdefaultプロファイルが適用されます。 このプロファイルはネットワークインタフェースとルートディスクを定義します。 default プロファイルはリネームや削除はできません。

プロファイルを表示する#

全ての利用可能なプロファイルを一覧表示するには以下のコマンドを入力します。

lxc profile list

プロファイルの内容を表示するには以下のコマンドを入力します。

lxc profile show <profile_name>

空のプロファイルを作成する#

空のプロファイルを作成するには以下のコマンドを入力します。

lxc profile create <profile_name>

プロファイルを編集する#

プロファイルの特定の設定オプションを設定するか、あるいはYAML形式でプロファイル全体を編集できます。

プロファイルの特定の設定オプションを設定する#

プロファイルのインスタンスオプションを設定するには、lxc profile setコマンドを使います。 プロファイル名とインスタンスオプションのキーとバリューを指定します。

lxc profile set <profile_name> <option_key>=<option_value> <option_key>=<option_value> ...

プロファイルのインスタンスデバイスを追加と変更するには、lxc profile device addコマンドを使います。 プロファイル名、デバイス名、デバイスタイプと(デバイスタイプごとの)必要に応じてデバイスオプションを指定します。

lxc profile device add <instance_name> <device_name> <device_type> <device_option_key>=<device_option_value> <device_option_key>=<device_option_value> ...

以前にプロファイルに追加したデバイスのインスタンスデバイスオプションを設定するには、lxc profile device setコマンドを使います。

lxc profile device set <instance_name> <device_name> <device_option_key>=<device_option_value> <device_option_key>=<device_option_value> ...

プロファイル全体を編集する#

個々の設定オプションを別々に設定する代わりに、YAML形式で一度にすべてのオプションを提供できます。

既存のプロファイルまたはインスタンス設定の中身で必要なマークアップをチェックします。 例えば、defaultプロファイルは以下のようになっているかもしれません。

config: {}
description: Default LXD profile
devices:
  eth0:
    name: eth0
    network: lxdbr0
    type: nic
  root:
    path: /
    pool: default
    type: disk
name: default
used_by:

インスタンスオプションはconfigの下に提供されます。 インスタンスデバイスとインスタンスデバイスオプションはdevicesの下に提供されます。

ターミナルの標準エディタを使ってプロファイルを編集するには、以下のコマンドを入力します。

lxc profile edit <profile_name>

別の方法として、設定を含むYAMLファイル( 例えば、profile.yaml)を作成して、以下のコマンドで設定をプロファイルに書き込めます。

lxc profile edit <profile_name> < profile.yaml

インスタンスにプロファイルを適用する#

インスタンスにプロファイルを適用するには以下のコマンドを入力します。

lxc profile add <instance_name> <profile_name>

Tip

プロファイル追加後にlxc config show <instance_name>を実行して設定を確認します。

プロファイルがprofilesの下に一覧表示されます。 しかし、プロファイルからの設定オプションはconfigの下には表示されません(--expandedフラグを追加しない限り)。 この挙動の理由はこれらの設定はプロファイルからは取得されインスタンス設定から取得されるわけではないからです。

これはプロファイルを編集する場合、変更はプロファイルを使用している全てのインスタンスに自動的に適用されることを意味します。

インスタンスの起動時に--profileフラグを追加してプロファイルを指定することもできます。

lxc launch <image> <instance_name> --profile <profile> --profile <profile> ...

インスタンスからプロファイルを削除する#

インスタンスからプロファイルを削除するには以下のコマンドを入力します。

lxc profile remove <instance_name> <profile_name>