feat(coder-attach): add coder_external_agent resource

docs/resources/external_agent.md

@@ -0,0 +1,24 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "coder_external_agent Resource - terraform-provider-coder"
+subcategory: ""
+description: |-
+  Define an external agent to be used in a workspace.
+---
+
+# coder_external_agent (Resource)
+
+Define an external agent to be used in a workspace.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `token` (String, Sensitive) Set the environment variable `CODER_AGENT_TOKEN` with this token to authenticate an agent.
+
+### Read-Only
+
+- `id` (String) The ID of this resource.

provider/external_agent.go

@@ -0,0 +1,32 @@
+package provider
+
+import (
+	"context"
+
+	"github.com/google/uuid"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+func externalAgentResource() *schema.Resource {
+	return &schema.Resource{
+		SchemaVersion: 1,
+
+		Description: "Define an external agent to be used in a workspace.",
+		CreateContext: func(ctx context.Context, rd *schema.ResourceData, _ interface{}) diag.Diagnostics {
+			rd.SetId(uuid.NewString())
+			return nil
+		},
+		ReadContext:   schema.NoopContext,
+		DeleteContext: schema.NoopContext,
+		Schema: map[string]*schema.Schema{
+			"token": {
+				ForceNew:    true,
+				Required:    true,
+				Sensitive:   true,
+				Description: "Set the environment variable `CODER_AGENT_TOKEN` with this token to authenticate an agent.",
+				Type:        schema.TypeString,
+			},
+		},
+	}
+}

provider/external_agent_test.go

@@ -0,0 +1,41 @@
+package provider_test
+
+import (
+	"testing"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/terraform"
+	"github.com/stretchr/testify/require"
+)
+
+func TestExternalAgent(t *testing.T) {
+	t.Parallel()
+
+	t.Run("OK", func(t *testing.T) {
+		t.Parallel()
+
+		resource.Test(t, resource.TestCase{
+			ProviderFactories: coderFactory(),
+			IsUnitTest:        true,
+			Steps: []resource.TestStep{{
+				Config: `
+				provider "coder" {
+				}
+
+				resource "coder_external_agent" "main" {
+					token       = "token"
+				}
+				`,
+				Check: func(state *terraform.State) error {
+					require.Len(t, state.Modules, 1)
+					resource := state.Modules[0].Resources["coder_external_agent.main"]
+					require.NotNil(t, resource)
+					value := resource.Primary.Attributes["token"]
+					require.NotNil(t, value)
+					require.Greater(t, len(value), 0)
+					return nil
+				},
+			}},
+		})
+	})
+}

provider/provider.go

@@ -74,6 +74,7 @@ func New() *schema.Provider {
 			"coder_script":         scriptResource(),
 			"coder_env":            envResource(),
 			"coder_devcontainer":   devcontainerResource(),
+			"coder_external_agent": externalAgentResource(),
 		},
 	}
 }