feat: add resource and data source for MAAS zones

docs/data-sources/zone.md

@@ -0,0 +1,25 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "maas_zone Data Source - terraform-provider-maas"
+subcategory: ""
+description: |-
+  Provides details about an existing MAAS zone.
+---
+
+# maas_zone (Data Source)
+
+Provides details about an existing MAAS zone.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) The zone's name.
+
+### Read-Only
+
+- `description` (String) A brief description of the zone.
+- `id` (String) The ID of this resource.

docs/resources/zone.md

@@ -0,0 +1,28 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "maas_zone Resource - terraform-provider-maas"
+subcategory: ""
+description: |-
+  Provides a resource to manage MAAS zones.
+---
+
+# maas_zone (Resource)
+
+Provides a resource to manage MAAS zones.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) The name of the new zone.
+
+### Optional
+
+- `description` (String) A brief description of the new zone.
+
+### Read-Only
+
+- `id` (String) The ID of this resource.

maas/data_source_maas_zone.go

@@ -0,0 +1,49 @@
+package maas
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/canonical/gomaasclient/client"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+func dataSourceMaasZone() *schema.Resource {
+	return &schema.Resource{
+		Description: "Provides details about an existing MAAS zone.",
+		ReadContext: dataSourceZoneRead,
+
+		Schema: map[string]*schema.Schema{
+			"description": {
+				Type:        schema.TypeString,
+				Computed:    true,
+				Description: "A brief description of the zone.",
+			},
+			"name": {
+				Type:        schema.TypeString,
+				Required:    true,
+				Description: "The zone's name.",
+			},
+		},
+	}
+}
+
+func dataSourceZoneRead(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*client.Client)
+
+	zone, err := getZone(client, d.Get("name").(string))
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	d.SetId(fmt.Sprintf("%v", zone.ID))
+	tfstate := map[string]interface{}{
+		"name":        zone.Name,
+		"description": zone.Description,
+	}
+	if err := setTerraformState(d, tfstate); err != nil {
+		return diag.FromErr(err)
+	}
+
+	return nil
+}

maas/data_source_maas_zone_test.go

@@ -0,0 +1,47 @@
+package maas_test
+
+import (
+	"fmt"
+	"terraform-provider-maas/maas/testutils"
+	"testing"
+
+	"github.com/canonical/gomaasclient/entity"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/acctest"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+)
+
+func TestAccDataSourceMaasZone_basic(t *testing.T) {
+
+	var zone entity.Zone
+	description := "Test description"
+	name := acctest.RandomWithPrefix("tf-zone-")
+
+	checks := []resource.TestCheckFunc{
+		testAccMaasZoneCheckExists("maas_zone.test", &zone),
+		resource.TestCheckResourceAttr("data.maas_zone.test", "description", description),
+		resource.TestCheckResourceAttr("data.maas_zone.test", "name", name),
+	}
+
+	resource.ParallelTest(t, resource.TestCase{
+		PreCheck:     func() { testutils.PreCheck(t, nil) },
+		Providers:    testutils.TestAccProviders,
+		CheckDestroy: testAccCheckMaasZoneDestroy,
+		ErrorCheck:   func(err error) error { return err },
+		Steps: []resource.TestStep{
+			{
+				Config: testAccDataSourceMaasZone(description, name),
+				Check:  resource.ComposeTestCheckFunc(checks...),
+			},
+		},
+	})
+}
+
+func testAccDataSourceMaasZone(description string, name string) string {
+	return fmt.Sprintf(`
+%s
+
+data "maas_zone" "test" {
+	name = maas_zone.test.name
+}
+`, testAccMaasZone(name, description))
+}

maas/provider.go

@@ -65,6 +65,7 @@ func Provider() *schema.Provider {
 			"maas_tag":                        resourceMaasTag(),
 			"maas_user":                       resourceMaasUser(),
 			"maas_resource_pool":              resourceMaasResourcePool(),
+			"maas_zone":                       resourceMaasZone(),
 		},
 		DataSourcesMap: map[string]*schema.Resource{
 			"maas_boot_source":                dataSourceMaasBootSource(),
@@ -76,6 +77,7 @@ func Provider() *schema.Provider {
 			"maas_device":                     dataSourceMaasDevice(),
 			"maas_resource_pool":              dataSourceMaasResourcePool(),
 			"maas_rack_controller":            dataSourceMaasRackController(),
+			"maas_zone":                       dataSourceMaasZone(),
 		},
 		ConfigureContextFunc: providerConfigure,
 	}

maas/resource_maas_zone.go

@@ -0,0 +1,142 @@
+package maas
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/canonical/gomaasclient/client"
+	"github.com/canonical/gomaasclient/entity"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+func resourceMaasZone() *schema.Resource {
+	return &schema.Resource{
+		Description:   "Provides a resource to manage MAAS zones.",
+		CreateContext: resourceZoneCreate,
+		ReadContext:   resourceZoneRead,
+		UpdateContext: resourceZoneUpdate,
+		DeleteContext: resourceZoneDelete,
+		Importer: &schema.ResourceImporter{
+			StateContext: func(ctx context.Context, d *schema.ResourceData, meta interface{}) ([]*schema.ResourceData, error) {
+				client := meta.(*client.Client)
+				zone, err := getZone(client, d.Id())
+				if err != nil {
+					return nil, err
+				}
+				d.SetId(fmt.Sprintf("%v", zone.ID))
+				return []*schema.ResourceData{d}, nil
+			},
+		},
+
+		Schema: map[string]*schema.Schema{
+			"description": {
+				Type:        schema.TypeString,
+				Optional:    true,
+				Description: "A brief description of the new zone.",
+			},
+			"name": {
+				Type:        schema.TypeString,
+				Required:    true,
+				Description: "The name of the new zone.",
+			},
+		},
+	}
+}
+
+func resourceZoneRead(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*client.Client)
+
+	zone, err := getZone(client, d.Id())
+	if err != nil {
+		return diag.FromErr(err)
+	}
+
+	d.SetId(fmt.Sprintf("%v", zone.ID))
+
+	tfstate := map[string]any{
+		"name":        zone.Name,
+		"description": zone.Description,
+	}
+
+	if err := setTerraformState(d, tfstate); err != nil {
+		return diag.FromErr(err)
+	}
+
+	return nil
+}
+
+func resourceZoneCreate(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*client.Client)
+
+	params := getZoneParams(d)
+	zone, err := client.Zones.Create(params)
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	d.SetId(fmt.Sprintf("%v", zone.ID))
+
+	return resourceZoneRead(ctx, d, meta)
+}
+
+func resourceZoneUpdate(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*client.Client)
+
+	params := getZoneParams(d)
+	zone, err := getZone(client, d.Id())
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	zone, err = client.Zone.Update(zone.Name, params)
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	d.SetId(fmt.Sprintf("%v", zone.ID))
+
+	return resourceZoneRead(ctx, d, meta)
+}
+
+func resourceZoneDelete(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*client.Client)
+
+	zone, err := getZone(client, d.Id())
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	if err := client.Zone.Delete(zone.Name); err != nil {
+		return diag.FromErr(err)
+	}
+
+	return nil
+}
+
+func getZoneParams(d *schema.ResourceData) *entity.ZoneParams {
+	return &entity.ZoneParams{
+		Name:        d.Get("name").(string),
+		Description: d.Get("description").(string),
+	}
+}
+
+func findZone(client *client.Client, identifier string) (*entity.Zone, error) {
+	zones, err := client.Zones.Get()
+	if err != nil {
+		return nil, err
+	}
+	for _, z := range zones {
+		if fmt.Sprintf("%v", z.ID) == identifier || z.Name == identifier {
+			return &z, nil
+		}
+	}
+	return nil, nil
+}
+
+func getZone(client *client.Client, identifier string) (*entity.Zone, error) {
+	zone, err := findZone(client, identifier)
+	if err != nil {
+		return nil, err
+	}
+	if zone == nil {
+		return nil, fmt.Errorf("zone (%s) was not found", identifier)
+	}
+	return zone, nil
+}