Back to the news overview

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

2024/05/31

はじめに ¶

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

このリリースには、テキサス大学オースティン校の学生による変更の第 2 弾と、その他いくつかの機能追加と改良が含まれています。

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

Enjoy!

新機能 ¶

新しい incus top コマンド ¶

新たに incus top コマンドを追加しました。これは、Incus のビルトイン OpenMetrics エンドポイント上に構築され、CPU、メモリー、ディスク使用量のインスタンスのリストの更新ビューが表示できるようになります。

+---------------+-------------+-----------+-----------+
| INSTANCE NAME | CPU TIME(S) |  MEMORY   |   DISK    |
+---------------+-------------+-----------+-----------+
| foo           | 6.73        | 12.44MiB  | 341.88MiB |
+---------------+-------------+-----------+-----------+
| speedtest     | 32.79       | 23.84MiB  | 373.50MiB |
+---------------+-------------+-----------+-----------+
| v1            | 67130.91    | 254.54MiB | 1.25GiB   |
+---------------+-------------+-----------+-----------+
Press 'd' + ENTER to change delay
Press 's' + ENTER to change sorting method
Press CTRL-C to exit

Delay: 5s
Sorting Method: Alphabetical

この作業は、テキサス大学オースティン校の学生によるコントリビューションです。

リソース API 内のシステム負荷情報 ¶

リソース API に新しいセクションが追加されました。サーバー負荷情報（1分、5分、10分）と、合計プロセス数が公開されるようになりました。

これは、Incus API からだけでさまざまなサーバーがどの程度ビジーかをひと目で見ることができるため、配置や自動バランシングのロジックに特に役立つでしょう。

stgraber@castiana:~$ incus info --resources
System:
  UUID: 05006c9c-7863-ee11-9e1b-224425600022
  Vendor: Framework
  Product: Laptop 13 (AMD Ryzen 7040Series)
  Family: Laptop
  Version: A5
  SKU: FRANDGCP05
  Serial: FRANDGCPA5340500AZ
  Type: physical
  Chassis:
      Vendor: Framework
      Type: Notebook
      Version: A5
      Serial: FRANDGCPA5340500AZ
  Motherboard:
      Vendor: Framework
      Product: FRANMDCP05
      Serial: FRANMDCPA534040120
      Version: A5
  Firmware:
      Vendor: INSYDE Corp.
      Version: 03.05
      Date: 03/29/2024

Load:
  Processes: 519
  Average: 0.80 0.77 0.71

[snip...]

この作業は、テキサス大学オースティン校の学生によるコントリビューションです。

インスタンスとプロジェクトへのアクセス情報を問い合わせる機能 ¶

新しい API が 2 つ追加され、プロジェクトまたは特定のインスタンスのアクセスリストが照会できるようになりました。

これは、OpenFGA サポートと統合されており、OpenFGA の十分に新しいバージョンであれば、誰がインスタンスにアクセスでき、どのようなロールを持っているのかを正確に表示します。

stgraber@castiana:~$ incus info --show-access foo
- identifier: stgraber@stgraber.org
  role: admin
  provider: openfga

stgraber@castiana:~$ incus project info --show-access default
- identifier: stgraber@stgraber.org
  role: admin
  provider: openfga

この作業は、テキサス大学オースティン校の学生によるコントリビューションです。

プロジェクトの強制削除 ¶

多数の負荷の高いプロジェクトを扱うとき、プロジェクトを削除するには、それらに含まれるすべてを正しい順序で探し出して、削除する必要があるため、かなりフラストレーションがたまります。

このようなことに対応するため、プロジェクトを削除する前に、すべてを正しい順序で削除するように Incus に指示する incus project delete --force が追加されました。

このコマンドは明らかに危険なコマンドです。このコマンドラインツールは、このプロジェクトをすべて削除しても良いのかを常に確認します。

stgraber@castiana:~$ incus project delete demo
Error: Only empty projects can be removed.

stgraber@castiana:~$ incus project delete demo --force
Remove demo and everything it contains (instances, images, volumes, networks, ...) (yes/no): yes
Project demo deleted

新たに get_project 関数をスクリプトレット関数に追加 ¶

スクリプトレットによるインスタンス配置機能（instances.placement.scriptlet）を利用しているユーザー向けに、新たに get_project 関数を追加しました。

この機能により、特定のプロジェクトのすべての詳細情報（api.Project）が取得できるようになり、プロジェクトの制限や制約を、配置を決定する際に特に役に立つようになりました。

ドキュメント: https://linuxcontainers.org/incus/docs/main/explanation/clustering/#instance-placement-scriptlet

この作業は、テキサス大学オースティン校の学生によるコントリビューションです。

プロジェクトをまたぐオブジェクトの問い合わせ ¶

Incus は、プロジェクトをまたいだ、すべてのインスタンスのリスト表示を長い間サポートしてきました。
そして、最近では、この機能はストレージボリューム、イメージ、プロファイル、ネットワークゾーン、オペレーションもカバーするように拡張されました。

Incus 6.2 では、残りのすべてのオブジェクトが、この機能をサポートするようになりました。追加されたのは次のものです:

• ストレージバケット
• ネットワーク
• ネットワーク ACL

CLI もそれに合わせて更新されたので、プロジェクト固有である可能性のあるオブジェクトを操作する list コマンドもすべて、--all-projects をサポートするようになりました。

この作業は、テキサス大学オースティン校の学生によるコントリビューションです。

incus info --resources の PCI デバイス ¶

incus info --resources の出力に、すべての PCI デバイスが含まれるようになりました。
従来は、GPU もしくはディスクセクションに含まれるデバイスのみが利用できました。

この作業は、テキサス大学オースティン校の学生によるコントリビューションです。

incus-simplestreams のエイリアス処理の改良 ¶

初期の incus-simplestreams の実装は、基本的に DISTRIBUTION/RELEASE/VARIANT という標準的なエイリアスが自動的に生成されます。しかし、これはすべての環境に適しているわけではありません。そこで、incus-simplestreams add に新たに 2 つの引数が追加されました。

• 前述のエイリアスを無効化するための --no-default-alias
• カスタムエイリアスを定義するための --alias （複数回指定可能）

incus CLI の create に与える YAML ¶

この作業は Incus 6.1 で始まり、今回完了しました。

すべての create コマンド、incus init、incus launch コマンドは、標準入力からの YAML を初期設定として読み取ることをサポートするようになりました。

これにより複雑なデプロイのスクリプトがはるかに簡単に作成できるようになります。

CLI のリストのカラムのカスタマイズ ¶

Incus 6.1 で開始したもう 1 つの作業が完了しました。

list 機能を持つ CLI コマンドはすべて、--column/-c フラグをサポートするようになりました。

この作業は、テキサス大学オースティン校の学生によるコントリビューションです。

ドキュメントの自動生成の増加 ¶

ほとんどのユーザーは気づかないことですが、ドキュメントが古くなったり、動機がずれるリスクを減らすため、コード内のコメントから直接ドキュメントが生成されるように徐々に移行しています。

Incus 6.2 では、次のドキュメントがこの方法で生成されるようになりました:

• Network zones
• Image restrictions
• Kernel limits
• Devices
  • disk
  • unix-block
  • unix-char
  • unix-hotplug
  • usb

この作業は、テキサス大学オースティン校の学生によるコントリビューションです。

すべての変更点 ¶

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

ドキュメント ¶

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.2.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