ニュースのトップページに戻る

Incus 6.13 リリースのお知らせ¶

2025/05/30

はじめに ¶

Incus チームは、Incus 6.13 のリリースのアナウンスができてうれしいです!

このリリースは、さまざまな規模やユーザーに向けた多数の新機能が盛り込まれた非常に充実したリリースです。誰にとっても何かがあるはずです!

いつものように、オンラインでご自身で試せます: https://linuxcontainers.org/incus/try-it/

Enjoy!

新機能 ¶

Windows エージェントのサポート ¶

Incus VM エージェントのロジックは、Linux 以外のオペレーティングシステム上でビルドできるようにリファクタリングされました。そして、Windows 用のエージェントが初期実装されました。

残念ながら、Windows にはまだ、Incus が通常エージェントとの通信に利用する vsock 通信メカニズム用の署名済み VirtIO ドライバーがないため、これはまだかなり初期の取り組みです。

幸いなことに、vsock で使っているプロトコルは HTTPS なので、代わりに VM へ直接（ネットワーク経由で） HTTPS を使えました。これは、Incus は Windows VM の IP アドレスを把握しており、その IP アドレスに Incus ホストから直接アクセスできる場合のみ動作します。将来的には、これをネイティブの vsock 接続に置き換える予定です。

サポートされている機能としては、incus exec を通してコマンドを実行したり、incus info で OS の詳細を取得したり、incus file でファイルを転送したりすることができるようになります。

これを動作させるには通常、source=agent:config ディスクデバイスを Windows VM に追加する必要があります。これにより、（ホストディストリビューションでパッケージ化されている場合）Windows エージェントと、必要な構成ファイルを含む CD-ROM ドライブが提供されます。

その時点から、そこから手動で直接エージェントを起動するか、手動でシステムサービスを追加できます。

Windows の経験がある方で、CD-ROM ドライブに含めることができるインストール PowerShell を通して、エクスペリエンスを磨き上げてくれる方を歓迎します。また、エージェント自体の Windows ビルドを Linux 版と完全に同等にするための作業も歓迎します。

この数ヶ月にわたる取り組みは、Sovereign Tech Fund からの資金提供により実現しました。

incus-migrate の改良 ¶

スタンドアローンツールである incus-migrate にかなりの改良が加えられました。

なお、このツールは Incus コンテナや VM に変換する必要があるリモートサーバー上、または Incus にインポートする必要がある既存のコンテナや VM を実行しているリモートサーバー上で実行できます。

このリリースで、incus-migrate に次のサポートを追加しました:

• ファイルシステムツリーやディスクイメージを新しいカスタムボリュームとしてアップロードする
• 新しいインスタンスの一部として追加のディスクやファイルシステムをインポートする
• OVA イメージを新しいインスタンスとしてインストールする
• Incus サーバーがクラスターの場合、特定のサーバーやクラスターグループを選択する

incus-migrate のスタティックビルドが GitHub上で取得できます。これは Incus を実行していないシステムを変換する時に役に立ちます。

カスタムボリューム上の SFTP ¶

インスタンスの場合と同様のファイル API をサポートするために、徐々にカスタムストレージボリューム（ファイルシステム各種）を取得しようとしています。

その第一歩として、Incus はそれらのボリューム上の SFTP 操作をサポートするようになりました。これは、現時点では incus storage volume file mount コマンドに相当します。残りの API とコマンドは Incus 6.14 でサポートされる予定です。

これは University of Texas in Austin の学生による作業です。

OVN ネットワーク上の設定可能なインスタンス外部 IP アドレス ¶

新しい NIC の設定キーを 2 つ追加しました:

• ipv4.address.external
• ipv6.address.external

これは、インスタンス起点の外部トラフィックに使う IP アドレスを設定するのに使えます。通常、これはネットワークの外部アドレス（デフォルト）か、インスタンスを指すネットワーク転送アドレスのいずれかです。

ドキュメント : https://linuxcontainers.org/incus/docs/main/reference/devices_nic/#nictype-ovn

これは University of Texas in Austin の学生による作業です。

OVN ネットワークのゲートウェイ MAC アドレスを固定する機能 ¶

OVN は MAC バインディングのリスト、つまり IP アドレスと MAC アドレスのマッピング（ARP テーブルや NDP テーブルに相当）を管理します。これは通常、OVN が特定のアドレスと通信する必要があるときに作成され、データベースに保存されます。

VRRP や同様の仮想 MAC アドレスで動作するネットワークでは、ゲートウェイの予想される MAC アドレスを事前に設定し、OVN が保持する必要がある場合があるため、これは必ずしも理想的ではありません。

このような場合のために、physical タイプの OVN アップリンクネットワークに設定できる 2 つの新しい設定キーが追加されました:

• ipv4.gateway.hwaddr
• ipv6.gateway.hwaddr

ドキュメント : https://linuxcontainers.org/incus/docs/main/reference/network_physical/

これは University of Texas in Austin の学生による作業です。

仮想マシン内のクロック処理 ¶

Incus は、移行しないことが想定されている仮想マシンに invtsc QEMU オプションを自動的に設定するようになりました。

さらに、Incus は VM の RTC クロックを永続化するために、QEMU から送出される RTC イベントをリッスンするようになりました。これにより、Windows VM だけでなく、UTC ハードウェアクロックに依存しない他の VM の処理も改善できます。

新しい get-client-certificate と get-client-token コマンド ¶

CLI に新たに incus remote get-client-certificate と incus remote get-client-token コマンドが追加されました。これにより、クライアント証明書の抽出やクライアント証明書からの JWT の発行が簡単になるため、スクリプト作成に役立ちます。

これは University of Texas in Austin の学生による作業です。

OCI での DHCPv6 サポート ¶

OCI コンテナで使用されるビルトインの DHCP クライアントは、ステートフルとステートレスの両方の DHCPv6 に対応できるようになりました。

これは University of Texas in Austin の学生による作業です。

routed NIC のネットワークホストテーブルの設定 ¶

Incus は routed NIC デバイスをどのルーティングテーブルに配置するかの制御をサポートしていますが、少し柔軟性に欠けていました。

代わりに、いくつか新しい設定キーが追加されました:

• ipv4.host_tables
• ipv6.host_tables

ルートを保存するテーブルのカンマ区切りのリストを設定できます。

ドキュメント : https://linuxcontainers.org/incus/docs/main/reference/devices_nic/#nictype-routed

これは University of Texas in Austin の学生による作業です。

Support for split image publishing¶

これまで、incus publish を実行すると、生成されるイメージは常に統合タイプのイメージでした。つまり、通常はルートディスクと Incus の設定の両方を含む圧縮された tarball 形式の単一ファイルでした。

しかし、分割イメージの生成をサポートするようになりました。分割イメージは、Incus 固有のメタデータとルートディスクデータの 2 つのファイルを生成します。

CLI では、incus publish に --format=split を与えて制御します。

これは University of Texas in Austin の学生による作業です。

事前に与える証明書 ¶

Incus サーバーに事前に与える構成ファイルに証明書を含めることができるようになりました。

次のようになります:

certificates:
  - type: client
    name: my-client
    certificate: |-
      PEM ENCODED CERTIFICATE

この機能は、Incus OS のようなシステムを自動的にプロビジョニングするときに役立ちます。

これは University of Texas in Austin の学生による作業です。

リスト形式の設定 ¶

Incus CLI の設定ファイル（通常は ~/.config/incus/config.yml）で、優先するリストの出力フォーマットを選択できるようになりました。

たとえば、次のようになります:

defaults:
  list_format: compact

これは list コマンドに --format=compact を渡すのと同じです。

これは University of Texas in Austin の学生による作業です。

create/add、delete/remove/rm のエイリアスの追加 ¶

Incus CLI は次のようにデザインされています:

• 重要な状態を持っているオブジェクトは create したあと、delete しなければなりません
• 状態がほとんどないか、全くないオブジェクトは added したあと、removed します

これは、特定のアクションに関係したリスクの一部を伝えることを目的にしていますが、一貫性を欠いている印象を与え、Incus のスクリプトの作成が少し難しくなる可能性があります。

この問題を解決するために、CLI に多数のエイリアスを追加しました。これにより、必要なコマンドを見つけられる可能性が大幅に高まります。

これは University of Texas in Austin の学生による作業です。

マニュアルで記述していた DB 関数のコードジェネレーターへの移行 ¶

Incus のコードベースには、データベースへのアクセス関数用のコードジェネレーターが含まれています。
これは、動作の一貫性を保証することと、データベースクエリーを手動で記述する際に起こりやすいイージーミスを防ぐのに非常に役立ちます。

すべての新しいデータベーステーブルでジェネレーターを使うことは事実上の要件ですが、まだジェネレーターを使用していないオブジェクトがかなりあります。

このリリースでは、次のオブジェクトの生成された関数への移行が完了しました:

• ネットワーク ACL
• ネットワークロードバランサー
• ネットワークゾーン

すべてのテストはパスしていますが、この手のリファクタリングは簡単には気づけないリグレッションを起こすリスクが高いです。Incus 6.13 で、これらのオブジェクトの動作に通常と異なる変化に気づいた場合は問題報告をください。調査します。

これは University of Texas in Austin の学生による作業です。

サーバーサイドフィルタリング ¶

このリリースでは、Incus 全体を通して可能な限りサーバーサイドフィルタリングを使う取り組みを継続しています。

このリリースで、次がサポートされました:

• incus network list
• incus storage bucket list
• incus project list
• incus config trust list

これは University of Texas in Austin の学生による作業です。

コードから生成するドキュメント ¶

設定キーが関係するすべての場所でドキュメントを自動生成する実装を行う取り組みを続けています。今回のリリースでは、次の項目が自動生成されるようになりました:

• PCI デバイス
• OVN ネットワーク
• 物理ネットワーク
• SR-IOV ネットワーク
• Macvlan ネットワーク

これは University of Texas in Austin の学生による作業です。

Incus OS 上の Incus メトリクスと統合された OS メトリクス ¶

Incus OS 上で Incus を実行すると、（node-exporter からの）ホストメトリクスが Incus のメトリクス API に自動的に含まれるようになりました。

これは、Incus OS が可能な限り開いているポート数を制限しようとし、すべてのトラフィックを単一のスタック（Incus 自身）を通して認証・認可しようとするために行われます。

パッケージャーに向けた注意 ¶

外部の umoci コマンドの使用から、Go パッケージを使用するように変更しました。

新しい Windows エージェントのサポートを受けるには、エージェントを Windows 用にビルドし、通常の Linux 用と共に、Incus で利用できるようにする必要があります。

すべての変更点 ¶

このリリースのすべての変更のリストは次の通りです（翻訳なし）:

ドキュメント ¶

Incus のドキュメントはこちらです:
https://incus-ja.readthedocs.io/ja/latest/ （日本語訳）
https://linuxcontainers.org/incus/docs/main/ （原文）

パッケージ ¶

Incus の開発元は、通常リリースの tarball のみをリリースするため、公式の Incus パッケージはありません。Incus を実行するために使えるオプションを以下にいくつか示します。

Linux 上に Incus サーバーをインストールする ¶

Incus はほとんどの一般的な Linux ディストリビューションで利用できます。インストール手順の詳細は、Incus のドキュメントを参照してください。

https://incus-ja.readthedocs.io/ja/latest/installing/ （日本語訳）
https://linuxcontainers.org/incus/docs/main/installing/ （原文）

Incus クライアントの Homebrew パッケージ ¶

HomeBrew 経由で、Linux と macOS 向けにクライアントツールが利用できます。

https://formulae.brew.sh/formula/incus

Incus クライアントの Chocolatey パッケージ ¶

Chocolatey 経由で、Windows ユーザー向けにクライアントツールが利用できます。

https://community.chocolatey.org/packages/incus/6.13.0

Incus クライアントの Winget パッケージ ¶

Winget 経由で、Windows ユーザー向けにクライアントツールが利用できます。

https://winstall.app/apps/LinuxContainers.Incus

サポート ¶

月次のフィーチャーリリースは、次のリリースがリリースされるまでのみサポートされます。より長いサポート期間と少ない変更頻度が必要な場合、代わりに Incus 6.0 LTS の使用を検討すべきです。

コミュニティサポートはこちらから : https://discuss.linuxcontainers.org
商用サポートはこちらから : https://zabbly.com/incus
バグはこちらから報告できます : https://github.com/lxc/incus/issues