LXDをデバッグするには#
インスタンスの問題をデバッグする際の情報については、インスタンスの起動に失敗する問題のトラブルシューティング方法を参照してください。
lxc
と lxd
のデバッグ#
lxc
と lxd
のコードをトラブルシューティングするのに役立ついくつかの異なる方法を説明します。
lxc --debug
#
クライアントのどのコマンドにも --debug
フラグを追加することで内部についての追加情報を出力することができます。
もし有用な情報がない場合はログ出力の呼び出しで追加することができます。
logger.Debugf("Hello: %s", "Debug")
lxc monitor
#
このコマンドはメッセージがリモートのサーバーに現れるのをモニターします。
ローカルソケット経由でのREST API#
サーバーサイドでLXDとやりとりするのに最も簡単な方法はローカルソケットを経由することです。
以下のコマンドはGET /1.0
にアクセスし、jqユーティリティを使って
JSONを人間が読みやすいように整形します。
curl --unix-socket /var/lib/lxd/unix.socket lxd/1.0 | jq .
あるいは snap ユーザーの場合は
curl --unix-socket /var/snap/lxd/common/lxd/unix.socket lxd/1.0 | jq .
利用可能なAPIについてはRESTful APIをご参照ください。
HTTPS経由でのREST API#
LXDへのHTTPS接続には、有効なクライアント証明書が必要で、最初のlxc remote add
で生成されます。
この証明書は、認証と暗号化のための接続ツールに渡す必要があります。
必要に応じて、openssl
を使って証明書(~/.config/lxc/client.crt
またはSnapユーザーの場合~/snap/lxd/common/config/client.crt
)を調べることができます:
openssl x509 -text -noout -in client.crt
表示される行の中に以下のようなものがあるはずです:
Certificate purposes:
SSL client : Yes
コマンドラインツールを使う#
wget --no-check-certificate --certificate=$HOME/.config/lxc/client.crt --private-key=$HOME/.config/lxc/client.key -qO - https://127.0.0.1:8443/1.0
# または snap ユーザーの場合
wget --no-check-certificate --certificate=$HOME/snap/lxd/common/config/client.crt --private-key=$HOME/snap/lxd/common/config/client.key -qO - https://127.0.0.1:8443/1.0
ブラウザを使う#
いくつかのブラウザ拡張はウェブのリクエストを作成、修正、リプレイするための便利なインタフェースを提供しています。
LXDサーバーに対して認証するにはlxc
のクライアント証明書をインポート可能な形式に変換しブラウザにインポートしてください。
例えばWindowsで利用可能な形式のclient.pfx
を生成するには以下のようにします。
openssl pkcs12 -clcerts -inkey client.key -in client.crt -export -out client.pfx
上記のコマンドを実行し、(訳注:変換後の証明書をインポートしてから)ブラウザでhttps://127.0.0.1:8443/1.0
を開けば期待通り動くはずです。
LXDデータベースをデバッグ#
グローバルデータベースのファイルは LXD のデータディレクトリ(例 /var/lib/lxd/database/global
かsnapユーザーは /var/snap/lxd/common/lxd/database/global
)の./database/global
サブディレクトリの下に格納されます。
クラスタの各メンバーもそのメンバー固有の何らかのデータを保持する必要があるため、LXDは通常のSQLiteのデータベース(「ローカル」データベース)も使用します。
これは./database/local.db
に置かれます。
アップグレードの前にはグローバルデータベースのディレクトリとローカルデータベースのファイルのバックアップが作成され、 .bak
のサフィックス付きでタグ付けされます。
アップグレード前の状態に戻す必要がある場合は、このバックアップを使うことができます。
データベースのデータとスキーマをダンプする#
データベースのデータまたはスキーマの SQL テキスト形式でのダンプを取得したい場合は、lxd sql <local|global> [.dump|.schema]
コマンドを使ってください。
これによりsqlite3コマンドラインツールの.dump
または.schema
ディレクティブと同じ出力を生成できます。
コンソールからカスタムクエリを実行する#
ローカルまたはグローバルデータベースにSQLクエリ(例 SELECT
, INSERT
, UPDATE
)を実行する必要がある場合、lxd sql
コマンドを使うことができます (詳細はlxd sql --help
を実行してください)。
ただ、これが必要になるのは壊れたアップデートかバグからリカバーするときだけでしょう。 その場合、まず LXD チームに相談してみてください (GitHubのイシューを作成するかフォーラムに投稿)。
LXDデーモン起動時にカスタムクエリを実行する#
SQLのデータマイグレーションのバグあるいは関連する問題のためにアップグレード後にLXDデーモンが起動に失敗する場合、壊れたアップデートを修復するクエリを含んだ.sql
ファイルを作成することで、その状況からリカバーできる可能性があります。
ローカルデータベースに対して修復を実行するには、修復に必要なクエリを含む./database/patch.local.sql
というファイルを作成してください。
同様にグローバルデータベースの修復には./database/patch.global.sql
というファイルを作成してください。
これらのファイルはデーモンの起動シーケンスの非常に早い段階で読み込まれ、クエリが成功したときは削除されます(クエリはSQLトランザクション内で実行されるので、クエリが失敗したときにデータベースの状態が変更されることはありません)。
上記の通り、まず LXD チームに相談してみてください。
クラスタデータベースをディスクに同期#
クラスタデータベースの内容をディスクにフラッシュしたいなら、lxd sql global .sync
コマンドを使ってください。これは通常のSQLite形式のデータベースのファイルを./database/global/db.bin
に書き込みます。
その後sqlite3
コマンドラインツールを使って中身を見ることができます。