Skip to content

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 でプロバイダーを登録

  1. Providers → Add Provider を開きます。
  2. ベンダーに Awanio Cockpit を選択します。
  3. 以下を入力します:
    • Label — ウィザードで見分けやすい名前(例: cockpit-prod
    • API URL — Cockpit の API ベース(例: https://cockpit.example.com/api/v1。オリジンのみでも可 — Condensa が /api/v1 を補完します)
    • アクセスキー / シークレット — サービスアカウントの認証情報
  4. 保存後、プロバイダーカードの 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 に対して有効化して ください:

  1. Cockpit で移行済み VM を電源オフにします。
  2. VM を開き、Firmware & Options を編集します。
  3. Secure Boot を有効化します — ゲストが必要とする場合は TPM も (例: Windows 11)。セキュアブートは x86_64 で q35 マシンタイプが 必要です。
  4. ターゲットホストにセキュアブート対応の OVMF ファームウェアがインス トールされていることを確認します。
  5. 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)。