Merge pull request #19 from platform9/feat/networking-qos

feat(networking): Neutron QoS family (policy + bandwidth-limit / DSCP / minimum-bandwidth rules)

Author: PF9-pushkar

CHANGELOG.md

@@ -67,6 +67,10 @@ All notable changes to this project are documented here. The format is based on
   `payload`) and `pcd_keymanager_container` (grouped secrets) resources plus a
   `pcd_keymanager_secret` data source (optionally fetches the payload). Barbican identifies
   objects by URL refs; the resources expose the full ref and use the bare UUID as the ID.
+- Network QoS (Neutron `qos` extension) — Phase 3: `pcd_networking_qos_policy` and its three
+  rule types — `pcd_networking_qos_bandwidth_limit_rule`, `pcd_networking_qos_dscp_marking_rule`,
+  `pcd_networking_qos_minimum_bandwidth_rule` — plus a `pcd_networking_qos_policy` data source.
+  Rules are nested under a policy and imported by a composite `<qos_policy_id>/<rule_id>` ID.
 
 - Registry documentation generation wired via `tfplugindocs` (`make generate`) — renders
   `docs/` for every resource and data source plus the provider index from schema

DECISIONS.md

@@ -39,6 +39,7 @@ yet passable on this lab (reason noted). Generated registry docs are not committ
 | Load balancing (Octavia) | `pcd_lb_loadbalancer`, `_listener`, `_pool`, `_member`, `_monitor`, `_l7policy`, `_l7rule` + `_loadbalancer` DS | **PENDING** — Phase 3, code-complete; per-LB wait-for-`ACTIVE` lifecycle, root-LB resolution for every child, echo-only churny fields. Full-tree acc test + examples written. Octavia is live on the lab (Step 0), but LB provisioning needs a working amphora/provider driver; not yet run live (credentials unavailable this session). |
 | DNS (Designate) | `pcd_dns_zone`, `pcd_dns_recordset` + `pcd_dns_zone` DS | **PENDING** — Phase 3, code-complete; async create/update/delete → wait-for-`ACTIVE`/404. Acc test (zone + recordset + import) + examples written. Designate is live on the lab (Step 0) and DNS needs no compute/storage backend, so this should pass live — not yet run this session (credentials unavailable). |
 | Key management (Barbican) | `pcd_keymanager_secret`, `pcd_keymanager_container` + `pcd_keymanager_secret` DS | **PENDING** — Phase 3, code-complete; write-only echo-only `payload`, URL-ref→UUID id handling, wait-for-`ACTIVE` only on create-with-payload. Acc test (secret + container + data source + import) + examples written. Barbican is live on the lab (Step 0) and needs no compute/storage backend, so this should pass live — not yet run this session (credentials unavailable). |
+| Network QoS (Neutron) | `pcd_networking_qos_policy`, `_qos_bandwidth_limit_rule`, `_qos_dscp_marking_rule`, `_qos_minimum_bandwidth_rule` + `_qos_policy` DS | **PENDING** — Phase 3, code-complete; rules nested under a policy with composite `<policy_id>/<rule_id>` import, tags via the attributes-tags extension (`policies` type), `ForceNew` on `qos_policy_id`. Full-tree acc test (policy + all three rules + data source + import) + examples written. Depends only on the Neutron `qos` extension (no compute/storage backend), so this should pass live — not yet run this session (credentials unavailable). |
 
 Both PENDING items are lab-side configuration gaps (Platform9 / lab-ops), not provider
 defects; their acceptance tests flip green on a properly-configured PCD cloud.

examples/data-sources/pcd_networking_qos_policy/data-source.tf

@@ -0,0 +1,3 @@
+data "pcd_networking_qos_policy" "example" {
+  name = "tf-example-qos"
+}

examples/resources/pcd_networking_qos_bandwidth_limit_rule/import.sh

@@ -0,0 +1 @@
+terraform import pcd_networking_qos_bandwidth_limit_rule.example <qos_policy_id>/<rule_id>

examples/resources/pcd_networking_qos_bandwidth_limit_rule/resource.tf

@@ -0,0 +1,10 @@
+resource "pcd_networking_qos_policy" "example" {
+  name = "tf-example-qos"
+}
+
+resource "pcd_networking_qos_bandwidth_limit_rule" "example" {
+  qos_policy_id  = pcd_networking_qos_policy.example.id
+  max_kbps       = 3000
+  max_burst_kbps = 300
+  direction      = "egress"
+}

examples/resources/pcd_networking_qos_dscp_marking_rule/import.sh

@@ -0,0 +1 @@
+terraform import pcd_networking_qos_dscp_marking_rule.example <qos_policy_id>/<rule_id>

examples/resources/pcd_networking_qos_dscp_marking_rule/resource.tf

@@ -0,0 +1,8 @@
+resource "pcd_networking_qos_policy" "example" {
+  name = "tf-example-qos"
+}
+
+resource "pcd_networking_qos_dscp_marking_rule" "example" {
+  qos_policy_id = pcd_networking_qos_policy.example.id
+  dscp_mark     = 26
+}

examples/resources/pcd_networking_qos_minimum_bandwidth_rule/import.sh

@@ -0,0 +1 @@
+terraform import pcd_networking_qos_minimum_bandwidth_rule.example <qos_policy_id>/<rule_id>

examples/resources/pcd_networking_qos_minimum_bandwidth_rule/resource.tf

@@ -0,0 +1,9 @@
+resource "pcd_networking_qos_policy" "example" {
+  name = "tf-example-qos"
+}
+
+resource "pcd_networking_qos_minimum_bandwidth_rule" "example" {
+  qos_policy_id = pcd_networking_qos_policy.example.id
+  min_kbps      = 1000
+  direction     = "egress"
+}

examples/resources/pcd_networking_qos_policy/import.sh

@@ -0,0 +1 @@
+terraform import pcd_networking_qos_policy.example <qos_policy_id>