feat(sdn): added custom resource to apply sdn configurations (#2127)

* feat(sdn): added custom resource to apply sdn configurations
* fix(sdn): proper handling of pending state

---------

Signed-off-by: MacherelR <[email protected]>
Signed-off-by: Pavel Boldyrev <[email protected]>
Co-authored-by: Pavel Boldyrev <[email protected]>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: 3 people

docs/data-sources/virtual_environment_sdn_zone_evpn.md

@@ -58,7 +58,9 @@ output "data_proxmox_virtual_environment_sdn_zone_evpn" {
 - `ipam` (String) IP Address Management system.
 - `mtu` (Number) MTU value for the zone.
 - `nodes` (Set of String) The Proxmox nodes which the zone and associated VNets are deployed on
+- `pending` (Boolean) Indicates if the zone has pending configuration changes that need to be applied.
 - `primary_exit_node` (String) Primary exit node for EVPN.
 - `reverse_dns` (String) Reverse DNS API server address.
 - `rt_import` (String) Route target import for EVPN. Must be in the format '<ASN>:<number>' (e.g., '65000:65000').
+- `state` (String) Indicates the current state of the zone.
 - `vrf_vxlan` (Number) VRF VXLAN-ID used for dedicated routing interconnect between VNets. It must be different than the VXLAN-ID of the VNets.

docs/data-sources/virtual_environment_sdn_zone_qinq.md

@@ -49,6 +49,8 @@ output "data_proxmox_virtual_environment_sdn_zone_qinq" {
 - `ipam` (String) IP Address Management system.
 - `mtu` (Number) MTU value for the zone.
 - `nodes` (Set of String) The Proxmox nodes which the zone and associated VNets are deployed on
+- `pending` (Boolean) Indicates if the zone has pending configuration changes that need to be applied.
 - `reverse_dns` (String) Reverse DNS API server address.
 - `service_vlan` (Number) Service VLAN tag for QinQ. The tag must be between `1` and `4094`.
 - `service_vlan_protocol` (String) Service VLAN protocol for QinQ. The protocol must be `802.1ad` or `802.1q`.
+- `state` (String) Indicates the current state of the zone.

docs/data-sources/virtual_environment_sdn_zone_simple.md

@@ -45,4 +45,6 @@ output "data_proxmox_virtual_environment_sdn_zone_simple" {
 - `ipam` (String) IP Address Management system.
 - `mtu` (Number) MTU value for the zone.
 - `nodes` (Set of String) The Proxmox nodes which the zone and associated VNets are deployed on
+- `pending` (Boolean) Indicates if the zone has pending configuration changes that need to be applied.
 - `reverse_dns` (String) Reverse DNS API server address.
+- `state` (String) Indicates the current state of the zone.

docs/data-sources/virtual_environment_sdn_zone_vlan.md

@@ -47,4 +47,6 @@ output "data_proxmox_virtual_environment_sdn_zone_vlan" {
 - `ipam` (String) IP Address Management system.
 - `mtu` (Number) MTU value for the zone.
 - `nodes` (Set of String) The Proxmox nodes which the zone and associated VNets are deployed on
+- `pending` (Boolean) Indicates if the zone has pending configuration changes that need to be applied.
 - `reverse_dns` (String) Reverse DNS API server address.
+- `state` (String) Indicates the current state of the zone.

docs/data-sources/virtual_environment_sdn_zone_vxlan.md

@@ -47,4 +47,6 @@ output "data_proxmox_virtual_environment_sdn_zone_vxlan" {
 - `mtu` (Number) MTU value for the zone.
 - `nodes` (Set of String) The Proxmox nodes which the zone and associated VNets are deployed on
 - `peers` (Set of String) A list of IP addresses of each node in the VXLAN zone. This can be external nodes reachable at this IP address. All nodes in the cluster need to be mentioned here
+- `pending` (Boolean) Indicates if the zone has pending configuration changes that need to be applied.
 - `reverse_dns` (String) Reverse DNS API server address.
+- `state` (String) Indicates the current state of the zone.

docs/data-sources/virtual_environment_sdn_zones.md

@@ -70,10 +70,12 @@ Read-Only:
 - `mtu` (Number)
 - `nodes` (Set of String)
 - `peers` (Set of String)
+- `pending` (Boolean)
 - `primary_exit_node` (String)
 - `reverse_dns` (String)
 - `rt_import` (String)
 - `service_vlan` (Number)
 - `service_vlan_protocol` (String)
+- `state` (String)
 - `type` (String)
 - `vrf_vxlan` (Number)

docs/resources/virtual_environment_sdn_applier.md

@@ -0,0 +1,60 @@
+---
+layout: page
+title: proxmox_virtual_environment_sdn_applier
+parent: Resources
+subcategory: Virtual Environment
+description: |-
+  EXPERIMENTAL Triggers Proxmox's SDN Apply (equivalent to PUT /cluster/sdn).Intended to be used with replace_triggered_by so it runs after SDN objects change.
+---
+
+# Resource: proxmox_virtual_environment_sdn_applier
+
+**EXPERIMENTAL** Triggers Proxmox's SDN **Apply** (equivalent to `PUT /cluster/sdn`).Intended to be used with `replace_triggered_by` so it runs after SDN objects change.
+
+## Example Usage
+
+```terraform
+resource "proxmox_virtual_environment_sdn_zone_simple" "test_zone_1" {
+  id    = "tZone1"
+  nodes = [data.proxmox_virtual_environment_nodes.example.names]
+  mtu   = 1496
+
+  depends_on = [
+    proxmox_virtual_environment_sdn_applier.finalizer
+  ]
+}
+
+resource "proxmox_virtual_environment_sdn_zone_simple" "test_zone_2" {
+  id    = "tZone2"
+  nodes = [data.proxmox_virtual_environment_nodes.example.names]
+  mtu   = 1496
+
+  depends_on = [
+    proxmox_virtual_environment_sdn_applier.finalizer
+  ]
+}
+
+resource "proxmox_virtual_environment_sdn_applier" "applier" {
+  lifecycle {
+    replace_triggered_by = [
+      proxmox_virtual_environment_sdn_zone_simple.test_zone_1,
+      proxmox_virtual_environment_sdn_zone_simple.test_zone_2,
+    ]
+  }
+
+  depends_on = [
+    proxmox_virtual_environment_sdn_zone_simple.test_zone_1,
+    proxmox_virtual_environment_sdn_zone_simple.test_zone_2,
+  ]
+}
+
+resource "proxmox_virtual_environment_sdn_applier" "finalizer" {
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Read-Only
+
+- `id` (String) Opaque identifier set to the Unix timestamp (milliseconds) when the apply was executed.

docs/resources/virtual_environment_sdn_zone_evpn.md

@@ -61,6 +61,11 @@ resource "proxmox_virtual_environment_sdn_zone_evpn" "example" {
 - `reverse_dns` (String) Reverse DNS API server address.
 - `rt_import` (String) Route target import for EVPN.
 
+### Read-Only
+
+- `pending` (Boolean) Indicates if the zone has pending configuration changes that need to be applied.
+- `state` (String) Indicates the current state of the zone.
+
 ## Import
 
 Import is supported using the following syntax:

docs/resources/virtual_environment_sdn_zone_qinq.md

@@ -49,6 +49,11 @@ resource "proxmox_virtual_environment_sdn_zone_qinq" "example" {
 - `reverse_dns` (String) Reverse DNS API server address.
 - `service_vlan_protocol` (String) Service VLAN protocol for QinQ. The protocol must be `802.1ad` or `802.1q`.
 
+### Read-Only
+
+- `pending` (Boolean) Indicates if the zone has pending configuration changes that need to be applied.
+- `state` (String) Indicates the current state of the zone.
+
 ## Import
 
 Import is supported using the following syntax:

docs/resources/virtual_environment_sdn_zone_simple.md

@@ -43,6 +43,11 @@ resource "proxmox_virtual_environment_sdn_zone_simple" "example" {
 - `mtu` (Number) MTU value for the zone.
 - `reverse_dns` (String) Reverse DNS API server address.
 
+### Read-Only
+
+- `pending` (Boolean) Indicates if the zone has pending configuration changes that need to be applied.
+- `state` (String) Indicates the current state of the zone.
+
 ## Import
 
 Import is supported using the following syntax: