Cockpit CLI リファレンス

Cockpit コマンドラインインターフェース (cockpit-cli) は、データベーススキーマの初期化、管理ユーザーアカウントの管理、ハイパーバイザーホストの登録、および Cockpit サーバー上での直接の診断の実行に使用されるシステムツールです。

---

1. システムセットアップとライフサイクルコマンド

データベーススキーマの初期化 (init)

• 説明: 必要なテーブル、リレーション、およびデフォルトパラメータを作成してデータベーススキーマを準備します。また、最初のルート管理者アカウントの作成を求めるプロンプトを表示します。
• 使用例:

  cockpit-cli init --config /etc/cockpit/cockpit.conf

Cockpit ゲートウェイの開始 (run)

• 説明: 中央の Cockpit サービスプロセスを実行します。
• 使用例:

  cockpit-cli run --config /etc/cockpit/cockpit.conf

---

2. ユーザーアカウント管理

ユーザーアカウントの作成 (user create)

• 説明: Web コンソールを使用せずに、ローカルユーザーアカウントを設定します。
• 使用例:

  cockpit-cli user create --username "admin" --email "admin@corp.awan.io" --role "super-admin"

アカウントパスワードのリセット (user reset-password)

• 説明: 指定したユーザーに新しいパスワードを設定し、認証失敗によって停止されていたアカウントのロックを解除します。
• 使用例:

  cockpit-cli user reset-password --username "admin" --password "newsecurepassword"

---

3. ハイパーバイザーホスト管理

登録済みホストのリスト表示 (host list)

• 説明: 共有データベースに問い合わせ、登録されているすべてのハイパーバイザーホストとその現在の動作ステータスを出力します。
• 使用例:

  cockpit-cli host list

ハイパーバイザーノードの登録 (host add)

• 説明: 新しい物理的な Vapor ホストを Cockpit のインベントリデータベースに追加します。
• 使用例:

  cockpit-cli host add --hostname "vapor-node-01.corp.awan.io" --ip "192.168.122.203" --token "VaporAPITokenString"

---

4. 診断とトラブルシューティング

クラスター情報の照会 (cluster status)

• 説明: データベース接続を確認し、スキーマのバージョンステータスを確認し、アクティブな接続数を報告します。
• 使用例:

  cockpit-cli cluster status

アドバイザリーロックの照会 (locks list)

• 説明: アクティブなデータベースアドバイザリーロックを一覧表示し、どの Cockpit インスタンスが各ハイパーバイザーホストを管理しているかを示します。
• 使用例:

  cockpit-cli locks list