リモートイメージを使用するには

incus CLI コマンドは複数のイメージサーバーをサポートでき、Incus用のサーバーが初期設定されています。 概要はデフォルトイメージサーバーを参照してください。

設定されたリモートを一覧表示する

設定されたすべてのリモートサーバーを見るには、以下のコマンドを入力します:

incus remote list

simple streams形式を使用するリモートサーバーは純粋なイメージサーバーです。 incus形式を使用するサーバーは Incus サーバーであり、イメージサーバーだけとして稼働しているか、通常の Incus サーバーとして稼働するのに加えて追加のイメージを提供しているかのどちらかです。 詳細はイメージサーバータイプを参照してください。

リモート上の利用可能なイメージを一覧表示する

サーバー上のすべてのリモートイメージを一覧表示するには、以下のコマンドを入力します:

incus image list <remote>:

結果をフィルタできます。 手順は利用可能なイメージをフィルタするを参照してください。

リモートサーバーを追加する

どのようにリモートを追加するかはサーバーが使用しているプロトコルに依存します。

simple streamsサーバーを追加する

simple streams サーバーをリモートとして追加するには、以下のコマンドを入力します:

incus remote add <remote_name> <URL> --protocol=simplestreams

URL は HTTPS でなければなりません。

リモートのIncusサーバーを追加する

Incus サーバーをリモートして追加するには、以下のコマンドを入力します:

incus remote add <remote_name> <IP|FQDN|URL> [flags]

認証方法によっては固有のフラグが必要です(たとえば、OIDC 認証ではincus remote add <remote_name> <IP|FQDN|URL> --auth-type=oidcを使います)。 詳細はIncusサーバーでの認証リモートAPI認証を参照してください。

たとえば、IP アドレスを指定してリモートを追加するには以下のコマンドを入力します:

incus remote add my-remote 192.0.2.10

リモートサーバーのフィンガープリントを確認するプロンプトが表示され、トークンの入力を求められます。

イメージを参照する

イメージを参照するには、リモートとイメージのエイリアスまたはフィンガープリントをコロンで区切って指定します。 例:

images:ubuntu/22.04
images:ubuntu/22.04
local:ed7509d7e83f

デフォルトのリモートを選択する

リモート名前を指定せずにイメージ名だけ指定すると、デフォルトのイメージサーバーが使用されます。

どのサーバーがデフォルトのイメージサーバーと設定されているか表示するには、以下のコマンドを入力します:

incus remote get-default

別のリモートをデフォルトのイメージサーバーに選択するには、以下のコマンドを入力します:

incus remote switch <remote_name>