Merge pull request #16 from platform9/feat/lb-octavia

feat(lb): Octavia load-balancer family (pcd_lb_*) — Phase 3

Author: PF9-pushkar

CHANGELOG.md

@@ -54,6 +54,12 @@ All notable changes to this project are documented here. The format is based on
 - Block storage (Cinder v3): `pcd_blockstorage_volume` resource (create/extend/import;
   code-complete — acceptance is blocked on the CE lab having no storage backend, see
   DECISIONS.md) and `pcd_blockstorage_volume` / `pcd_blockstorage_snapshot` data sources.
+- Load balancing (Octavia v2) — Phase 3: `pcd_lb_loadbalancer`, `pcd_lb_listener`,
+  `pcd_lb_pool`, `pcd_lb_member`, `pcd_lb_monitor`, `pcd_lb_l7policy`, `pcd_lb_l7rule`
+  resources and a `pcd_lb_loadbalancer` data source. Every child operation resolves the
+  root load balancer and waits for its `provisioning_status` to return to `ACTIVE` before
+  and after mutating (Octavia serializes changes per load balancer). Code-complete; see
+  DECISIONS.md for live-validation status.
 
 - Registry documentation generation wired via `tfplugindocs` (`make generate`) — renders
   `docs/` for every resource and data source plus the provider index from schema

DECISIONS.md

@@ -36,6 +36,7 @@ yet passable on this lab (reason noted). Generated registry docs are not committ
 | Compute | `pcd_compute_volume_attach` | **PENDING** — code-complete; needs a booted instance **and** a Cinder backend (both lab-blocked). Best-effort volume waiter degrades gracefully without Cinder. |
 | Block storage | `pcd_blockstorage_volume` | **PENDING** — no Cinder storage backend on the lab (`storageBackends={}`); volumes go `creating → error`. Create + waiter + error-detection verified. |
 | Block storage (DS) | `pcd_blockstorage_volume`, `_snapshot` | **PENDING** — untestable without volumes on this lab. |
+| 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). |
 
 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_lb_loadbalancer/data-source.tf

@@ -0,0 +1,3 @@
+data "pcd_lb_loadbalancer" "example" {
+  name = "tf-example-lb"
+}

examples/resources/pcd_lb_l7policy/import.sh

@@ -0,0 +1 @@
+terraform import pcd_lb_l7policy.example <id>

examples/resources/pcd_lb_l7policy/resource.tf

@@ -0,0 +1,33 @@
+resource "pcd_networking_network" "example" {
+  name = "tf-example-lb-net"
+}
+
+resource "pcd_networking_subnet" "example" {
+  network_id = pcd_networking_network.example.id
+  cidr       = "10.0.0.0/24"
+}
+
+resource "pcd_lb_loadbalancer" "example" {
+  name          = "tf-example-lb"
+  vip_subnet_id = pcd_networking_subnet.example.id
+}
+
+resource "pcd_lb_pool" "example" {
+  name            = "tf-example-pool"
+  loadbalancer_id = pcd_lb_loadbalancer.example.id
+  protocol        = "HTTP"
+  lb_method       = "ROUND_ROBIN"
+}
+
+resource "pcd_lb_listener" "example" {
+  loadbalancer_id = pcd_lb_loadbalancer.example.id
+  protocol        = "HTTP"
+  protocol_port   = 80
+}
+
+resource "pcd_lb_l7policy" "example" {
+  name             = "tf-example-l7policy"
+  listener_id      = pcd_lb_listener.example.id
+  action           = "REDIRECT_TO_POOL"
+  redirect_pool_id = pcd_lb_pool.example.id
+}

examples/resources/pcd_lb_l7rule/import.sh

@@ -0,0 +1 @@
+terraform import pcd_lb_l7rule.example <l7policy_id>/<l7rule_id>

examples/resources/pcd_lb_l7rule/resource.tf

@@ -0,0 +1,39 @@
+resource "pcd_networking_network" "example" {
+  name = "tf-example-lb-net"
+}
+
+resource "pcd_networking_subnet" "example" {
+  network_id = pcd_networking_network.example.id
+  cidr       = "10.0.0.0/24"
+}
+
+resource "pcd_lb_loadbalancer" "example" {
+  name          = "tf-example-lb"
+  vip_subnet_id = pcd_networking_subnet.example.id
+}
+
+resource "pcd_lb_pool" "example" {
+  name            = "tf-example-pool"
+  loadbalancer_id = pcd_lb_loadbalancer.example.id
+  protocol        = "HTTP"
+  lb_method       = "ROUND_ROBIN"
+}
+
+resource "pcd_lb_listener" "example" {
+  loadbalancer_id = pcd_lb_loadbalancer.example.id
+  protocol        = "HTTP"
+  protocol_port   = 80
+}
+
+resource "pcd_lb_l7policy" "example" {
+  listener_id      = pcd_lb_listener.example.id
+  action           = "REDIRECT_TO_POOL"
+  redirect_pool_id = pcd_lb_pool.example.id
+}
+
+resource "pcd_lb_l7rule" "example" {
+  l7policy_id  = pcd_lb_l7policy.example.id
+  type         = "HOST_NAME"
+  compare_type = "EQUAL_TO"
+  value        = "www.example.com"
+}

examples/resources/pcd_lb_listener/import.sh

@@ -0,0 +1 @@
+terraform import pcd_lb_listener.example <id>

examples/resources/pcd_lb_listener/resource.tf

@@ -0,0 +1,20 @@
+resource "pcd_networking_network" "example" {
+  name = "tf-example-lb-net"
+}
+
+resource "pcd_networking_subnet" "example" {
+  network_id = pcd_networking_network.example.id
+  cidr       = "10.0.0.0/24"
+}
+
+resource "pcd_lb_loadbalancer" "example" {
+  name          = "tf-example-lb"
+  vip_subnet_id = pcd_networking_subnet.example.id
+}
+
+resource "pcd_lb_listener" "example" {
+  name            = "tf-example-listener"
+  loadbalancer_id = pcd_lb_loadbalancer.example.id
+  protocol        = "HTTP"
+  protocol_port   = 80
+}

examples/resources/pcd_lb_loadbalancer/import.sh

@@ -0,0 +1 @@
+terraform import pcd_lb_loadbalancer.example <id>