feat: Add harvester_pci_device resource for PCI device passthrough

[jniedergang]

Summary

Add a new Terraform resource harvester_pci_device for managing PCI device passthrough to VMs using Harvester's PCIDeviceClaim CRD. This enables GPU and other PCI device passthrough directly from Terraform.

Resolves harvester/harvester#10018
Related to harvester/harvester#6423

Features

• Create PCIDeviceClaim resources to attach PCI devices to VMs
• Validate VM existence before creating claims
• Support for multiple PCI addresses per resource
• Automatic claim name generation based on node/address format
• Support for labels on claims

Required Fields

• vm_name: Target VM in namespace/name format
• node_name: Required node for scheduling (mandatory for PCI passthrough)
• pci_addresses: List of PCI addresses to attach (format: 0000:XX:YY.Z)

Example Usage

resource "harvester_pci_device" "example" {
  name      = "example-pci-device-claim"
  namespace = "default"

  vm_name   = "default/my-vm"
  node_name = "node-01"

  pci_addresses = [
    "0000:01:00.0",  # GPU
  ]

  labels = {
    environment = "production"
  }
}

Test plan

• Unit tests: go test ./pkg/importer/ -run TestPCIDevice — pass
• go build ./... — compilation passes
• gofmt -l . — no formatting issues
• go generate ./... — docs generated
• Functional test — requires PCI device (GPU) passthrough hardware

[Copilot]

Pull request overview

This PR adds a new Terraform resource harvester_pci_device for managing PCI device passthrough to VirtualMachines in Harvester using the PCIDeviceClaim CRD. The implementation enables users to attach PCI devices (such as GPUs) directly to VMs through Terraform configuration.

Changes:

• New harvester_pci_device resource for PCI device passthrough management
• Helper function PCIDeviceIDParts for parsing PCI device resource IDs
• Constants and schema definitions for PCI device resource fields
• Documentation and examples for resource usage

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
pkg/helper/id.go	Adds PCIDeviceIDParts helper for parsing 3-part IDs (namespace/vmname/claimname)
pkg/constants/constants_pcidevice.go	Defines constants for PCI device resource fields and resource type name
internal/provider/provider.go	Registers the new harvester_pci_device resource with the provider
internal/provider/pcidevice/schema_pcidevice.go	Defines Terraform schema for PCI device resource with validation
internal/provider/pcidevice/resource_pcidevice.go	Implements CRUD operations for PCIDeviceClaim resources using dynamic client
examples/resources/harvester_pci_device/resource.tf	Provides usage examples for attaching PCI devices to VMs
docs/resources/pci_device.md	Generated documentation for the harvester_pci_device resource

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[mergify]

This pull request is now in conflict. Could you fix it @jniedergang? 🙏

[jniedergang]

Functional test completed on Harvester v1.7.1 using the Intel WiFi card (0000:00:14.3, Comet Lake PCH-LP CNVi WiFi) on node harv1.home.lo.

Results:

• terraform apply: PCIDeviceClaim created successfully, VM existence validated
• terraform plan (idempotence): 0 changes — after fixing vm_name drift (DiffSuppressFunc for bare name vs namespace/name equivalence)
• terraform destroy: claim deletion issued, Harvester controller finalizer held (expected for a device not configured for passthrough — the controller can't unbind the in-use iwlwifi driver)

Fix in f33879f: Added DiffSuppressFunc on vm_name field to suppress false drift when user specifies "rhel8-test" but Read returns "default/rhel8-test". Also cleared AtLeastOneOf in DataSourceSchemaWrap to prevent validation errors on computed datasource fields.