「Incus」の版間の差分

2024年5月11日 (土) 15:25時点における版

これは元の保守者による LXD のフォークです。LXD Wiki ページのドキュメントはまだ大部分が関連しており、読むことを推奨します。

インストール

incus パッケージをインストールし、incus.socketを有効化します。

また、例えばインスタンスを自動起動させたい場合は、incus.service を直接、有効化/起動することもできます。

コンテナ作成をユーザーに委任するには、incus-user.socket ユニットを有効化/起動します。グループ委任については #Accessing Incus as an unprivileged user を参照してください。

LXD からの移行

既存の LXD インストールから移行する場合は、この時点で行う必要があります。移行ツールは空のターゲット Incus サーバーに対してのみ実行されるためです。

lxc info と incus info コマンドが正しく動作していることを確認した後、上流の documentation を読み、その後で移行ツールを実行してください:

# lxd-to-incus

設定

非特権コンテナ

非特権コンテナの使用を推奨します (違いの説明については Linux コンテナ#特権コンテナと非特権コンテナを参照)。

これを行うには、コンテナ化された uid/gid ペアに対するマッピングを含むように /etc/subuid と /etc/subgid (これらのファイルが存在しない場合は作成する) を変更します。以下の例は単に root ユーザー (および systemd システムユニット) 用です:

以下のように usermod を使用することもできます:

usermod -v 1000000-1000999999 -w 1000000-1000999999 root

または、上記のファイルを直接以下のように変更します:

/etc/subuid

root:1000000:1000000000

/etc/subgid

root:1000000:1000000000

これで、すべてのコンテナはデフォルトで非特権で起動されます。

代替案については LXD#特権コンテナを参照してください。

Incus の設定

最初の起動時に、Incus を設定する必要があります。

root として実行:

# incus admin init

これにより、ストレージ、ネットワークなどの異なるトピックをカバーする対話式の設定ガイドがターミナルで開始されます。

公式の Getting Started Guide で概要を確認できます。

非特権ユーザーとして Incus にアクセスする

Incus は2つのユーザーグループを定義しています:

incus "基本的なユーザーアクセスを許可し、設定なしで全てのアクションはユーザープロジェクトごとに制限されます。"
incus-admin "Incus の完全な制御を許可します。"

すべてのコマンドを root として実行する必要なく Incus を制御するためには、あなたのユーザーをこれらのグループに追加します。

警告: incus-admin グループに追加された人は root と同等です。詳細は [1] と [2] を参照してください。

使用方法

コマンドの概要

使用可能なすべてのコマンドの概要を表示するには、以下を入力します:

$ incus

コンテナの作成

incus launch を使用してコンテナを作成できます。例えば:

$ incus launch ubuntu:20.04

コンテナはイメージサーバーまたはリモート LXD サーバーからダウンロードされたイメージに基づいています。

既に追加されたサーバーのリストを表示するには:

$ incus remote list

サーバー上のすべてのイメージをリストするには incus image list を使用します。例えば:

$ incus image list images:

これにより、デフォルトサーバーの一つである images.linuxcontainers.org のすべてのイメージが表示されます。

ディストリビューション名などの用語を追加してイメージを検索することもできます:

$ incus image list images:debian

特定のサーバーからのイメージでコンテナを起動するには:

$ incus launch servername:imagename

例えば:

$ incus launch images:centos/8/amd64 centos

amd64 Arch コンテナを作成するには:

$ incus launch images:archlinux/current/amd64 arch

Tips and tricks

Access the containers by name on the host

This assumes that you are using the default bridge that it is named incusbr0 and that you are using systemd-resolved.

# systemd-resolve --interface incusbr0 --set-domain '~incus' --set-dns $(incus network get incusbr0 ipv4.address | cut -d / -f 1)

You can now access the containers by name:

$ ping containername.incus

トラブルシューティング

仮想マシンの起動に失敗する

以下のエラーが表示された場合:

Error: Couldn't find one of the required UEFI firmware files: [{code:OVMF_CODE.4MB.fd vars:OVMF_VARS.4MB.ms.fd} {code:OVMF_CODE.2MB.fd vars:OVMF_VARS.2MB.ms.fd} {code:OVMF_CODE.fd vars:OVMF_VARS.ms.fd} {code:OVMF_CODE.fd vars:qemu.nvram}]

これは、Arch Linux がセキュアブート署名された ovmf ファームウェアを配布していないためです。仮想マシンを起動するためには、現時点ではセキュアブートを無効にする必要があります:

$ incus launch ubuntu:18.04 test-vm --vm -c security.secureboot=false

これをデフォルトプロファイルに追加する方法は以下の通りです:

$ incus profile set default security.secureboot=false

Incus が Shell の環境プロキシ変数を尊重しない

例えば incus launch や incus image コマンドがイメージをダウンロードする際に *_proxy/*_PROXY variables の値を使用していません。

Incus はサーバークライアントパラダイムを採用しています。これは、操作が Incus server として機能する incusd によって行われ、対話型シェルから呼び出されない限り通常はバックグラウンドで実行されることを意味します。そして、incus コマンドラインインターフェイスは Incus client として Incus サーバーと通信するために使用されます。

これにより、通常サービスとして開始される incusd は、クライアントのシェルの環境変数を継承せず、代わりに呼び出された環境の変数を尊重します。[3] Arch Linux では、Incus サーバーは systemd によって開始されます。

この問題には多くの回避策があります。いくつかの例を以下に示します。詳細は Incus の issue#574 を参照してください。

一時的

Shell 変数を systemd の環境にインポートする

まず、*_PROXY 変数をエクスポートします:

$ export ALL_PROXY="socks://proxy_server_address:port/"

これらを systemd の環境にインポートします:

# systemctl import-environment ALL_PROXY

incus.service ユニットを再/起動します。

ヒント: 変数を解除するには systemctl unset-environment コマンドを使用し、サービスを再起動してください。

恒久的

incus サービスユニットを編集する

Incus デーモンが一部の静的環境変数、例えば *_proxy で常に起動するようにしたい場合、systemd の Environment ディレクティブを使用できます。systemctl set-property コマンドでは Environment ディレクティブを操作することはできません。incus.service を編集し、適切な variableテンプレート:=value ペアを含む Environment キーを追加します。例えば:

# systemctl edit incus.service

...

[Service]
Environmentテンプレート:=ALL_PROXYテンプレート:="socks://proxy_server_address:port/"

...

Incus core.proxy オプションを使用する

Incus サーバーが望むプロキシを使用するようにするには、Incus サーバーを設定する際に core.proxy オプションを使用します。例えば:

# incus config set core.proxy_http "proxy_address:proxy_port"

ノート: core.proxy オプションはグローバルスコープを持ちます。つまり、クラスタメンバーに即座に適用されます。

Uninstall

Stop and disable the services. Then uninstall the incus package.

If you want to remove all data:

# rm -r /var/lib/incus

If you used any of the example networking configuration, you should remove those as well.

@@ 130行目: / 130行目: @@
  $ ping ''containername''.incus
+== トラブルシューティング ==
-== Troubleshooting ==
+=== 仮想マシンの起動に失敗する ===
-=== Starting a virtual machine fails ===
+以下のエラーが表示された場合:
-If you see the error:
  Error: Couldn't find one of the required UEFI firmware files: [{code:OVMF_CODE.4MB.fd vars:OVMF_VARS.4MB.ms.fd} {code:OVMF_CODE.2MB.fd vars:OVMF_VARS.2MB.ms.fd} {code:OVMF_CODE.fd vars:OVMF_VARS.ms.fd} {code:OVMF_CODE.fd vars:qemu.nvram}]
+これは、Arch Linux がセキュアブート署名された ovmf ファームウェアを配布していないためです。仮想マシンを起動するためには、現時点ではセキュアブートを無効にする必要があります:
-It's because Arch Linux does not distribute secure boot signed ovmf firmware. To boot virtual machines, you need to disable secure boot for the time being:
  $ incus launch ubuntu:18.04 test-vm --vm -c security.secureboot=false
+これをデフォルトプロファイルに追加する方法は以下の通りです:
-This can also be added to the default profile by doing:
  $ incus profile set default security.secureboot=false
-=== Incus does not respect Shell's environment proxy variables ===
+=== Incus が Shell の環境プロキシ変数を尊重しない ===
-Examples are {{ic|incus launch}} or {{ic|incus image}} commands not using value of {{ic|*_proxy}}/{{ic|*_PROXY}} [[variable|variables]] when downloading images.
+例えば {{ic|incus launch}} や {{ic|incus image}} コマンドがイメージをダウンロードする際に {{ic|*_proxy}}/{{ic|*_PROXY}} [[variable|variables]] の値を使用していません。
-Incus implements a server-client paradigm. It simply means that operations are done by {{ic|incusd}} acting as the [https://linuxcontainers.org/incus/docs/main/server Incus server] — usually running in the background, unless invoked from an interactive shell. And {{ic|incus}} commandline interface is used to communicate with Incus server acting as the [https://linuxcontainers.org/incus/docs/main/client Incus client].
+Incus はサーバークライアントパラダイムを採用しています。これは、操作が [https://linuxcontainers.org/incus/docs/main/server Incus server] として機能する {{ic|incusd}} によって行われ、対話型シェルから呼び出されない限り通常はバックグラウンドで実行されることを意味します。そして、{{ic|incus}} コマンドラインインターフェイスは [https://linuxcontainers.org/incus/docs/main/client Incus client] として Incus サーバーと通信するために使用されます。
-That makes {{ic|incusd}}, typically started as a service, not inheriting shell's environment variables of the client. But respecting variables of the environment that it's invoked from, instead.[https://linuxcontainers.org/incus/docs/main/environment] In Arch Linux, Incus server is started by systemd.
+これにより、通常サービスとして開始される {{ic|incusd}} は、クライアントのシェルの環境変数を継承せず、代わりに呼び出された環境の変数を尊重します。[https://linuxcontainers.org/incus/docs/main/environment] Arch Linux では、Incus サーバーは systemd によって開始されます。
+この問題には多くの回避策があります。いくつかの例を以下に示します。詳細は Incus の [https://github.com/lxc/incus/issues/574 issue#574] を参照してください。
-There can be many workarounds to this difficulty, following exist some examples. See Incus's [https://github.com/lxc/incus/issues/574 issue#574] for more information.
-==== Temporary ====
+==== 一時的 ====
-===== Import Shell variables to systemd's environment =====
+===== Shell 変数を systemd の環境にインポートする =====
+まず、{{ic|*_PROXY}} 変数を[[環境変数#セッションまたはシェルごと|エクスポート]]します:
-First, [[Environment variables#Per session or shell|export]] {{ic|*_PROXY}} variables:
  $ export ''ALL''_PROXY="socks://''proxy_server_address'':''port''/"
+これらを systemd の環境にインポートします:
-Import them to systemd's environment:
  # systemctl import-environment ''ALL''_PROXY
-[[start|Re/start]] {{ic|incus.service}} unit.
+{{ic|incus.service}} ユニットを[[起動|再/起動]]します。
-{{tip|Use {{ic|systemctl unset-environment}} command to unset a variable and [[restart]] the service.}}
+{{tip|変数を解除するには {{ic|systemctl unset-environment}} コマンドを使用し、サービスを[[再起動]]してください。}}
-==== Persistent ====
+==== 恒久的 ====
-===== Edit incus service unit =====
+===== incus サービスユニットを編集する =====
-If you want Incus daemon to always start with some static environment variables, like {{ic|*_proxy}}, you can use {{ic|Environment}} directive of [[systemd]]. {{ic|systemctl set-property}} command cannot manipulate {{ic|Environment}} directive. [[Edit]] {{ic|incus.service}} and add {{ic|Environment}} key with appropriate {{ic|variable{{=}}value}} pair. For example:
+Incus デーモンが一部の静的環境変数、例えば {{ic|*_proxy}} で常に起動するようにしたい場合、[[systemd]] の {{ic|Environment}} ディレクティブを使用できます。{{ic|systemctl set-property}} コマンドでは {{ic|Environment}} ディレクティブを操作することはできません。{{ic|incus.service}} を[[編集]] し、適切な {{ic|variable{{=}}value}} ペアを含む {{ic|Environment}} キーを追加します。例えば:
 {{hc|# systemctl edit incus.service|
@@ 186行目: / 186行目: @@
 ...}}
-===== Use Incus core.proxy options =====
+===== Incus core.proxy オプションを使用する =====
-One can make Incus server use a desired proxy with [https://linuxcontainers.org/incus/docs/main/howto/server_configure/ configuring] Incus's server with [https://linuxcontainers.org/incus/docs/main/server_config/#server-core:core.proxy_http core.proxy] options. For instance:
+Incus サーバーが望むプロキシを使用するようにするには、[https://linuxcontainers.org/incus/docs/main/howto/server_configure/ Incus サーバーを設定]する際に [https://linuxcontainers.org/incus/docs/main/server_config/#server-core:core.proxy core.proxy] オプションを使用します。例えば:
  # incus config set core.proxy_http "''proxy_address'':''proxy_port''"
+{{note|{{ic|core.proxy}} オプションはグローバルスコープを持ちます。つまり、クラスタメンバーに即座に適用されます。}}
-{{note|{{ic|core.proxy}} options have global scopes. I.e. they apply to cluster members, immediately.}}
 == Uninstall ==