異なるプロジェクトで作業するには¶

defaultプロジェクト以外にもプロジェクトがある場合、Incus で作業する際に正しいプロジェクトを使用するか、対象となるプロジェクトを確認する必要があります。

注釈

特定のユーザーに制限されたプロジェクトがある場合、すべてのプロジェクトを表示できるのは、LXDへのフルアクセス権を持つユーザーのみです。

フルアクセス権を持たないユーザーは、アクセス権があるプロジェクトの情報のみを表示できます。

プロジェクトの一覧表示¶

すべてのプロジェクト（閲覧許可があるもの）を一覧表示するには、次のコマンドを入力します:

incus project list

デフォルトでは、出力はリスト形式で表示されます:

user@host:~$ incus project list

+----------------------+--------+----------+-----------------+-----------------+----------+---------------+---------------------+---------+

|      NAME            | IMAGES | PROFILES | STORAGE VOLUMES | STORAGE BUCKETS | NETWORKS | NETWORK ZONES |     DESCRIPTION     | USED BY |

+----------------------+--------+----------+-----------------+-----------------+----------+---------------+---------------------+---------+

| default              | YES    | YES      | YES             | YES             | YES      | YES           | Default Incus project | 19      |

+----------------------+--------+----------+-----------------+-----------------+----------+---------------+---------------------+---------+

| my-project (current) | YES    | NO       | NO              | NO              | YES      | YES           |                     | 0       |

+----------------------+--------+----------+-----------------+-----------------+----------+---------------+---------------------+---------+

異なる出力形式を要求するには、--formatフラグを追加します。詳細については、incus project list --help を参照してください。

プロジェクトの切り替え¶

デフォルトでは、Incus で実行するすべてのコマンドは、現在使用しているプロジェクトに影響します。どのプロジェクトを使用しているかを確認するには、incus project list コマンドを使用します。

別のプロジェクトに切り替えるには、次のコマンドを入力します:

incus project switch <project_name>

プロジェクトをターゲットにする¶

別のプロジェクトに切り替える代わりに、コマンドを実行する際に特定のプロジェクトをターゲットにすることができます。多くの Incus コマンドは、--projectフラグをサポートしており、異なるプロジェクトでアクションを実行できます。

注釈

許可があるプロジェクトだけをターゲットにすることができます。

以下のセクションでは、プロジェクトを切り替える代わりにターゲットにする典型的な例をいくつか紹介します。

特定のプロジェクト内のインスタンスをリストする¶

特定のプロジェクト内のインスタンスをリストするには、incus list コマンドに--projectフラグを追加します。

たとえば:

incus list --project my-project

インスタンスを別のプロジェクトに移動する¶

インスタンスを 1 つのプロジェクトから別のプロジェクトに移動するには、次のコマンドを入力します:

incus move <instance_name> <new_instance_name> --project <source_project> --target-project <target_project>

ターゲットプロジェクトにその名前のインスタンスが存在しない場合、同じインスタンス名を維持できます。

たとえば、インスタンスmy-instanceをdefaultプロジェクトからmy-projectに移動し、インスタンス名を維持するには、次のコマンドを入力します:

incus move my-instance my-instance --project default --target-project my-project

プロファイルを別のプロジェクトにコピーする¶

デフォルトの設定でプロジェクトを作成すると、プロファイルはプロジェクト内で隔離されます（features.profiles が true に設定されています）。そのため、プロジェクトはデフォルトのプロファイル（defaultプロジェクトの一部）にアクセスできず、インスタンスを作成しようとすると次のようなエラーが表示されます:

user@host:~$ incus launch images:ubuntu/22.04 my-instance

Creating my-instance

Error: Failed instance creation: Failed creating instance record: Failed initializing instance: Failed getting root disk: No root device could be found

これを修正するには、defaultプロジェクトのデフォルトプロファイルの内容を現在のプロジェクトのデフォルトプロファイルにコピーします。そのためには、次のコマンドを入力してください:

incus profile show default --project default | incus profile edit default