Implement new data source gitlab_cluster_agent

Author: timofurrer

docs/data-sources/cluster_agent.md

@@ -0,0 +1,43 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_cluster_agent Data Source - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  The gitlab_cluster_agent data source allows to retrieve details about a GitLab Agent for Kubernetes.
+  -> Requires at least GitLab 14.10
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/cluster_agents.html
+---
+
+# gitlab_cluster_agent (Data Source)
+
+The `gitlab_cluster_agent` data source allows to retrieve details about a GitLab Agent for Kubernetes.
+
+-> Requires at least GitLab 14.10
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/cluster_agents.html)
+
+## Example Usage
+
+```terraform
+data "gitlab_cluster_agent" "example" {
+  project  = "12345"
+  agent_id = 1
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `agent_id` (Number) The ID of the agent.
+- `project` (String) ID or full path of the project maintained by the authenticated user.
+
+### Read-Only
+
+- `created_at` (String) The ISO8601 datetime when the agent was created.
+- `created_by_user_id` (Number) The ID of the user who created the agent.
+- `id` (String) The ID of this resource.
+- `name` (String) The Name of the agent.
+
+

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

@@ -0,0 +1,4 @@
+data "gitlab_cluster_agent" "example" {
+  project  = "12345"
+  agent_id = 1
+}

internal/provider/data_source_gitlab_cluster_agent.go

@@ -0,0 +1,42 @@
+package provider
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+	"github.com/xanzy/go-gitlab"
+)
+
+var _ = registerDataSource("gitlab_cluster_agent", func() *schema.Resource {
+	return &schema.Resource{
+		Description: `The ` + "`gitlab_cluster_agent`" + ` data source allows to retrieve details about a GitLab Agent for Kubernetes.
+
+-> Requires at least GitLab 14.10
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/cluster_agents.html)`,
+
+		ReadContext: dataSourceGitlabClusterAgentRead,
+		Schema:      datasourceSchemaFromResourceSchema(gitlabClusterAgentSchema(), []string{"project", "agent_id"}, nil),
+	}
+})
+
+func dataSourceGitlabClusterAgentRead(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*gitlab.Client)
+
+	project := d.Get("project").(string)
+	agentID := d.Get("agent_id").(int)
+
+	clusterAgent, _, err := client.ClusterAgents.GetAgent(project, agentID, gitlab.WithContext(ctx))
+	if err != nil {
+		return diag.FromErr(err)
+	}
+
+	d.SetId(fmt.Sprintf("%s:%d", project, agentID))
+	stateMap := gitlabClusterAgentToStateMap(project, clusterAgent)
+	if err := setStateMapInResourceData(stateMap, d); err != nil {
+		return diag.FromErr(err)
+	}
+	return nil
+}

internal/provider/data_source_gitlab_cluster_agent_test.go

@@ -0,0 +1,39 @@
+//go:build acceptance
+// +build acceptance
+
+package provider
+
+import (
+	"fmt"
+	"testing"
+	"time"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+)
+
+func TestAccDataSourceGitlabClusterAgent_basic(t *testing.T) {
+	testAccRequiresAtLeast(t, "14.10")
+
+	testProject := testAccCreateProject(t)
+	testAgent := testAccCreateClusterAgents(t, testProject.ID, 1)[0]
+
+	resource.Test(t, resource.TestCase{
+		ProviderFactories: providerFactories,
+		Steps: []resource.TestStep{
+			{
+				Config: fmt.Sprintf(`
+					data "gitlab_cluster_agent" "this" {
+						project           = "%d"
+						agent_id          = %d
+					}
+					`, testProject.ID, testAgent.ID,
+				),
+				Check: resource.ComposeTestCheckFunc(
+					resource.TestCheckResourceAttr("data.gitlab_cluster_agent.this", "name", testAgent.Name),
+					resource.TestCheckResourceAttr("data.gitlab_cluster_agent.this", "created_at", testAgent.CreatedAt.Format(time.RFC3339)),
+					resource.TestCheckResourceAttr("data.gitlab_cluster_agent.this", "created_by_user_id", fmt.Sprintf("%d", testAgent.CreatedByUserID)),
+				),
+			},
+		},
+	})
+}