diff --git a/content/docs/iac/troubleshooting/debugging/_index.md b/content/docs/iac/troubleshooting/debugging/_index.md index a05e53e3e738..b68d850b6b9e 100644 --- a/content/docs/iac/troubleshooting/debugging/_index.md +++ b/content/docs/iac/troubleshooting/debugging/_index.md @@ -17,3 +17,4 @@ Tools and techniques for diagnosing and fixing Pulumi programs, including debugg - **[Logging](/docs/iac/troubleshooting/debugging/logging/)** - CLI verbose logging and program logging for debugging and diagnostics - **[Attaching a debugger](/docs/iac/troubleshooting/debugging/debugger-attachment/)** - Set up debugger attachment for step-by-step program debugging - **[Performance and tracing](/docs/iac/troubleshooting/debugging/performance-tracing/)** - Analyze deployment performance and trace operations +- **[Debugging providers](/docs/iac/troubleshooting/debugging/debugging-providers/)** - Debug Pulumi providers locally during development diff --git a/content/docs/iac/build-with-pulumi/debugging-providers.md b/content/docs/iac/troubleshooting/debugging/debugging-providers.md similarity index 90% rename from content/docs/iac/build-with-pulumi/debugging-providers.md rename to content/docs/iac/troubleshooting/debugging/debugging-providers.md index 1018e910eb46..edf1c0be93d6 100644 --- a/content/docs/iac/build-with-pulumi/debugging-providers.md +++ b/content/docs/iac/troubleshooting/debugging/debugging-providers.md @@ -7,8 +7,8 @@ meta_image: /images/docs/meta-images/docs-meta.png menu: iac: name: Debugging providers - parent: iac-build-with-pulumi - weight: 40 + parent: iac-troubleshooting-debugging + weight: 30 aliases: - /docs/using-pulumi/pulumi-packages/ - /docs/using-pulumi/pulumi-packages/debugging-provider-packages/ @@ -17,6 +17,7 @@ aliases: - /docs/iac/using-pulumi/pulumi-packages/debugging-provider-packages/ - /docs/iac/using-pulumi/extending-pulumi/debugging-providers/ - /docs/iac/extending-pulumi/debugging-providers/ + - /docs/iac/build-with-pulumi/debugging-providers/ --- When developing or troubleshooting Pulumi providers, you may need to debug the provider code locally. This guide walks you through starting your provider in debug mode, setting breakpoints, and running tests. @@ -31,7 +32,7 @@ For GoLand you can follow these steps. 1. Configure the working directory to the program you are going to run to mirror how Pulumi would start the provider - ![Screenshot of GoLand configuration for debugging providers](/docs/iac/build-with-pulumi/img/goland-debug-config.png) + ![Screenshot of GoLand configuration for debugging providers](/docs/iac/troubleshooting/debugging/images/goland-debug-config.png) ### Example for VS Code @@ -40,12 +41,12 @@ For VS Code you can follow these steps. 1. Navigate to **Run -> Add Configuration** and add the **Go: launch package** configuration 1. Edit `"program": "${fileDirname}"` to point to `cmd/pulumi-resource-` , e.g., `cmd/pulumi-resource-azure-native` for the Azure Native provider - ![Screenshot of VS Code configuration for debugging providers](/docs/iac/build-with-pulumi/img/vscode-launch-config.png) + ![Screenshot of VS Code configuration for debugging providers](/docs/iac/troubleshooting/debugging/images/vscode-launch-config.png) 1. Edit "name": `"Launch Package"` to give it a descriptive name 1. Launch package - ![Screenshot of VS Code configuration for debugging providers](/docs/iac/build-with-pulumi/img/vscode-debug-config.png) + ![Screenshot of VS Code configuration for debugging providers](/docs/iac/troubleshooting/debugging/images/vscode-debug-config.png) ## Setting breakpoints @@ -133,9 +134,9 @@ For VS Code you can follow these steps to connect to the debugger. 1. Navigate to **Run -> Add Configuration** and add the **Go: Connect to server** configuration - ![Screenshot of VS Code configuration for debugging providers](/docs/iac/build-with-pulumi/img/vscode-launch-config-connect-to-server.png) + ![Screenshot of VS Code configuration for debugging providers](/docs/iac/troubleshooting/debugging/images/vscode-launch-config-connect-to-server.png) 1. Edit "name": `"Connect to server"` to give it a descriptive name 1. Connect to server - ![Screenshot of VS Code configuration for debugging tfgen](/docs/iac/build-with-pulumi/img/vscode-debug-config-connect-to-server.png) + ![Screenshot of VS Code configuration for debugging tfgen](/docs/iac/troubleshooting/debugging/images/vscode-debug-config-connect-to-server.png) diff --git a/content/docs/iac/build-with-pulumi/img/goland-debug-config.png b/content/docs/iac/troubleshooting/debugging/images/goland-debug-config.png similarity index 100% rename from content/docs/iac/build-with-pulumi/img/goland-debug-config.png rename to content/docs/iac/troubleshooting/debugging/images/goland-debug-config.png diff --git a/content/docs/iac/build-with-pulumi/img/vscode-debug-config-connect-to-server.png b/content/docs/iac/troubleshooting/debugging/images/vscode-debug-config-connect-to-server.png similarity index 100% rename from content/docs/iac/build-with-pulumi/img/vscode-debug-config-connect-to-server.png rename to content/docs/iac/troubleshooting/debugging/images/vscode-debug-config-connect-to-server.png diff --git a/content/docs/iac/build-with-pulumi/img/vscode-debug-config.png b/content/docs/iac/troubleshooting/debugging/images/vscode-debug-config.png similarity index 100% rename from content/docs/iac/build-with-pulumi/img/vscode-debug-config.png rename to content/docs/iac/troubleshooting/debugging/images/vscode-debug-config.png diff --git a/content/docs/iac/build-with-pulumi/img/vscode-launch-config-connect-to-server.png b/content/docs/iac/troubleshooting/debugging/images/vscode-launch-config-connect-to-server.png similarity index 100% rename from content/docs/iac/build-with-pulumi/img/vscode-launch-config-connect-to-server.png rename to content/docs/iac/troubleshooting/debugging/images/vscode-launch-config-connect-to-server.png diff --git a/content/docs/iac/build-with-pulumi/img/vscode-launch-config.png b/content/docs/iac/troubleshooting/debugging/images/vscode-launch-config.png similarity index 100% rename from content/docs/iac/build-with-pulumi/img/vscode-launch-config.png rename to content/docs/iac/troubleshooting/debugging/images/vscode-launch-config.png