proxsync 2.0.0__tar.gz → 2.0.1__tar.gz

{proxsync-2.0.0/proxsync.egg-info → proxsync-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxsync
-Version: 2.0.0
+Version: 2.0.1
 Summary: NetBox plugin for Proxmox VE inventory synchronization
 Author-email: lixiujie85 <lixiujie85@gmail.com>
 License-Expression: MIT
@@ -114,7 +114,7 @@ Requires-Dist: pytest-cov>=4.0; extra == "dev"
 ### 1. 安裝插件
 
 ```bash
-/opt/netbox/venv/bin/pip install -e /opt/proxsync
+/opt/netbox/venv/bin/pip install proxsync
 ```
 
 ### 2. 啟用插件
@@ -125,14 +125,6 @@ Requires-Dist: pytest-cov>=4.0; extra == "dev"
 PLUGINS = [
     "pve_sync_plugin",
 ]
-
-PLUGINS_CONFIG = {
-    "pve_sync_plugin": {
-        # 也可在 Web UI Settings 頁面設定，此處為預設值
-        "netbox_url": "http://localhost:8001",
-        "netbox_token": "your-netbox-api-token",
-    },
-}
 ```
 
 ### 3. 建立資料表
@@ -149,12 +141,12 @@ cd /opt/netbox/netbox
 sudo systemctl restart netbox netbox-rq
 ```
 
-### 5. 設定排程自動同步（推薦）
+### 5. 設定排程自動同步
 
-在 root crontab 加入以下排程，每 15 分鐘檢查一次是否有到期的同步任務：
+在 crontab 加入以下排程，每 15 分鐘檢查一次是否有到期的同步任務：
 
 ```bash
-sudo crontab -e
+crontab -e
 ```
 
 加入：
@@ -163,7 +155,13 @@ sudo crontab -e
 */15 * * * * cd /opt/netbox/netbox && /opt/netbox/venv/bin/python manage.py run_scheduled_syncs >> /var/log/netbox-pve-scheduled-sync.log 2>&1
 ```
 
-> 設定好 cron 後，只需在 Web UI 各叢集設定中選擇同步週期，系統即會自動執行。
+### 6. 在 Web UI 完成設定
+
+前往 `Plugins → Proxmox Sync → Settings`，填入 NetBox URL、API Token，以及 Telegram 通知設定（可選）。
+
+接著前往 `Plugins → Proxmox Sync → PVE Clusters → Add` 新增第一個 PVE 叢集連線。
+
+> 設定好 cron 後，只需在各叢集設定中選擇同步週期，系統即會自動執行。
 
 ---
 

{proxsync-2.0.0 → proxsync-2.0.1}/README.md

@@ -78,7 +78,7 @@
 ### 1. 安裝插件
 
 ```bash
-/opt/netbox/venv/bin/pip install -e /opt/proxsync
+/opt/netbox/venv/bin/pip install proxsync
 ```
 
 ### 2. 啟用插件
@@ -89,14 +89,6 @@
 PLUGINS = [
     "pve_sync_plugin",
 ]
-
-PLUGINS_CONFIG = {
-    "pve_sync_plugin": {
-        # 也可在 Web UI Settings 頁面設定，此處為預設值
-        "netbox_url": "http://localhost:8001",
-        "netbox_token": "your-netbox-api-token",
-    },
-}
 ```
 
 ### 3. 建立資料表
@@ -113,12 +105,12 @@ cd /opt/netbox/netbox
 sudo systemctl restart netbox netbox-rq
 ```
 
-### 5. 設定排程自動同步（推薦）
+### 5. 設定排程自動同步
 
-在 root crontab 加入以下排程，每 15 分鐘檢查一次是否有到期的同步任務：
+在 crontab 加入以下排程，每 15 分鐘檢查一次是否有到期的同步任務：
 
 ```bash
-sudo crontab -e
+crontab -e
 ```
 
 加入：
@@ -127,7 +119,13 @@ sudo crontab -e
 */15 * * * * cd /opt/netbox/netbox && /opt/netbox/venv/bin/python manage.py run_scheduled_syncs >> /var/log/netbox-pve-scheduled-sync.log 2>&1
 ```
 
-> 設定好 cron 後，只需在 Web UI 各叢集設定中選擇同步週期，系統即會自動執行。
+### 6. 在 Web UI 完成設定
+
+前往 `Plugins → Proxmox Sync → Settings`，填入 NetBox URL、API Token，以及 Telegram 通知設定（可選）。
+
+接著前往 `Plugins → Proxmox Sync → PVE Clusters → Add` 新增第一個 PVE 叢集連線。
+
+> 設定好 cron 後，只需在各叢集設定中選擇同步週期，系統即會自動執行。
 
 ---
 

{proxsync-2.0.0 → proxsync-2.0.1/proxsync.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxsync
-Version: 2.0.0
+Version: 2.0.1
 Summary: NetBox plugin for Proxmox VE inventory synchronization
 Author-email: lixiujie85 <lixiujie85@gmail.com>
 License-Expression: MIT
@@ -114,7 +114,7 @@ Requires-Dist: pytest-cov>=4.0; extra == "dev"
 ### 1. 安裝插件
 
 ```bash
-/opt/netbox/venv/bin/pip install -e /opt/proxsync
+/opt/netbox/venv/bin/pip install proxsync
 ```
 
 ### 2. 啟用插件
@@ -125,14 +125,6 @@ Requires-Dist: pytest-cov>=4.0; extra == "dev"
 PLUGINS = [
     "pve_sync_plugin",
 ]
-
-PLUGINS_CONFIG = {
-    "pve_sync_plugin": {
-        # 也可在 Web UI Settings 頁面設定，此處為預設值
-        "netbox_url": "http://localhost:8001",
-        "netbox_token": "your-netbox-api-token",
-    },
-}
 ```
 
 ### 3. 建立資料表
@@ -149,12 +141,12 @@ cd /opt/netbox/netbox
 sudo systemctl restart netbox netbox-rq
 ```
 
-### 5. 設定排程自動同步（推薦）
+### 5. 設定排程自動同步
 
-在 root crontab 加入以下排程，每 15 分鐘檢查一次是否有到期的同步任務：
+在 crontab 加入以下排程，每 15 分鐘檢查一次是否有到期的同步任務：
 
 ```bash
-sudo crontab -e
+crontab -e
 ```
 
 加入：
@@ -163,7 +155,13 @@ sudo crontab -e
 */15 * * * * cd /opt/netbox/netbox && /opt/netbox/venv/bin/python manage.py run_scheduled_syncs >> /var/log/netbox-pve-scheduled-sync.log 2>&1
 ```
 
-> 設定好 cron 後，只需在 Web UI 各叢集設定中選擇同步週期，系統即會自動執行。
+### 6. 在 Web UI 完成設定
+
+前往 `Plugins → Proxmox Sync → Settings`，填入 NetBox URL、API Token，以及 Telegram 通知設定（可選）。
+
+接著前往 `Plugins → Proxmox Sync → PVE Clusters → Add` 新增第一個 PVE 叢集連線。
+
+> 設定好 cron 後，只需在各叢集設定中選擇同步週期，系統即會自動執行。
 
 ---
 

{proxsync-2.0.0 → proxsync-2.0.1}/pve_sync_plugin/models.py

@@ -93,6 +93,10 @@ class PveSyncJob(NetBoxModel):
             "partial": "warning",
         }.get(self.status, "secondary")
 
+    @property
+    def is_pbs_job(self):
+        return self.cluster_name.startswith("pbs:")
+
     @property
     def error_message(self):
         if not self.details:

{proxsync-2.0.0 → proxsync-2.0.1}/pve_sync_plugin/tasks.py

@@ -252,18 +252,20 @@ def run_pbs_sync_job(job_id, pbs_server_pk):
         syncer.sync()
 
         # Write backup records to PveBackupStatus
+        backup_updated, backup_skipped = None, None
         try:
             backup_records = _fetch_pbs_snapshots(pbs)
-            updated, skipped = _apply_pbs_backup_status(backup_records)
-            job.details["backup_updated"] = updated
-            job.details["backup_skipped"] = skipped
-            logger.info("PBS backup status: %d updated, %d no VM match", updated, skipped)
+            backup_updated, backup_skipped = _apply_pbs_backup_status(backup_records)
+            logger.info("PBS backup status: %d updated, %d no VM match", backup_updated, backup_skipped)
         except Exception as exc:
             logger.warning("PBS backup status sync failed (non-fatal): %s", exc)
 
         job.refresh_from_db()
         job.status = "success"
         job.end_time = timezone.now()
+        if backup_updated is not None:
+            job.details["backup_updated"] = backup_updated
+            job.details["backup_skipped"] = backup_skipped
         job.details.pop("heartbeat", None)
         job.save()
 

{proxsync-2.0.0 → proxsync-2.0.1}/pve_sync_plugin/templates/pve_sync/pvesyncjob.html

@@ -68,8 +68,12 @@
 {% if object.status == "success" %}
   <div class="alert alert-success" role="alert">
     <i class="mdi mdi-check-circle"></i>
-    同步成功完成！共處理 <strong>{{ object.total_vms }}</strong> 台 VM，
-    成功 <strong>{{ object.success_vms }}</strong> 台，耗時 {{ object.duration|floatformat:0 }} 秒。
+    {% if object.is_pbs_job %}
+      PBS 同步成功完成！備份記錄更新 <strong>{{ object.details.backup_updated|default:0 }}</strong> 筆，耗時 {{ object.duration|floatformat:0 }} 秒。
+    {% else %}
+      同步成功完成！共處理 <strong>{{ object.total_vms }}</strong> 台 VM，
+      成功 <strong>{{ object.success_vms }}</strong> 台，耗時 {{ object.duration|floatformat:0 }} 秒。
+    {% endif %}
   </div>
 {% endif %}
 
@@ -131,52 +135,77 @@
     <div class="card">
       <h5 class="card-header">Statistics</h5>
       <table class="table table-hover attr-table">
-        <tr>
-          <th scope="row">Total VMs</th>
-          <td>
-            {% if object.total_vms > 0 %}
-              {{ object.total_vms }}
-            {% elif object.status == "running" %}
-              <span class="text-muted">同步完成後顯示</span>
-            {% else %}
-              0
-            {% endif %}
-          </td>
-        </tr>
-        <tr>
-          <th scope="row">Success</th>
-          <td><span class="text-success">{{ object.success_vms }}</span></td>
-        </tr>
-        <tr>
-          <th scope="row">Failed</th>
-          <td><span class="text-danger">{{ object.failed_vms }}</span></td>
-        </tr>
-        <tr>
-          <th scope="row">Success Rate</th>
-          <td>
-            {% if object.total_vms > 0 %}
-              {{ object.success_rate|floatformat:1 }}%
-            {% else %}
-              —
-            {% endif %}
-          </td>
-        </tr>
-        <tr>
-          <th scope="row">Nodes Offline</th>
-          <td>{{ object.nodes_offline }}</td>
-        </tr>
-        <tr>
-          <th scope="row">Config Drifts</th>
-          <td>{{ object.config_drifts }}</td>
-        </tr>
-        <tr>
-          <th scope="row">Tag Changes</th>
-          <td>{{ object.tag_changes }}</td>
-        </tr>
-        <tr>
-          <th scope="row">Resource Alerts</th>
-          <td>{{ object.resource_alerts }}</td>
-        </tr>
+        {% if object.is_pbs_job %}
+          <tr>
+            <th scope="row">Device Synced</th>
+            <td>
+              {% if object.status == "running" %}
+                <span class="text-muted">同步完成後顯示</span>
+              {% elif object.status == "success" %}
+                <span class="text-success">1</span>
+              {% else %}—{% endif %}
+            </td>
+          </tr>
+          <tr>
+            <th scope="row">Backup Records Updated</th>
+            <td>
+              {% if object.details.backup_updated is not None %}
+                <span class="text-success">{{ object.details.backup_updated }}</span>
+              {% elif object.status == "running" %}
+                <span class="text-muted">同步完成後顯示</span>
+              {% else %}—{% endif %}
+            </td>
+          </tr>
+          <tr>
+            <th scope="row">No VM Match (Skipped)</th>
+            <td>
+              {% if object.details.backup_skipped is not None %}
+                {{ object.details.backup_skipped }}
+              {% else %}—{% endif %}
+            </td>
+          </tr>
+        {% else %}
+          <tr>
+            <th scope="row">Total VMs</th>
+            <td>
+              {% if object.total_vms > 0 %}
+                {{ object.total_vms }}
+              {% elif object.status == "running" %}
+                <span class="text-muted">同步完成後顯示</span>
+              {% else %}0{% endif %}
+            </td>
+          </tr>
+          <tr>
+            <th scope="row">Success</th>
+            <td><span class="text-success">{{ object.success_vms }}</span></td>
+          </tr>
+          <tr>
+            <th scope="row">Failed</th>
+            <td><span class="text-danger">{{ object.failed_vms }}</span></td>
+          </tr>
+          <tr>
+            <th scope="row">Success Rate</th>
+            <td>
+              {% if object.total_vms > 0 %}{{ object.success_rate|floatformat:1 }}%{% else %}—{% endif %}
+            </td>
+          </tr>
+          <tr>
+            <th scope="row">Nodes Offline</th>
+            <td>{{ object.nodes_offline }}</td>
+          </tr>
+          <tr>
+            <th scope="row">Config Drifts</th>
+            <td>{{ object.config_drifts }}</td>
+          </tr>
+          <tr>
+            <th scope="row">Tag Changes</th>
+            <td>{{ object.tag_changes }}</td>
+          </tr>
+          <tr>
+            <th scope="row">Resource Alerts</th>
+            <td>{{ object.resource_alerts }}</td>
+          </tr>
+        {% endif %}
       </table>
     </div>
   </div>

{proxsync-2.0.0 → proxsync-2.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "proxsync"
-version = "2.0.0"
+version = "2.0.1"
 description = "NetBox plugin for Proxmox VE inventory synchronization"
 readme = "README.md"
 requires-python = ">=3.10"