# リモートサーバーを追加するには

リモートサーバーは Incus コマンドラインクライアント内の概念です。
デフォルトでは、コマンドラインクライアントはローカルの Incus デーモンとやりとりしますが、他のサーバーやクラスタを追加できます。

リモートサーバーの用途の 1 つはローカルサーバーでインスタンスを作成するのに使えるイメージを配布することです。
詳細は{ref}`image-servers`を参照してください。

完全な Incus サーバーをお使いのクライアントにリモートサーバーとして追加することもできます。
この場合、ローカルのデーモンと同様にリモートサーバーとやりとりできます。
たとえば、リモートサーバー上のインスタンスを管理したりサーバー設定を更新できます。

## 認証

Incus サーバーをリモートサーバーとして追加できるようにするには、サーバーの API が公開されている必要があります。
それはつまり、{config:option}`server-core:core.https_address`サーバー設定オプションが設定されている必要があることを意味します。

サーバーを追加する際は、{ref}`authentication`の方法で認証する必要があります。

詳細は{ref}`server-expose`を参照してください。

## 追加されたリモートを一覧表示する

% Include parts of the content from file [howto/images_remote.md](howto/images_remote.md)
```{include} howto/images_remote.md
   :start-after: <!-- Include start list remotes -->
   :end-before: <!-- Include end list remotes -->
```

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

% Include parts of the content from file [howto/images_remote.md](howto/images_remote.md)
```{include} howto/images_remote.md
   :start-after: <!-- Include start add remotes -->
   :end-before: <!-- Include end add remotes -->
```

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

Incus コマンドラインクライアントは`local`リモート、つまりローカルの Incus デーモン、に接続する用に初期設定されています。

別のリモートをデフォルトのリモートとして選択するには、以下のように入力します:

    incus remote switch <remote_name>

どのサーバーがデフォルトのリモートとして設定されているか確認するには、以下のように入力します。

    incus remote get-default

## グローバルのリモートを設定する

グローバルなシステム毎の設定としてリモートを設定できます。
これらのリモートは、設定を追加した Incus サーバーのすべてのユーザーで利用できます。

ユーザーはこれらのシステムで設定されたリモートを（たとえば [`incus remote rename`](incus_remote_rename.md)または[`incus remote set-urls`](incus_remote_set-urls.md)を実行することで）オーバーライドできます。
その結果、リモートと対応する証明書がユーザー設定にコピーされます。

グローバルリモートを設定するには、`/etc/incus/`に置かれた`config.yml`ファイルを編集します。

リモートへの接続用の証明書は同じ場所の`servercerts`ディレクトリー(たとえば、 `/etc/incus/servercerts/`)に保管する必要があります。
証明書はリモート名に対応する(たとえば、`foo.crt`)必要があります。

`clientcerts` ディレクトリーに配置することでリモート毎のクライアント証明書を 提供することもできます。
リモートの名前に対応したファイル名にする必要があります（たとえば`foo.crt`と`foo.key`)。

以下の設定例を参照してください:

```
remotes:
  foo:
    addr: https://192.0.2.4:8443
    auth_type: tls
    project: default
    protocol: incus
    public: false
  bar:
    addr: https://192.0.2.5:8443
    auth_type: tls
    project: default
    protocol: incus
    public: false
```

(remote-keepalive)=
## `keepalive` を有効にする

特定のリモートと頻繁にやりとりするユーザーは、新しい `keepalive` モードを有効にすることもできます。

有効にすると、Incus はターゲットサーバーとの接続を設定されたタイムアウトまで維持します。
これにより多くの `incus` コマンドを実行する際に遅延をかなり減らせます。

有効にするには、`incus remote set-keepalive`を使ってリモートにタイムアウトを設定してください。

    incus remote set-keepalive my-remote 30

この例では、30 秒のタイムアウトが使われます。

あるいは、`--keepalive`フラグでこの機能を有効にしたリモートを追加できます。

    incus remote add my-remote 192.0.2.10 --keepalive 30

`keepalive`を無効にするには、`incus remote set-keepalive`でタイムアウトの値を0にしてください。

    incus remote set-keepalive my-remote 0