mirror of https://github.com/citusdata/citus.git
Add Debugging Instructions to Devcontainer Setup in CONTRIBUTING.md (#7673)
**Description:** This PR adds a section to CONTRIBUTING.md that explains how to set up debugging in the devcontainer using VS Code. **Changes:** - **New Debugging Section**: Clear instructions on starting the debugger, selecting the appropriate PostgreSQL process, and setting breakpoints for easier troubleshooting. **Purpose:** - **Improved Contributor Workflow**: Enables contributors to debug the Citus extension within the devcontainer, enhancing productivity and making it easier to resolve issues. --------- Co-authored-by: Mehmet YILMAZ <mehmet.yilmaz@microsoft.com>pull/7639/head
parent
08c49b5e36
commit
67abba01f5
|
@ -3,5 +3,5 @@
|
||||||
\pset border 2
|
\pset border 2
|
||||||
\setenv PAGER 'pspg --no-mouse -bX --no-commandbar --no-topbar'
|
\setenv PAGER 'pspg --no-mouse -bX --no-commandbar --no-topbar'
|
||||||
\set HISTSIZE 100000
|
\set HISTSIZE 100000
|
||||||
\set PROMPT1 '\n%[%033[1m%]%M %n@%/:%>-%p%R%[%033[0m%]%# '
|
\set PROMPT1 '\n%[%033[1m%]%M %n@%/:%> (PID: %p)%R%[%033[0m%]%# '
|
||||||
\set PROMPT2 ' '
|
\set PROMPT2 ' '
|
||||||
|
|
|
@ -35,6 +35,28 @@ To get citus installed from source we run `make install -s` in the first termina
|
||||||
|
|
||||||
With the Citus cluster running you can connect to the coordinator in the first terminal via `psql -p9700`. Because the coordinator is the most common entrypoint the `PGPORT` environment is set accordingly, so a simple `psql` will connect directly to the coordinator.
|
With the Citus cluster running you can connect to the coordinator in the first terminal via `psql -p9700`. Because the coordinator is the most common entrypoint the `PGPORT` environment is set accordingly, so a simple `psql` will connect directly to the coordinator.
|
||||||
|
|
||||||
|
### Debugging in the VS code
|
||||||
|
|
||||||
|
1. Start Debugging: Press F5 in VS Code to start debugging. When prompted, you'll need to attach the debugger to the appropriate PostgreSQL process.
|
||||||
|
|
||||||
|
2. Identify the Process: If you're running a psql command, take note of the PID that appears in your psql prompt. For example:
|
||||||
|
```
|
||||||
|
[local] citus@citus:9700 (PID: 5436)=#
|
||||||
|
```
|
||||||
|
This PID (5436 in this case) indicates the process that you should attach the debugger to.
|
||||||
|
If you are uncertain about which process to attach, you can list all running PostgreSQL processes using the following command:
|
||||||
|
```
|
||||||
|
ps aux | grep postgres
|
||||||
|
```
|
||||||
|
|
||||||
|
Look for the process associated with the PID you noted. For example:
|
||||||
|
```
|
||||||
|
citus 5436 0.0 0.0 0 0 ? S 14:00 0:00 postgres: citus citus
|
||||||
|
```
|
||||||
|
4. Attach the Debugger: Once you've identified the correct PID, select that process when prompted in VS Code to attach the debugger. You should now be able to debug the PostgreSQL session tied to the psql command.
|
||||||
|
|
||||||
|
5. Set Breakpoints and Debug: With the debugger attached, you can set breakpoints within the code. This allows you to step through the code execution, inspect variables, and fully debug the PostgreSQL instance running in your container.
|
||||||
|
|
||||||
### Getting and building
|
### Getting and building
|
||||||
|
|
||||||
[PostgreSQL documentation](https://www.postgresql.org/support/versioning/) has a
|
[PostgreSQL documentation](https://www.postgresql.org/support/versioning/) has a
|
||||||
|
|
Loading…
Reference in New Issue