feat: Fleet Resources (BPOP-5000) (#212)

* add terraform support for managing fleets

* add docs for bindplane_fleet resources

* fix lint

* fix bundle for CI

* try and account for integraiton test deprecated component

* one more revert of parse_timestamp change

* simplify configuration of the fleet resource

* ForceNew on agent_type and Platform

* fix fleets configuration reference

Author: schmikei

client/client.go

@@ -250,6 +250,36 @@ func (i *BindPlane) DeleteExtension(name string) error {
 	return nil
 }
 
+// Fleet takes a name and returns the matching fleet
+func (i *BindPlane) Fleet(name string) (*model.Fleet, error) {
+	r, err := i.Client.Resource(context.Background(), model.KindFleet, name)
+	if err != nil {
+		// Do not return an error if the resource is not found. Terraform
+		// will understand that the resource does not exist when it receives
+		// a nil value, and will instead offer to create the resource.
+		if isNotFoundError(err) {
+			return nil, nil
+		}
+		return nil, fmt.Errorf("failed to get fleet with name %s: %w", name, err)
+	}
+
+	switch f := r.(type) {
+	case *model.Fleet:
+		return f, nil
+	default:
+		return nil, fmt.Errorf("unexpected response from bindplane, expected fleet, got %T, this is a bug that should be reported", f)
+	}
+}
+
+// DeleteFleet will delete a BindPlane fleet
+func (i *BindPlane) DeleteFleet(name string) error {
+	err := i.Client.DeleteResource(context.Background(), model.KindFleet, name)
+	if err != nil {
+		return fmt.Errorf("error while deleting fleet with name %s: %w", name, err)
+	}
+	return nil
+}
+
 // Delete will delete a Bindplane resource
 func (i *BindPlane) Delete(k model.Kind, name string) error {
 	switch k {
@@ -265,6 +295,8 @@ func (i *BindPlane) Delete(k model.Kind, name string) error {
 		return i.DeleteExtension(name)
 	case model.KindConnector:
 		return i.DeleteConnector(name)
+	case model.KindFleet:
+		return i.DeleteFleet(name)
 	default:
 		return fmt.Errorf("Delete does not support bindplane kind '%s'", k)
 	}

docs/resources/bindplane_fleet.md

@@ -0,0 +1,122 @@
+---
+subcategory: "Fleet Management"
+description: |-
+  A Fleet manages a collection of agents that are deployed and configured by Bindplane.
+---
+
+# bindplane_fleet
+
+The `bindplane_fleet` resource creates a Bindplane fleet that manages a collection of agents.
+A fleet defines which [configuration](./bindplane_configuration.md) is assigned to a group of agents,
+and uses a selector to match agents to the fleet based on labels.
+
+## Options
+
+| Option          | Type   | Default  | Description                                                                                |
+| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------ |
+| `name`          | string | required | The resource name for the fleet. Used internally and cannot be changed after creation.     |
+| `display_name`  | string | optional | A user-friendly name for the fleet. Can be changed anytime.                               |
+| `agent_type`    | string | optional | The collector agent type for agents in this fleet.                                        |
+| `platform`      | string | optional | The platform (OS/architecture) for agents in this fleet.                                  |
+| `configuration` | string | optional | Name of the configuration assigned to the fleet.                                          |
+
+## Examples
+
+### Basic Fleet with Agent Type and Platform
+
+This example creates a fleet with collector type and platform. The selector is automatically generated to match agents with the fleet name label.
+
+```hcl
+resource "bindplane_configuration" "example" {
+  name     = "my-config"
+  platform = "linux"
+  # ... configuration sources, destinations, etc.
+}
+
+resource "bindplane_fleet" "production" {
+  name          = "us-east"
+  display_name  = "US East"
+  agent_type    = "observiq-otel-collector"
+  platform      = "linux"
+  configuration = bindplane_configuration.example.name
+}
+```
+
+### Fleet with Configuration
+
+This example creates a fleet and assigns a configuration to it.
+
+```hcl
+resource "bindplane_fleet" "staging" {
+  name          = "staging-fleet"
+  display_name  = "Staging Fleet"
+  agent_type    = "observiq-otel-collector"
+  platform      = "linux"
+  configuration = "my-existing-config"
+}
+```
+
+### Minimal Fleet
+
+This example creates a fleet with minimal required fields.
+
+```hcl
+resource "bindplane_fleet" "development" {
+  name         = "development-fleet"
+  display_name = "Development"
+}
+```
+
+## Configuration Dependency
+
+When you reference a configuration from another resource using its name attribute (e.g., `bindplane_configuration.example.name`),
+Terraform automatically establishes a dependency. The configuration will be created before the fleet, ensuring the referenced
+configuration exists when the fleet is created.
+
+If you hardcode a configuration name as a string literal, the provider validates that the configuration exists at creation time
+and returns an error if it doesn't:
+
+```hcl
+# This will fail if "missing-config" doesn't exist
+resource "bindplane_fleet" "example" {
+  name          = "my-fleet"
+  configuration = "missing-config"  # ← Error: configuration 'missing-config' does not exist
+}
+```
+
+## Using Fleets
+
+After applying the configuration with `terraform apply`, you can view the fleet with the `bindplane get fleet` commands:
+
+```bash
+bindplane get fleet
+```
+
+```yaml
+# bindplane get fleet us-east -o yaml
+apiVersion: bindplane.observiq.com/v1
+kind: Fleet
+metadata:
+    id: us-east
+    name: us-east
+    displayName: US East
+    labels:
+        agent-type: observiq-otel-collector
+        platform: linux
+    version: 1
+    dateModified: 2024-05-05T10:30:00Z
+spec:
+    configuration: my-config
+    selector:
+        matchLabels:
+            fleet: us-east
+```
+
+## Import
+
+When using the [terraform import command](https://developer.hashicorp.com/terraform/cli/commands/import),
+fleets can be imported by name. For example:
+
+```bash
+terraform import bindplane_fleet.production production-fleet
+```

provider/provider.go

@@ -127,10 +127,11 @@ func Configure() *schema.Provider {
 			"bindplane_configuration":    resourceConfiguration(),
 			"bindplane_configuration_v2": resourceConfigurationV2(),
 			"bindplane_destination":      resourceDestination(),
-			"bindplane_source":           resourceSource(),
+			"bindplane_extension":        resourceExtension(),
+			"bindplane_fleet":            resourceFleet(),
 			"bindplane_processor":        resourceProcessor(),
 			"bindplane_processor_bundle": resourceProcessorBundle(),
-			"bindplane_extension":        resourceExtension(),
+			"bindplane_source":           resourceSource(),
 		},
 	}
 }