ENG-12511: Add data source for systemInfo API

cyral/data_source_cyral_system_info.go

@@ -0,0 +1,62 @@
+package cyral
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/cyralinc/terraform-provider-cyral/client"
+	"github.com/google/uuid"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+const (
+	// Schema keys
+	ControlPlaneVersionKey  = "control_plane_version"
+	SidecarLatestVersionKey = "sidecar_latest_version"
+)
+
+type SystemInfo struct {
+	ControlPlaneVersion  string `json:"controlPlaneVersion"`
+	SidecarLatestVersion string `json:"sidecarLatestVersion"`
+}
+
+func (systemInfo *SystemInfo) WriteToSchema(d *schema.ResourceData) error {
+	d.SetId(uuid.New().String())
+	d.Set(ControlPlaneVersionKey, systemInfo.ControlPlaneVersion)
+	d.Set(SidecarLatestVersionKey, systemInfo.SidecarLatestVersion)
+
+	return nil
+}
+
+func dataSourceSystemInfo() *schema.Resource {
+	return &schema.Resource{
+		Description: "Retrieve information from Cyral system.",
+		ReadContext: ReadResource(ResourceOperationConfig{
+			Name:       "SystemInfoDataSourceRead",
+			HttpMethod: http.MethodGet,
+			CreateURL: func(d *schema.ResourceData, c *client.Client) string {
+				return fmt.Sprintf("https://%s/v1/systemInfo", c.ControlPlane)
+			},
+			NewResponseData: func(_ *schema.ResourceData) ResponseData {
+				return &SystemInfo{}
+			},
+		}),
+		Schema: map[string]*schema.Schema{
+			IDKey: {
+				Description: "Data source identifier.",
+				Type:        schema.TypeString,
+				Computed:    true,
+			},
+			ControlPlaneVersionKey: {
+				Description: "Control Plane version.",
+				Type:        schema.TypeString,
+				Computed:    true,
+			},
+			SidecarLatestVersionKey: {
+				Description: "Latest Sidecar version available to this Control Plane.",
+				Type:        schema.TypeString,
+				Computed:    true,
+			},
+		},
+	}
+}

cyral/data_source_cyral_system_info_test.go

@@ -0,0 +1,49 @@
+package cyral
+
+import (
+	"fmt"
+	"testing"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+)
+
+const (
+	systemInfoDataSourceFullNameFmt = "data.cyral_system_info.%s"
+)
+
+func TestAccSystemInfoDataSource(t *testing.T) {
+	dataSourceName := "system_info"
+	testSteps := []resource.TestStep{
+		accTestStepSystemInfoDataSource_ListAllSystemInfo(dataSourceName),
+	}
+	resource.ParallelTest(t, resource.TestCase{
+		ProviderFactories: providerFactories,
+		Steps:             testSteps,
+	})
+}
+
+func accTestStepSystemInfoDataSource_ListAllSystemInfo(dataSourceName string) resource.TestStep {
+	dataSourceFullName := fmt.Sprintf(systemInfoDataSourceFullNameFmt, dataSourceName)
+	config := fmt.Sprintf(`
+		data "cyral_system_info" "%s" {
+		}
+	`, dataSourceName)
+	check := resource.ComposeTestCheckFunc(
+		resource.TestCheckResourceAttrSet(
+			dataSourceFullName,
+			IDKey,
+		),
+		resource.TestCheckResourceAttrSet(
+			dataSourceFullName,
+			ControlPlaneVersionKey,
+		),
+		resource.TestCheckResourceAttrSet(
+			dataSourceFullName,
+			SidecarLatestVersionKey,
+		),
+	)
+	return resource.TestStep{
+		Config: config,
+		Check:  check,
+	}
+}

cyral/provider.go

@@ -85,6 +85,7 @@ func Provider() *schema.Provider {
 			"cyral_sidecar_id":           dataSourceSidecarID(),
 			"cyral_sidecar_instance_ids": dataSourceSidecarInstanceIDs(),
 			"cyral_sidecar_listener":     dataSourceSidecarListener(),
+			"cyral_system_info":          dataSourceSystemInfo(),
 		},
 
 		ResourcesMap: map[string]*schema.Resource{

docs/data-sources/system_info.md

@@ -0,0 +1,21 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "cyral_system_info Data Source - terraform-provider-cyral"
+subcategory: ""
+description: |-
+  Retrieve information from Cyral system.
+---
+
+# cyral_system_info (Data Source)
+
+Retrieve information from Cyral system.
+
+<!-- schema generated by tfplugindocs -->
+
+## Schema
+
+### Read-Only
+
+- `control_plane_version` (String) Control Plane version.
+- `id` (String) Data source identifier.
+- `sidecar_latest_version` (String) Latest Sidecar version available to this Control Plane.