feat(netbox): check Netbox version down to minor + allow to bypass check

CHANGELOG.unreleased.md

@@ -12,6 +12,7 @@
 > Users must be able to say: “Nice enhancement, I'm eager to test it”
 
 - [SR/Disks] Display information if the VDI is an empty metadata snapshot (PR [#7970](https://github.com/vatesfr/xen-orchestra/pull/7970))
+- [Netbox] Do not synchronize if detected minor version is not supported (PR [#7992](https://github.com/vatesfr/xen-orchestra/pull/7992))
 - **XO 6**:
   - [Dashboard] Display backup issues data (PR [#7974](https://github.com/vatesfr/xen-orchestra/pull/7974))
 
@@ -47,6 +48,7 @@
 - xen-api patch
 - xo-cli minor
 - xo-server patch
+- xo-server-netbox minor
 - xo-web minor
 
 <!--packages-end-->

docs/advanced.md

@@ -347,7 +347,18 @@ Synchronize your pools, VMs, network interfaces and IP addresses with your [Netb
 
 - `>= 2.10`
 - `3.x`
-- `4.x`
+- `4.0`
+
+:::tip
+For safety, XO will not synchronize your pools if it detects a Netbox version that is not supported. If you wish to change that behavior, edit you `xo-server` configuration like so:
+
+```toml
+[netbox]
+checkNetboxVersion = false
+```
+
+Please be aware that by doing this, a Netbox update might make XO delete some of your data in Netbox.
+:::
 
 ### Netbox side
 

packages/xo-server-netbox/src/index.js

@@ -16,7 +16,7 @@ import slugify from './slugify'
 
 const log = createLogger('xo:netbox')
 
-const SUPPORTED_VERSION = '>=2.10 <5.0'
+const SUPPORTED_VERSION = '>=2.10 <4.1'
 const CLUSTER_TYPE = 'XCP-ng Pool'
 const TYPES_WITH_UUID = ['virtualization.cluster', 'virtualization.virtualmachine', 'virtualization.vminterface']
 const CHUNK_SIZE = 100
@@ -235,10 +235,14 @@ class Netbox {
   }
 
   async #checkNetboxVersion() {
+    if (!this.#xo.config.getOptional('netbox.checkNetboxVersion')) {
+      return
+    }
+
     await this.#fetchNetboxVersion()
     if (this.#netboxVersion === undefined || !semver.satisfies(this.#netboxVersion, SUPPORTED_VERSION)) {
       throw new Error(
-        `Netbox version ${this.#netboxVersion ?? '<2.10'} not supported. Please check https://xen-orchestra.com/docs/advanced.html#netbox`
+        `Netbox version ${this.#netboxVersion ?? '<2.10'} not supported. Please check https://xen-orchestra.com/docs/advanced.html#supported-versions`
       )
     }
   }

packages/xo-server/config.toml

@@ -160,6 +160,9 @@ level = 'info'
 
 [logs.transport.console]
 
+[netbox]
+checkNetboxVersion = true
+
 [plugins]
 lookupPaths = ['./node_modules', '../', '/usr/local/lib/node_modules']