Support/Document Debugger Processes

[Brian Flad]

terraform-plugin-go version

v0.5.0

Use cases

Downstream abstractions, such as terraform-plugin-sdk/v2 and terraform-plugin-framework, make it relatively straightforward to run servers that invert the process lifecycle so they can be instrumented by debugger and testing processes. Providers written directly on terraform-plugin-go or reliant on terraform-plugin-mux essentially must reimplement those projects' logic to do the same. Given that the reattach handling is strongly correlated to low level details about go-plugin and Terraform CLI, it feels like a potential candidate for creating an implementation in this project.

Proposal

Adding DebugServe and/or Debug functionality in tf5server/tf6server, similar to downstream implementations. Document in README (until #129 is sorted).

References

• https://www.terraform.io/plugin/sdkv2/debugging
• hashicorp/terraform-plugin-framework#243
• hashicorp/terraform-plugin-mux#34
• https://github.com/hashicorp/terraform-provider-kubernetes/blob/5808075fda984cdd8e26aacb4cef3490ac542f1e/manifest/provider/plugin.go