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

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

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

リモートのOCI互換サーバー（例：Docker Hub）を追加する¶

OCI互換サーバーを追加するには、以下のコマンドを実行します：

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

URLはHTTPSである必要があります。

例えば、Docker Hubをリモートとして追加するには以下のコマンドを実行します：

incus remote add oci-docker https://docker.io --protocol=oci

ログインするには、--token <token>でトークンを指定します。

例えば、あなた自身のトークンを指定してカスタムのコンテナーレジストリーを追加するには以下のコマンドを実行します：

incus remote add oci-myregistry https://code.example.org --token abcMyToken --protocol=oci

イメージを参照する¶

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

images:debian/12
images:debian/12
local:ed7509d7e83f

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

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

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

incus remote get-default

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

incus remote switch <remote_name>