イメージを管理するには¶
イメージを扱う際は、利用可能なイメージについての情報を調べたりプロパティを表示・編集したり、特定のイメージを参照するエイリアスを設定したりできます。 またイメージをファイルにエクスポートすることもできます。これは他のマシンにイメージをコピーしたりインポートするのに便利です。
利用可能なイメージを一覧表示する¶
サーバー上のすべてのイメージを一覧表示するには、以下のコマンドを入力します:
incus image list [<remote>:]
リモートを指定しない場合は、デフォルトリモートが使用されます。
利用可能なイメージをフィルタする¶
表示される結果をフィルタするには、コマンドの後にエイリアスかフィンガープリントの一部を指定します。 たとえば、すべての Ubuntu 22.04 のイメージを表示するには、以下のコマンドを入力します:
incus image list images: 22.04
複数のフィルタも指定可能です。 たとえば、すべての Arm 64-bit の Ubuntu 22.04 のイメージを表示するには、以下のコマンドを入力します:
incus image list images: 22.04 arm64
エイリアスとフィンガープリント以外のプロパティをフィルタするには、<key>=<value>形式でフィルタを指定します。
たとえば:
incus image list images: 22.04 architecture=x86_64
イメージの情報を表示する¶
イメージの情報を表示するには、以下のコマンドを入力します:
incus image info <image_ID>
イメージの ID としては、イメージのエイリアスかフィンガープリントを指定できます。
リモートのイメージでは、リモートサーバーを忘れずに含めてください（たとえば、images:ubuntu/22.04）。
イメージのプロパティだけを表示するには、以下のコマンドを入力します:
incus image show <image_ID>
また、イメージの（propertiesキー配下にある）特定のプロパティは以下のコマンドで表示できます:
incus image get-property <image_ID> <key>
たとえば、公式の Ubuntu 22.04 イメージのリリース名を表示するには、以下のコマンドを入力します:
incus image get-property images:ubuntu/22.04 release
イメージのプロパティを編集する¶
properties キー配下にあるイメージの特定のプロパティを設定するには、以下のコマンドを入力します:
incus image set-property <image_ID> <key>
注釈
これらのプロパティはイメージについての情報を伝えるために使用できます。 これらはいかなる方法によっても Incus の挙動を変更はしません。
トップレベルのプロパティを含むイメージのプロパティ全体を編集するには、以下のコマンドを入力します:
incus image edit <image_ID>
イメージのエイリアスを設定する¶
イメージのエイリアスを設定すると、イメージを参照するのがより容易になり便利かもしれません。というのはエイリアスを覚えるほうがフィンガープリントを覚えるより通常容易だからです。 しかし、もっとも重要なのは、エイリアスは別のイメージを指すように変更できるので、常に最新のイメージ（たとえば最新のリリースバージョン）を提供するエイリアスを作れることです。
イメージ一覧の中に既存のエイリアスの例を見ることができます。 完全なリストを見るには、以下のコマンドを入力します:
incus image alias list
イメージをコピーやインポートまたは発行する際には、直接イメージにエイリアスを割り当てることができます。 代わりに、以下のコマンドを入力してエイリアスを作成することもできます:
incus image alias create <alias_name> <image_fingerprint>
エイリアスは削除することもできます:
incus image alias delete <alias_name>
エイリアスをリネームするには、以下のコマンドを入力します:
incus image alias rename <alias_name> <new_alias_name>
エイリアスの名前を維持したまま、別の（たとえば、より新しいバージョンの）イメージにエイリアスを向けたい場合は、既存のエイリアスを削除して新しいエイリアスを作成する必要があります。
イメージをファイルにエクスポートする¶
イメージはローカルサーバーかリモートの Incus サーバーのイメージストアに保管されます。 ですが、イメージをファイルにエクスポートすることができます。 この方法はイメージファイルをバックアップしたり、エアギャップされた（訳注：セキュリティーを高めるために外部ネットワークから遮断された）環境にイメージを持っていくのに便利です。
コンテナイメージをファイルにエクスポートするには、以下のコマンドを入力します:
incus image export [<remote>:]<image> [<output_directory_path>]
仮想マシンイメージをファイルにエクスポートするには、--vmフラグを追加します:
incus image export [<remote>:]<image> [<output_directory_path>] --vm
イメージに使用されるファイル構造の説明についてはイメージ形式を参照してください。