Awanio Cockpit との統合
Cockpit をターゲットにすると、Condensa は Cockpit コントロールプレーンが 管理する KVM ホスト群へ VM を移行します。移行ごとに ターゲットホスト、 ストレージプール、ネットワーク を選択でき、移行の転送ジョブは Cockpit の Tasks パネルに自動的に表示されます。
前提条件
- 稼働中の Cockpit コントロールプレーンに、Condensa サーバーから HTTPS で 到達できること。
- ターゲットホストが Cockpit に登録済みであること(Cockpit の通常の ホストプロビジョニングフローで追加)。
- Condensa 用の Cockpit サービスアカウント(アクセスキー + シークレット)。
- 直接取得(direct pull)とウォーム移行には: ターゲットホストに VDDK が インストール済み で、ホストから ESXi へのネットワークアクセスがあること — VDDK について を参照。
- staged フォールバック(VDDK のないホストで自動使用。コールドのみ)には: ホストが
CONDENSA_PUBLIC_URLに到達できること。
1. Cockpit でサービスアカウントを作成
Cockpit で Condensa 用のサービスアカウントを作成し、アクセスキーと シークレットを控えます。
2. Condensa でプロバイダーを登録
- Providers → Add Provider を開きます。
- ベンダーに Awanio Cockpit を選択します。
- 以下を入力します:
- Label — ウィザードで見分けやすい名前(例:
cockpit-prod) - API URL — Cockpit の API ベース(例:
https://cockpit.example.com/api/v1。オリジンのみでも可 — Condensa が/api/v1を補完します) - アクセスキー / シークレット — サービスアカウントの認証情報
- Label — ウィザードで見分けやすい名前(例:
- 保存後、プロバイダーカードの Test をクリックします — 成功しない 限り移行は実行できません。
3. 移行の実行
移行ウィザードで VMware ソースと VM を選択し、続いて:
- Target provider — 登録した Cockpit プロバイダー
- Target host — VM を受け取る KVM ホスト
- Storage pool — 変換後の qcow2 ディスクの配置先
- Network — VM の NIC を接続するスイッチ(既定は None。稼働中の ソースとの IP 競合を防ぐため)
電源オンかつ CBT が利用可能な VMware VM にはウォーム移行が提示され、 ウィザードが VM ごとの準備状況を表示します。
データの流れ
| エンジン | 経路 | 使用条件 |
|---|---|---|
| VDDK direct pull | ターゲットホストが ESXi から直接取得し、qcow2 へオンザフライ変換 | ホストに VDDK あり(優先。ウォームは必須) |
| Staged 転送 | Condensa が vSphere からエクスポート・変換し、ホストがダウンロード | 自動フォールバック。コールドのみ |
実際に使われたエンジンは移行詳細ページの Method バッジに表示されます。
ファームウェア(UEFI/BIOS)とセキュアブート
Condensa は移行元 VM のブートファームウェアを検出し、一致するファーム ウェアでターゲットを作成します — UEFI ゲストには UEFI(OVMF)ターゲット、 レガシーゲストには BIOS。これは自動で、UEFI ソースは移行ログに記録され ます。VM が正しいファームウェアで起動するための操作は不要です。
セキュアブートは移行後の VM では意図的に無効のままにします。 セキュ アブートの状態はディスクではなくファームウェアの NVRAM に保存されるため、 ディスクと一緒には移行されません。新しいターゲットの NVRAM(登録済み キーや OVMF ビルドがゲストの署名と一致しないことがある)に対して有効化 すると、しばしば起動できなくなります。セキュアブート下でインストール されたゲストも、無効のまま正常に起動します。セキュアブートはブート署名 を検証するだけで、起動の必須条件ではありません。
特定のゲストが本当にセキュアブートを必要とする場合(コンプライアンス ポリシーなど)は、移行後に Cockpit でその VM に対して有効化して ください:
- Cockpit で移行済み VM を電源オフにします。
- VM を開き、Firmware & Options を編集します。
- Secure Boot を有効化します — ゲストが必要とする場合は TPM も (例: Windows 11)。セキュアブートは x86_64 で q35 マシンタイプが 必要です。
- ターゲットホストにセキュアブート対応の OVMF ファームウェアがインス トールされていることを確認します。
- VM を起動します。
Firmware & Options のコントロールについては Cockpit → Virtual Machines を参照して ください。
Windows + BitLocker
ゲストが TPM/セキュアブートに紐付いた BitLocker を使用している場合、 ファームウェアの変更により次回起動時に一度だけ BitLocker 回復キーの 入力を求められることがあります。ファームウェア設定を変更する前に回復 キーを用意してください。
トラブルシューティング
- プロバイダーの Test が失敗する — API URL、サービスアカウントの 認証情報、Cockpit の TLS 証明書の受け入れを確認してください。
- インポートジョブが thumbprint/VDDK エラーで失敗する — ターゲット ホストの VDDK(Vapor UI → System → Third-party Libraries)と、ホストから ESXi のポート 443/902 への到達性を確認してください。
- direct pull のはずが staged 転送になった — ターゲットホストに VDDK が ないか ESXi に到達できません。移行は staging 経由のコールドで完了します。
- 移行済み VM が「no bootable device」/ 空のディスクを表示する — ターゲットのファームウェアはソースと一致する必要があります。Condensa は 自動的に設定しますが、ファームウェア引き継ぎが追加される前に作成された 移行は BIOS がデフォルトになります。移行を作り直してソースのファーム ウェアを検出させるか、Cockpit で VM のファームウェアを UEFI に切り替えて ください(Firmware & Options)。