vmware-aiops

VMware AIops

免責事項：これはコミュニティによって保守されているオープンソースプロジェクトであり、VMware, Inc. または Broadcom Inc. とは提携、推奨、後援関係にありません。「VMware」と「vSphere」は Broadcom の商標です。ソースコードは MIT ライセンスのもと、github.com/vmware-skills/VMware-AIops で公開されており、誰でも監査できます。

VMware ファミリーのエントリーポイントです。AI を活用した VM のライフサイクル管理、デプロイ、アラーム管理に対応する 61 個の MCP ツールを提供します。

まずはこちら：最初に vmware-aiops をインストールし、必要に応じてモジュールを追加してください。 vmware-aiops hub status を実行すると、インストール済みのファミリーメンバーを確認できます。 ファミリー：vmware-monitor（インベントリ／ヘルス）、vmware-storage（iSCSI／vSAN）、vmware-vks（Tanzu Kubernetes）、vmware-nsx（NSX ネットワーク）、vmware-nsx-security（DFW／ファイアウォール）、vmware-aria（メトリクス／アラート／容量）、vmware-avi（AVI／ALB／AKO）、vmware-harden（コンプライアンスベースライン）。 | vmware-pilot（ワークフローのオーケストレーション） | vmware-policy（監査／ポリシー）

このスキルでできること

カテゴリ	ツール	数
VM ライフサイクル	電源オン／オフ、作成、再構成、クローン、移行、削除、スナップショットの CRUD、TTL による自動削除、クリーンスレート	16
デプロイ	OVA、テンプレート、リンククローン、一括クローン／デプロイ	8
ゲスト操作	コマンドの実行、ファイルのアップロード／ダウンロード、プロビジョニング	5
計画／適用	ロールバックを含む複数ステップの計画	4
クラスター	作成、削除、HA／DRS の設定、ホストの追加／削除、DRS VM-VM ルール（一覧表示／作成／削除／有効化／無効化）	10
データストア	ファイルの参照、イメージのスキャン	2
ネットワーク	dvSwitch ポートグループの一覧表示／作成、ホスト VMkernel の一覧表示／追加／削除／サービスタグ付け、DF ビット対応の MTU パス ping	7
アラーム管理	アラームの一覧表示、確認、リセット	3
トリアージと調査（読み取り専用、vmware-monitor に処理を委任）	クラスターのヘルス概要を一目で確認、オブジェクトを中心とした VM／ホスト／データストアの詳細調査バンドル、vCenter を横断した「今、対応が必要なものは何か？」の確認	5
アクセス	使用中のアカウントと、各ツールに必要な権限の有無を確認	1

監査と安全性

エージェントを接続する前にお読みください。ツールごとの一覧：references/capabilities.md

• MCP のゲートは、デフォルトで書き込みを行わないプレビューを返します。 23 個の書き込みツール（破壊的な操作をすべて含みます）は、confirm=True が指定されない限り影響範囲を返します。ブロッカーがある場合や測定値を読み取れない場合は、confirm=True が拒否されます。さらに delete_vm では、プレビューの内容を反映した acknowledge_blast_radius も必要です。残りの 20 個（作成、クローン、デプロイ、電源オン、再構成）は、最初の呼び出しで実行されます。
• 強制適用の境界は vCenter/ESXi の RBAC です：エージェントは、設定されたアカウントで可能な操作をすべて実行できます。エージェントに変更を許可する範囲に限定した、最小権限の専用サービスアカウントを使用してください（読み取り専用ロールを設定すると、このスキルも読み取り専用になります）。パスワードは ~/.vmware-aiops/.env（0600）またはシークレットマネージャー（VMWARE_<TARGET>_PASSWORD）に保存してください。
• CLI のみ：破壊的なコマンドには二重の確認が必要です。ほとんどの CLI 書き込み操作では --dry-run を指定できます。いずれも MCP には適用されません。
• ポリシー：~/.vmware/rules.yaml の拒否ルールとメンテナンスウィンドウは、すべての MCP 呼び出しとリモート CLI 呼び出しの前に確認されます（例：environment: production のターゲットへの書き込みを拒否）。同梱のベースラインでは何も拒否されません。これはプロセス内のガードレールであり、RBAC の代わりにはなりません。
• 監査：すべての MCP 呼び出しは、認証情報を伏せたうえで ~/.vmware/audit.db に記録されます（vmware-audit log --last 20）。ベストエフォート方式のため、監査ログへの書き込みに失敗しても警告が表示されるだけで、処理はブロックされません。
• ゲスト操作では、ゲストアカウントに許可された任意のコマンド実行やファイル書き込みが可能です。読み取り専用の vCenter ロールでも、この操作は制限されません。username は必須で（デフォルトアカウントはありません）、MCP 経由ではパスワードがエージェントから見えるツール引数になるため、権限を最小限にしたゲストアカウントを渡してください。upload_vm_guest_file は、サーバーが読み取れる任意のローカルファイルを読み込みます。

クイックインストール

uv tool install vmware-aiops==2.4.2
vmware-aiops doctor
vmware-aiops hub status   # see which family members are installed

VMware ファミリー — 必要なものをインストール

vmware-aiops がエントリーポイントです。追加機能を利用するにはモジュールを追加してください。

モジュール	インストール	追加される機能
vmware-monitor	uv tool install vmware-monitor	読み取り専用のインベントリ、アラーム、イベント
vmware-storage	uv tool install vmware-storage	iSCSI、vSAN、データストアの管理
vmware-vks	uv tool install vmware-vks	Tanzu Kubernetes（vSphere 8.x 以降）
vmware-nsx	uv tool install vmware-nsx-mgmt	NSX ネットワーク：セグメント、ゲートウェイ、NAT
vmware-nsx-security	uv tool install vmware-nsx-security	DFW マイクロセグメンテーション、セキュリティグループ
vmware-aria	uv tool install vmware-aria	Aria Ops のメトリクス、アラート、キャパシティ
vmware-avi	uv tool install vmware-avi	AVI ロードバランサー、ALB、AKO、Ingress

各モジュールは独立しています。ツールの数を抑えることで、ローカルモデル（Ollama、Qwen）の精度を保てます。

このスキルを使用する場面

• VM の電源オン／オフ、作成、削除、スナップショット作成、クローン作成、または移行
• OVA、テンプレート、リンククローン、またはバッチ仕様から VM をデプロイ
• VM 内でのコマンド実行やファイル転送（ゲスト操作）
• クラスターの作成／設定（HA/DRS）
• デプロイ可能なイメージを探すためのデータストアの閲覧
• ロールバックを含む複数ステップ操作の計画と実行
• vCenter で発生したアラームの一覧表示、確認、解除（解除対象はエンティティタイプとステータスで照合します。MCP ツールのセクションを参照）

次の操作には、対応するスキルを使用してください：

• インベントリ、健全性、アラーム、VM 情報 → vmware-monitor
• iSCSI、vSAN、データストアの管理 → vmware-storage
• Tanzu Kubernetes（Supervisor、Namespace、TKC）→ vmware-vks
• 負荷分散、AVI/ALB、AKO、Ingress → vmware-avi

関連スキル — スキルの振り分け

ユーザーの意図	推奨スキル
読み取り専用の監視、リスクゼロ	vmware-monitor (uv tool install vmware-monitor)
ストレージ：iSCSI、vSAN、データストア	vmware-storage (uv tool install vmware-storage)
VM のライフサイクル、デプロイ、ゲスト操作	vmware-aiops ← このスキル
Tanzu Kubernetes（vSphere 8.x 以降）	vmware-vks (uv tool install vmware-vks)
NSX ネットワーク：セグメント、ゲートウェイ、NAT	vmware-nsx (uv tool install vmware-nsx-mgmt)
NSX セキュリティ：DFW ルール、セキュリティグループ	vmware-nsx-security (uv tool install vmware-nsx-security)
Aria Ops：メトリクス、アラート、キャパシティ	vmware-aria (uv tool install vmware-aria)
承認を伴う複数ステップのワークフロー	vmware-pilot
コンプライアンスベースライン（CIS / 等保 / PCI-DSS）、ドリフト検出、LLM 修復アドバイザー	vmware-harden (uv tool install vmware-harden)
ロードバランサー、AVI、ALB、AKO、Ingress	vmware-avi (uv tool install vmware-avi)
監査ログのクエリ	vmware-policy (vmware-audit CLI)

一般的なワークフロー

診断調査：「X の動作が遅い／失敗する／停止しているのはなぜか」という問題を修復する前に、references/investigation-protocol.md に従ってください。根本原因を特定するための4つの完全性基準と、調査を深めるループが定められています。L3 以上の書き込みツールを呼び出すのは、4つの基準を満たし、ユーザーが修復計画を承認した後に限ってください。

クラスターの健全性のトリアージ（「今、何が起きていますか？」）

特定の VM を詳しく調べる前に、「何か問題が発生していますか？」と確認する場合は、ここから始めてください。読み取り専用の集約情報を vmware-monitor に委任します。トリアージから対処までを1つの会話で行えるよう、このスキルから利用できます。

1. 概要を確認する --> get_cluster_health_summary（MCP）または vmware-aiops summary（CLI）を実行します。まず top_issues を確認してください。切断されたホスト、赤または黄のアラーム、キャパシティの逼迫など、優先順位が付けられた異常と、それぞれの詳細調査のヒントが表示されます。クラスターごとの表は状況を把握するためのものです
2. 検出された問題に対処する --> host_down の行があればホストを調査します。アラームがあれば acknowledge_vcenter_alarm / reset_vcenter_alarm を実行します。影響が疑われる高負荷の VM があれば、調査プロトコルに従った後で migrate_vm または reconfigure_vm を実行します
3. スナップショットを保存／共有する --> vmware-aiops summary --html を実行すると、オフラインで確認できるタイムスタンプ付き HTML ファイルが生成されます（vmware-monitor と同じレンダラーを使用）
4. vmware-monitor がインストールされていない場合 --> AIops はこのコマンド／ツールを vmware-monitor に委任するため、利用できません。vmware-monitor をインストールするか、このスキルのオブジェクトごとの詳細な読み取りツールを使用してください

オブジェクト中心の調査 → 実行（変更前に掘り下げる）

判断：トリアージで問題のあるオブジェクトが示されたら、操作を実行する前に、相関する読み取りを1回行って掘り下げます。このバンドルは、オブジェクトとその周辺のインフラストラクチャ、最近の履歴をまとめるため、推測ではなく全体像をあなたとオペレーターが把握できます。AIops は対話型のエントリーポイントなので、トリアージ → 調査 → 実行を1つの会話内で進められます。

1. 環境全体 --> get_cross_vcenter_attention（すべての vCenter を対象に「今、注意が必要なのは何ですか？」）。vCenter が1つだけ設定されている場合は、get_cluster_health_summary に進みます
2. フラグが立ったオブジェクトを掘り下げます（階層を提示し、明確な場合は質問を省略します）：
   • VM --> investigate_vm → 状態、実行先のホスト、クラスタのコンテキスト、接続先のデータストア、スナップショット、アラームと最近の変更、パフォーマンスシグナル、相関イベントのタイムライン
   • ホスト --> investigate_host、データストア --> investigate_datastore
3. 次に、証拠に基づいて操作します → たとえば、バンドルで過負荷のホスト上に応答しない VM が示された場合は migrate_vm を実行し、データストアが満杯の場合は、バンドルで明らかになった不要なスナップショットに対して delete_vm_snapshot を実行します。破壊的な操作の前に、調査プロトコルに従ってください
4. hours=72 で対象期間を広げます。--html でオフラインスナップショットを生成します（掘り下げセクションはネイティブに折りたたまれ、アップロードはされません）
5. オブジェクト名が不明な場合 --> バンドルは、オブジェクトの一覧表示方法を示す説明付きエラーを返します。正確な名前を取得して再試行してください。vmware-monitor がインストールされていない場合 --> これらの委譲ツールは利用できません

ラボ環境のデプロイ

事前確認（盲目的な手順ではなく、状況に基づいて判断）：

• 空き容量：対象データストアには、OVA サイズの2倍以上の空き容量が必要です（差分ファイル＋シンプロビジョニングのオーバーヘッド）。
• 名前の付け方：TTL のクリーンアップ監査証跡が有意義になるよう、日付または所有者をプレフィックスにします（lab-2026-04-30-alice）。
• TTL：必ず設定してください。1回のテストセッションなら480分、1週間のサンドボックスなら7200分です。TTL を設定せずに「ラボ」VM をデプロイしてはいけません — 午前3時にデータストアがいっぱいになる原因になります。
• スナップショットのタイミング：ベースラインは、プロビジョニングが成功した後に取得してください。プロビジョニング前のスナップショットは、空のチェックポイントにすぎません。

手順：

1. vmware-aiops datastore browse <ds> --pattern "*.ova" → イメージの存在とサイズを確認します
2. vmware-aiops deploy ova <path> --name <date>-<owner>-<purpose> --datastore <ds>
3. vmware-aiops vm guest-exec <name> --cmd /usr/bin/python3 --args "setup.py" --user admin → 終了コードが0でない場合は、停止し、プロビジョニングが不完全な VM のスナップショットを作成しないでください
4. vmware-aiops vm snapshot-create <name> --name baseline（複数回のテストを行う場合のみ。1回限りなら省略）
5. vmware-aiops vm set-ttl <name> --minutes 480

テスト用の一括クローン

事前確認：

• ソース VM の状態：電源オフが最も安全です。電源オンの場合は、VMware Tools が実行中で、クワイエス処理に対応している必要があります。そうでないと、クローンのディスク状態が不整合になる可能性があります。
• 容量の計算：free_space ≥ source.size × count × 1.2（フルクローン）または ≥ count × 2 GB（リンククローン、差分のみ）。
• 判断基準：count > 10 の場合はリンククローンを使用します（deploy linked-clone）。クローンごとの所要時間は分単位ではなく秒単位で、ストレージ使用量は約100分の1です。トレードオフとして、リンククローンはソースのスナップショットに依存するため、そのスナップショットを削除するとすべての子クローンが破損します。
• ネットワーク：200を超えるバッチでは、vSphere の MAC プールが枯渇する可能性があります。
• TTL：すべてのクローンに TTL が必要です。プランのメタデータを使用して所有者を追跡してください。
• 権限：get_access_info(tool="clone_vm")（CLI vmware-aiops access-info --tool clone_vm）— ルートフォルダーのみです。undetermined は許可されていません。

手順：

1. create_vm_plan で、クローン作成＋再構成＋TTL 設定のステップを VM ごとにまとめます（各クローン単位でアトミック）。
2. ユーザーとプランを確認し、件数、データストア、取り消し不能な操作に関する警告を提示します
3. apply_vm_plan — 最初の失敗時に停止します（意図された動作です。自動で再開しないでください）
4. 失敗した場合：rollback_vm_plan → 完了済みのクローンを元に戻します。再試行の前に、ロールバックを手動で確認してください

VM を別のホストに移行する

事前確認（移行を実行する前に、すべての項目を満たす必要があります）：

• CPU の互換性：移行先ホストの CPU ファミリーが移行元と一致しているか、クラスターが EVC モードである必要があります。互換性のない CPU 間でライブ移行すると、移行中に失敗し、VM が応答不能な状態になる可能性があります。
• ネットワークの同等性：VM が使用するすべてのポートグループが、同じ VLAN で移行先ホストの vSwitch に存在する必要があります。ポートグループがない場合、移行後に vNIC が切断されます。
• ストレージの可視性：移行先ホストから VM のすべてのデータストアが認識できる必要があります。認識できない場合は、ホスト移行ではなく Storage vMotion となり、別の（低速な）操作です。
• アフィニティルール：VM が DRS ホストアフィニティルールによって移行元に固定されている場合、移行すると意図に反してルールに違反します。まず cluster info を確認してください。
• ハードウェアパススルー：PCI パススルー（GPU、USB）を使用する VM はライブ移行できません。コールド移行の時間枠を設定してください。

手順：

1. vmware-monitor vm info <name> で VM の状態と現在のホストを確認します。
2. 移行先ホストを確認します。同じクラスターに属し、EVC 互換性があり、必要なネットワークとデータストアを備えていることを確認します。
3. vmware-aiops vm migrate <name> --to-host <target> を実行し、タスクの完了を待ちます。コマンドの戻りだけで成功したと判断しないでください。
4. 事後確認：vm info で、新しいホストに移行されていること、電源状態が変わっていないこと、vNIC が接続されていることを確認します。

使用モード

シナリオ	推奨	理由
ローカル／小規模モデル（Ollama、Qwen）	CLI	MCP の約 8K トークンに対して約 2K トークン
クラウドモデル（Claude、GPT-4o）	どちらでも	MCP では構造化 JSON の入出力が可能
自動化パイプライン	MCP	型安全なパラメーター、構造化された出力

MCP ツール（61 — 読み取り 18、書き込み 43）

カテゴリー	ツール	読み取り／書き込み
VM ライフサイクル（16）	list_vm_ttls、list_vm_snapshots、get_vm_task_status	読み取り
	power_on_vm、power_off_vm、create_vm、reconfigure_vm、clone_vm、migrate_vm、delete_vm、create_vm_snapshot、revert_vm_snapshot、delete_vm_snapshot、set_vm_ttl、cancel_vm_ttl、restore_vm_clean_slate	書き込み
デプロイ（8）	deploy_vm_from_ova、deploy_vm_from_template、deploy_linked_clone、attach_iso_to_vm、convert_vm_to_template、batch_clone_vms、batch_linked_clone_vms、batch_deploy_from_spec	書き込み
ゲスト操作（5）	run_vm_guest_command、run_vm_guest_command_with_output、upload_vm_guest_file、download_vm_guest_file、provision_vm_guest	書き込み
計画／適用（4）	list_vm_plans	読み取り
	create_vm_plan、apply_vm_plan、rollback_vm_plan	書き込み
データストア（2）	browse_datastore、scan_all_datastore_images	読み取り
ネットワーク（7）	list_dvs_portgroups、list_host_vmks、ping_from_vmk	読み取り
	create_dvs_portgroup、add_host_vmk、remove_host_vmk、set_vmk_service	書き込み
クラスター（10）	get_cluster_info、list_drs_rules	読み取り
	create_cluster、delete_cluster、add_cluster_host、remove_cluster_host、configure_cluster、set_drs_rule_enabled、create_drs_rule、delete_drs_rule	書き込み
アラーム管理（3）	list_vcenter_alarms	読み取り
	acknowledge_vcenter_alarm、reset_vcenter_alarm	書き込み
クラスターのトリアージ（1）	get_cluster_health_summary（vmware-monitor に処理を委譲）	読み取り
オブジェクト調査（4）	investigate_vm、investigate_host、investigate_datastore、get_cross_vcenter_attention（すべて vmware-monitor に処理を委譲）	読み取り
アクセス（1）	get_access_info	読み取り

リストのエンベロープ：読み取り用リストツールの browse_datastore、list_vcenter_alarms、list_vm_plans、list_vm_snapshots、list_vm_ttls は、単独の配列ではなく {items, returned, limit, total, truncated, hint} を返します。items から行を読み取り、一覧が完全かどうかを判断する前に truncated を確認してください。truncated: false で items が空の場合は、確認した結果該当項目がなかったことを意味し、失敗ではありません。書き込み用の batch_* ツールは、構造上すべてを含む単独のリストを引き続き返します。理由、total のセマンティクス、エラー形式については、references/capabilities.md を参照してください。 読み取り／書き込みの分離：[READ] の docstring マーカーによると、18 個のツールは読み取り専用で、43 個は状態を変更します。制御については監査と安全性を参照してください。set_vm_ttl は、無人での自動削除をスケジュールします。

ネットワーク書き込みの制御：4 つすべてのネットワーク書き込みは、プレビューと確認が必要です。confirm=False（デフォルト）の場合、書き込みは行わず、正確な仕様を返します。remove_host_vmk はフェイルクローズです。vmk がホストサービス（管理／vMotion／vSAN）に選択されている場合、デフォルト以外のネットスタック（NSX TEP、専用の vMotion スタック）に属している場合、デフォルトゲートウェイルートを持つ場合、またはこれらを検証できない場合は、削除を拒否します。絶対的ではない保護を無効にするには、force_unprotected=True を指定してください。ホストで管理が有効になっている vmk が 1 つだけの場合、その vmk はオーバーライド指定の有無にかかわらず削除できません。set_vmk_service もフェイルクローズです。ホストのサービスマップを読み取れない場合は、どちらの方向の変更も拒否します。また、ホストで管理が有効になっている vmk が 1 つだけの場合、そこから management のタグを外す操作は（オーバーライド指定があっても）拒否します。呼び出しは、タグを外そうとしているインターフェイスを経由します。

DRS ルールの制御：set_drs_rule_enabled、create_drs_rule、delete_drs_rule は、プレビューと確認が必要で、冪等です（一致する状態の場合、書き込みを行わない no-op を返します）。create_drs_rule が扱うのは VM-VM のアフィニティ／アンチアフィニティのみです（異なる VM が 2 台以上で、すべてクラスターのメンバーであること）。VM-Host ルールは list_drs_rules で読み取れますが、管理には vSphere UI を使用してください。delete_drs_rule はVM-VM 以外のルールを拒否します（ライセンスやコンプライアンスに関する配置制約が含まれる可能性があるためです）。誤って削除した場合に監査証跡から再作成できるよう、プレビューと結果の両方にルールの定義全体を記録します。

アラームリセットの影響範囲：vSphere にはアラームごとのクリア API がありません。reset_vcenter_alarm は AlarmManager.ClearTriggeredAlarms を使用します。これにより、指定したアラームと同じエンティティタイプ（ホスト／VM／すべて）かつ現在のステータス（赤／黄）に一致するトリガー済みアラームがすべてクリアされます。指定したアラームだけではありません。MCP の呼び出しのみでは、クリア対象となるすべてのアラームがプレビューに表示されます（blast_radius.will_clear）。confirm=True を指定するとクリアされ、その対象範囲は scope に表示されます。入力ミスがある場合は、何もクリアせずにすぐにエラーになります。

CLI クイックリファレンス

# VM operations
vmware-aiops vm power-on <name> [--target <t>]
vmware-aiops vm power-off <name> [--force]
vmware-aiops vm create <name> --cpu 4 --memory 8192 --disk 100
vmware-aiops vm delete <name>
vmware-aiops vm clone <name> --new-name <new> [--to-host <host>] [--to-datastore <ds>] [--power-on]
vmware-aiops vm migrate <name> --to-host <host> [--to-datastore <ds>]
vmware-aiops vm snapshot-create <name> --name <snap> [--description <text>] [--memory]
vmware-aiops vm snapshot-list <name>
vmware-aiops vm snapshot-revert <name> --name <snap>
vmware-aiops vm snapshot-delete <name> --name <snap> [--remove-children] [--no-wait]
vmware-aiops vm task-status <task-id>                      # poll an async (--no-wait) operation by id
vmware-aiops vm set-ttl <name> --minutes 480 [--dry-run]   # double confirm; daemon auto-deletes VM on expiry

# Guest operations (requires VMware Tools)
vmware-aiops vm guest-exec <name> --cmd <script-path> --args "<args>" --user <username>
vmware-aiops vm guest-upload <name> --local ./script.sh --guest /tmp/script.sh --user <username>

# Deploy
vmware-aiops deploy ova <path> --name <vm> --datastore <ds>
vmware-aiops deploy linked-clone --source <vm> --snapshot <snap> --name <new>

# Cluster
vmware-aiops cluster create <name> --ha --drs
vmware-aiops cluster info <name>
vmware-aiops cluster drs-rules <name>                                     # list DRS rules
vmware-aiops cluster drs-rule-set <name> --rule <r> --enable|--disable [--dry-run]
vmware-aiops cluster drs-rule-create <name> --rule <r> --type antiAffinity --vm <vm1> --vm <vm2> [--disabled] [--dry-run]
vmware-aiops cluster drs-rule-delete <name> --rule <r> [--dry-run]        # VM-VM only; double confirm

# Datastore
vmware-aiops datastore browse <ds> --pattern "*.ova"

# Alarm management
vmware-aiops alarm list [--target <t>]
vmware-aiops alarm acknowledge <entity_name> <alarm_name> [--target <t>]
vmware-aiops alarm reset <entity_name> <alarm_name> [--target <t>]   # double confirm; see blast radius above

# Family
vmware-aiops hub status        # show installed family members + install commands

CLI の完全なリファレンスについては、references/cli-reference.md を参照してください。

トラブルシューティング

「VM が見つかりません」エラー

vSphere では VM 名の大文字と小文字が区別されます。vmware-monitor inventory vms で表示される正確な名前を使用してください。

ゲスト実行の出力が空になる

run_vm_guest_command ではなく run_vm_guest_command_with_output を使用してください。標準出力と標準エラーを自動的に取得します。基本の run_vm_guest_command が返すのは終了コードのみです。

OVA のデプロイがタイムアウトする

サイズの大きい OVA ファイル（10 GB 超）は、デフォルトの 120 秒のタイムアウトを超える場合があります。アップロードは HTTP NFC リース経由で行われます。vmware-aiops の実行マシンと ESXi 間のネットワークが安定していることを確認してください。

スナップショットの削除に時間がかかる／「N 秒後も実行中」と表示される

サイズの大きいスナップショットを削除すると、その差分ディスクが統合されるため、数分かかることがよくあります。vm snapshot-delete は最大 30 分待機します。「実行中だが失敗ではない」というメッセージとタスク ID が表示された場合、削除は失敗していません。vm task-status <task-id> で状態を確認してください。コマンドを再実行しないでください。サイズの大きいスナップショットの場合は、vm snapshot-delete <name> --name <snap> --no-wait を使用して、状態を確認してください。

プランの適用が途中で失敗する

vmware-aiops plan list を実行して、失敗したプランのステータスを確認してください。rollback_vm_plan でロールバックするかどうかをユーザーに確認してください。元に戻せないステップ（delete_vm）は、ロールバック時にスキップされます。

接続拒否／SSL エラー

1. 接続先に到達できることを確認します：vmware-aiops doctor
2. 自己署名証明書の場合：config.yaml で verify_ssl: false を設定します（ラボ環境のみ）。

すべてのコマンドが「session is not authenticated」で失敗する

アカウントに vSphere ロールがありません。vCenter のルートフォルダーに Read-Only 以上のロールを割り当ててください。このケースは vmware-aiops doctor に具体的に表示されます。

セットアップ

uv tool install vmware-aiops==2.4.2
mkdir -p ~/.vmware-aiops
vmware-aiops init  # generates config.yaml and .env templates
chmod 600 ~/.vmware-aiops/.env

セットアップガイド、セキュリティの詳細、AI プラットフォームとの互換性については、references/setup-guide.md を参照してください。

ライセンス

MIT — github.com/vmware-skills/VMware-AIops