イメージについて¶

Incus はイメージをベースとしたワークフローを使用します。各インスタンスはイメージをベースとしています。イメージは基礎となるオペレーティングシステム（たとえば、Linux ディストリビューション）と Incus に関連するいくつかの情報を含みます。

イメージはリモートのイメージストア（概要はデフォルトイメージサーバー参照）から利用可能ですが、既存のインスタンスや rootfs イメージをベースにして、独自のイメージを作成できます。

リモートサーバーからローカルのイメージストアにイメージをコピーしたり、ローカルのイメージをリモートサーバーにコピーできます。ローカルのイメージをリモートのインスタンスを作るのに使うこともできます。

各イメージはフィンガープリント（SHA256）で識別されます。イメージを管理しやすくするために、Incus では各イメージに 1 つ以上のエイリアスを定義できます。

キャッシュ¶

リモートのイメージからインスタンスを作成する際、Incus はイメージをダウンロードしローカルにキャッシュします。イメージはローカルのイメージストアに cached フラグをセットして保管されます。イメージは以下のいずれかが発生するまでは非公開のイメージとしてローカルに保持されます:

images.remote_cache_expiry で指定された日数の間新しいインスタンスを作成するのにイメージが使われなかった。
イメージの有効期限（イメージのプロパティの 1 つ。どのように変更するかの情報はイメージのプロパティを編集する参照）に達した。

Incus はイメージから新しいインスタンスが起動される度にイメージの last_used_at プロパティを更新することで、イメージの利用状況を記録しています。

自動更新¶

Incus はリモートサーバーからのイメージを自動的に最新に更新します。

注釈

エイリアスを指定して取得したイメージだけが更新されます。フィンガープリントを指定してイメージを取得した場合は、その特定のイメージバージョンを要求したことになります。

自動更新が有効になるかどうかはイメージをどのようにダウンロードしたかに依存します:

インスタンス作成時にイメージがダウンロードとキャッシュされた場合は、ダウンロード時に images.auto_update_cached が true に設定されていれば、自動的に更新されます。
イメージがリモートサーバーから incus image copy コマンドでコピーされた場合は、--auto-updateフラグが指定されていた場合のみ自動的に更新されます。

イメージのこの挙動は auto_update プロパティを編集することで変更できます。

起動時と images.auto_update_interval の間隔（デフォルトでは 6 時間ごと）を過ぎるたびに、Incus デーモンは自動更新とマークされコピー元のサーバーが記録されたストア内のすべてのイメージについてより新しいバージョンがあるかをチェックします。

新しいイメージが見つかったら、イメージ・ストアにダウンロードされます。その後古いイメージを指していたエイリアスは新しいイメージを指すように変更され、古いイメージはストアから削除されます。

インスタンスの生成が遅くならないようにするため、Incus はキャッシュされたイメージからインスタンスを作成する際に新しいバージョンが利用可能かをチェックしません。これはイメージが次の更新期間で更新されるまでの間は、新しく作成するインスタンスにイメージの古いバージョンが使われるかもしれないことを意味します。

特別なイメージプロパティ¶

プレフィックスrequirementsで始まるイメージプロパティ（たとえば、requirements.XYZ）は Incus がホストシステムと当該イメージで生成されるインスタンスの互換性を判断するために使用されます。これらの互換性がない場合には、Incus はそのインスタンスを起動しません。

以下の要件がサポートされています:

キー	タイプ	既定値	説明
`requirements.cdrom_agent`	bool	-	`true` に設定すると、VM が `agent:config` ディスクが追加されることを要求することを示します。
`requirements.cgroup`	string	-	`v1` に設定されている場合、ホストで`CGroupV1`が実行されている必要があることを示します。
`requirements.nesting`	bool	-	`true` に設定すると、ネスティングを有効にしないとイメージが動かないことを示します。
`requirements.privileged`	bool	-	`false` に設定すると、イメージが特権コンテナで使えないことを示します。
`requirements.secureboot`	bool	-	`false` に設定すると、イメージがセキュアブートで起動しないことを示します。