vc-renamer

介紹

一個基於 Python、pyvmomi、questionary 的 vCenter VM/資料夾批次 rename 工具。

主要特色

• 產生的 vm_list.txt 以 tree 結構顯示，左側為 ({moid})，右側為目錄/VM 樹狀結構：

  (group-v123)   ├─ FolderA
  (vm-456)       │ ├─ VM1
  (vm-789)       │ └─ VM2
  (group-v234)   └─ FolderB
  (vm-012)          └─ VM3
  

• 編輯 vm_list.txt 時，可任意調整排序或層級，工具僅根據 moid 比對名稱異動，僅支援 rename，不會自動執行新增/刪除/移動。

• 工具會自動偵測所有 rename 並顯示彩色差異，確認後才會執行。

安裝

1. 安裝 Python 3.8+
2. 安裝 uv
3. 安裝 direnv
4. 建立虛擬環境並安裝依賴：

uv sync

使用方式

1. 編輯 .env 並填入 vCenter 連線資訊
2. 執行

direnv exec $PWD uv run src/vc_renamer/main.py

1. 產生 vm_list.txt，依照 vCenter 目錄結構列出所有 VM/資料夾（含 moid 與 tree 結構）。
2. 支援使用編輯器 vimdiff / VSCode 編輯 vm_list.txt。
3. 編輯後，工具會比對差異，列出名稱異動（rename），並提供確認後執行。

---

參考

• Questionary Checkbox 官方文件
• pyvmomi-community-samples/interactive_wrapper.py